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:

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

Ś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