Pobieranie z repozytoriów
Infrastruktura oferowana przez środowisko PDE Build udostępnia czynności
umożliwiające pobranie kodu źródłowego z repozytorium w ramach procesu
budowania.
Dostępne są dwie opcje: umożliwienie środowisku PDE Build
automatycznego pobrania źródła lub ręczne pobranie kodu źródłowego.
Zautomatyzowane pobieranie kodu źródłowego z repozytorium CVS
Dzięki identyfikatorowi składnika, który należy zbudować, infrastruktura budowania jest w stanie pobrać z repozytorium CVS wszystkie 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 pozycji w pliku odwzorowania do
pobierania z repozytorium CVS jest następujący:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
gdzie elementType ma jedną z następujących wartości: bundle, feature,
plug-in lub fragment. Jeśli nie określono ścieżki,
to zamiast niej jako moduł CVS zostanie użyta nazwa elementu, na
przykład:
plugin@org.foo.bar=CVS,v20060501,:pserver:anonymous@cvs.eclipse.org:/cvsroot/foo
pobierze wtyczkę org.foo.bar oznaczoną znacznikiem
v20060501 z cvs.eclipse.org/cvsroot/cos/org.foo.bar.
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 foldera 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
Środowisko PDE Build zawiera punkt rozszerzenia, w którym można
dołączyć generatory skryptów pobierania z różnych repozytoriów jako
wtyczki. Kiedy 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:
<TypElementu>@<IDelementu> = <REPOZYTORIUM>,
<ZNACZNIK>, [...]
Format wpisu odwzorowania po pozycji ZNACZNIK będzie zależał od rozszerzenia.
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.