Pobieranie z repozytoriów

Infrastruktura oferowana przez środowisko PDE Build udostępnia czynności umożliwiające pobranie kodu źródłowego i fabrycznie zbudowanych wtyczek z repozytorium w ramach procesu budowania (patrz zadanie eclipse.fetch oraz właściwości służące do sterowania pobieraniem). Dostępne są dwie opcje: umożliwienie środowisku PDE Build automatycznego pobrania źródła lub ręczne pobranie kodu źródłowego.

Pierwszy krok do automatyzacji, plik odwzorowania

Dzięki identyfikatorowi składnika lub wtyczki, którą należy zbudować, infrastruktura budowania jest w stanie pobrać z repozytorium wszystkie dołączone składniki i wtyczki.

Aby uzyskać informacje dotyczące umiejscowienia poszczególne elementów, środowisko PDE korzysta z plików odwzorowania. Plik odwzorowania jest plikiem właściwości Java, który odwzorowuje identyfikatory składników i wtyczek na położenia i znaczniki w repozytorium. Format plików odwzorowania jest otwarty, ale część klucza jest ustalona przez środowisko PDE Build.

<elementType>@<elementID>[,<elementVersion>] = <treść specyficzna dla repozytorium>

gdzie elementType ma jedną z następujących wartości: bundle, feature, plugin lub fragment, a elementId i elementVersion określają cechy elementu.

Wpis pliku odwzorowania dla systemu CVS

Format wpisu w pliku odwzorowania do pobierania treści z systemu CVS jest następujący:
<klucz> = CVS, [,args]
gdzie args jest listą oddzieloną przecinkami par klucz/wartość, która jest opisana poniżej: Przykład:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true

Wpisy odwzorowania w starym stylu
W środowisku Eclipse 3.2 i wcześniejszych format pliku odwzorowania dla repozytorium CVS był następujący:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Jeśli nie określono żadnego z argumentów opcjonalnych, nadal jest konieczne oddzielenie następujących po sobie argumentów za pomocą przecinków. Ten format powinien zostać uznany za nieaktualny, natomiast formatem preferowanym powinien być format klucz/wartość.

Wpis pliku odwzorowania dla zadania Ant GET

Format wpisu w pliku odwzorowania do pobierania treści z dowolnego adresu URL obsługiwanego przez zadanie Ant GET jest następujący:

<klucz> = GET, <url> [,args]
gdzie url jest adresem URL, skąd mają zostać pobrane dane, a args jest listą oddzieloną przecinkami par klucz/wartość, która jest opisana poniżej: Przykład:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true

Wpis pliku odwzorowania dla pobierania z platformy p2

W komponencie PDE/Build dodano nowe rozszerzenie, które umożliwia użytkownikom pobieranie artefaktów z repozytoriów p2. W bieżącej wersji istnieje możliwość dodania wpisu do pliku odwzorowania dla wejścia budowania, a komponent PDE/Build pobierze artefakt i włączy go do budowania. Wpis pliku odwzorowania musi uwzględniać identyfikator i wersję jednostki instalowalnej oraz identyfikator URI repozytorium, w którym można znaleźć jednostkę instalowalną. Przyjmuje się, że metadane i repozytoria artefaktów znajdują się w tym samym położeniu.

Format wpisu w pliku odwzorowania na potrzeby pobierania treści przy użyciu platformy p2 jest następujący:

<elementType>@<elementID> = p2IU, id=<id>, version=<wersja>, repository=<repozytorium>
Pobieranie składników przy użyciu platformy p2

W wersji Helios składniki można pobierać przy użyciu platformy p2, określając jednostkę instalowalną reprezentującą plik JAR składnika. Informacje szczegółowe dotyczące struktury metadanych p2 dla składników znajdują się na stronie Metadane składnika.

Przykłady:
plugin@id.mojego.pakunku,1.0.0=p2IU,id=id.mojego.pakunku,version=1.0.0,repository=http://przykładowe_repozytorium.eclipse.org/repo
feature@id.mojego.składnika = p2IU,id=id.mojego.składnika.feature.jar,version=1.0.0,repository=http://przykładowe_repozytorium.eclipse.org/repo

Wpis pliku odwzorowania dla innych repozytoriów

Środowisko PDE Build udostępnia punkt rozszerzenia umożliwiający włączenie generatorów skryptów pobierania dla różnych repozytoriów. Jeśli instalator produktu Eclipse zawiera pakunek udostępniający rozszerzenie generatora skryptów dla innego typu repozytorium, można użyć tego repozytorium, określając je we wpisach w pliku odwzorowania i przestrzegając formatu określonego przez dostawcę rozszerzenia.

Konfigurowanie funkcji pobierania źródła z repozytorium CVS

Aby skonfigurować funkcję pobierania źródła z repozytorium CVS, wykonaj następujące czynności:

Pobieranie plików odwzorowania z repozytorium CVS

Pliki odwzorowania są zazwyczaj zapisane w repozytorium. Środowisko PDE Build zapewnia domyślną infrastrukturę umożliwiającą pobieranie tych plików z repozytorium CVS. Aby włączyć tę funkcję, zmień następujące właściwości w pliku konfiguracyjnym build.properties w katalogu konfiguracyjnym: Pobieranie plików odwzorowania z repozytorium CVS odbywa się w fazie przed budowaniem. Skrypty służące do pobrania wszystkich składników i wtyczek zawartych w budowanym składniku zostaną wygenerowane i uruchomione w fazie pobierania. 

Automatyczne pobieranie z innych repozytoriów

Podczas automatycznego pobierania plików odwzorowania z repozytorium należy skopiować plik customTarget.xml z katalogu org.eclipse.pde.build/templates/headless-build do katalogu konfiguracyjnego. Cel getMapFiles służący do pobrania plików odwzorowania należy zmodyfikować, aby pobierał dane z określonego repozytorium.

Pobieranie kodu źródłowego ręcznie

Można wprowadzić niestandardowe cele pobierania, aby pobrać wtyczki i składniki, które będą uruchamiane z celów preSetup lub postSetup w pliku customTargets.xml. Składniki i wtyczki powinny zostać pobrane odpowiednio do katalogów ${KatalogBudowania}/features i ${KatalogBudowania}/plugins.