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:
gdzie args jest listą oddzieloną przecinkami par klucz/wartość, która jest opisana poniżej:
- tag, znacznik CVS do pobrania.
- cvsRoot, łańcuch połączenia systemu CVS.
- path, opcjonalny moduł CVS i ścieżka, gdzie znajduje się folder zawierający element. Nazwa elementu jest domyślnie używana jako nazwa modułu.
- prebuilt, opcjonalna wartość boolowska wskazująca, czy pobrany element jest fabrycznie zbudowany. Wartością domyślną jest false.
- cvsPassFile, opcjonalna ścieżka do pliku hasła systemu CVS.
- password, opcjonalne hasło umożliwiające połączenie się z systemem CVS.
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:
- unpack, wartość true oznacza, że pobierany element należy rozpakować.
- verbose, wartość true oznacza, aby wyświetlać zwięzłe informacje o postępie podczas pobierania. Wartością domyślną jest false.
- ignoreerrors, wartość true oznacza, aby rejestrować błędy podczas przesyłania. Wartością domyślną jest false.
- usetimestamp, wartość true oznacza, aby warunkowo pobrać plik w zależności od znacznika czasu kopii lokalnej (dotyczy tylko adresów URL protokołu HTTP). Wartością domyślną jest false.
- username, nazwa użytkownika dla podstawowego uwierzytelniania protokołu HTTP.
- password, hasło umożliwiające wykonanie pobierania.
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
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>
- id - identyfikator jednostki instalowalnej
- wersja - wersja jednostki instalowalnej (opcjonalna). Jeśli nie jest określona,
zostanie pobrana najwyższa dostępna wersja.
- repozytorium - położenie (identyfikator URI) repozytorium,
w którym można znaleźć jednostkę instalowalną
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:
- Sprawdź, czy plik cvs.exe znajduje się w systemowej ścieżce
wyszukiwania. (Pobierz CVS stąd).
- Utwórz folder o nazwie maps w katalogu budowania.
- W folderze maps utwórz plik z rozszerzeniem .map.
- Wypełnij go danymi o wszystkich elementach, które mają być pobrane z repozytorium.
- Dokonaj edycji pliku build.properties z folderu konfiguracyjnego i przekształć w komentarz wiersz skipFetch=true. Jeśli ta
właściwość jest ustawiona, środowisko PDE Build pominie całą fazę
pobierania. Jeśli znacznik określony w plikach odwzorowania ma być
ignorowany, można ustawić określoną wartość właściwości fetchTag. Przydaje się to podczas nocnego budowania z elementu HEAD zamiast z wersji oznaczonych.
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:
- skipMaps:
przekształć tę właściwość w komentarz. Jeśli ta właściwość jest
ustawiona, środowisko PDE Build nie pobierze plików odwzorowania.
- mapsRepo = :pserver:anonymous@przyklad.com/sciezka/do/repo. Repozytorium CVS, z którego zostaną pobrane pliki odwzorowania.
- mapsRoot = /sciezka/do/map. Ścieżka w repozytorium CVS do katalogu zawierającego pliki odwzorowania.
- mapsCheckoutTag = HEAD. Znacznik CVS do sprawdzania plików odwzorowania.
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.