Integracja komponentu PDE Build z platformą p2

Ta strona opisuje już nieaktualny stary sposób integracji z platformą p2. Zalecane metody budowania przy użyciu platformy p2 zawiera strona Budowanie repozytoriów i produktów p2. Właściwości opisane poniżej działają w przypadku użycia warstwy kompatybilności wstecznej i nie obsługują żadnych nowych funkcji dodanych do produktu p2 publisher.

Informacje dotyczące generowania metadanych platformy p2 można znaleźć na stronie Generowanie metadanych platformy p2 w podręczniku programisty wtyczek platformy. Samo generowanie metadanych nie jest wystarczające do utworzenia produktu obsługującego platformę p2. Aby utworzyć taki produkt, należy przeprowadzić instalację platformy p2 na podstawie wygenerowanych metadanych. Szczegółowe informacje dotyczące przeprowadzania tej instalacji na podstawie skryptu nienadzorowanego można znaleźć w dokumentacji Obiekt kierujący platformy p2.

Istnieje możliwość wygenerowania metadanych platformy p2 za pomocą ręcznych wywołań generatora metadanych platformy p2 w dowolnych zadaniach niestandardowych komponentu PDE/Build (więcej informacji można znaleźć w sekcji Dostosowywanie budowania nienadzorowanego). Komponent PDE/Build udostępnia jednak integrację z platformą p2 za pomocą następujących właściwości:

generate.p2.metadata
(NIEAKTUALNA - należy użyć właściwości p2.gathering) Aby włączyć generowanie metadanych platformy p2, należy ustawić tę właściwość na wartość true. Skrypty Ant opierają się na istnieniu tej właściwości, a nie na jej wartości. Aby wyłączyć generowanie metadanych, właściwość musi zostać usunięta. Nie wystarczy nadanie jej wartości false.
Wywołania elementów docelowych platformy p2 w skryptach budowania są generowane wtedy, gdy pakunek platformy p2 org.eclipse.equinox.p2.metadata.generator i jego zależności istnieją w środowisku Eclipse, w którym uruchomiono budowanie. Warunkiem istnienia elementów docelowych platformy p2 jest właściwość generate.p2.metadata.
p2.metadata.repo
p2.artifact.repo
Służy do określania identyfikatora URI file: udostępniającego położenie metadanych platformy p2 i repozytoriów artefaktów na potrzeby publikowania. Powszechnym (ale niewymaganym) rozwiązaniem w przypadku repozytorium artefaktów jest użycie tego samego położenia, co w przypadku repozytorium metadanych.
Przykład:
			p2.metadata.repo=file:${buildDirectory}/repository
			p2.artifact.repo=file:${buildDirectory}/repository
			
p2.metadata.repo.name
p2.artifact.repo.name
Właściwość opcjonalna. Służy do określania nazwy repozytoriów platformy p2 generatora.
W przypadku użycia istniejącego repozytorium, jego nazwa nie zostanie zmieniona. Jeśli wartość tej właściwości nie zostanie określona, platforma p2 nada repozytoriom nazwę zgodną z ich położeniem.
p2.flavor
Służy do ustawiania rodzaju metadanych platformy p2. W przypadku generowania metadanych dla pakietu SDK środowiska Eclipse używany jest rodzaj tooling.
p2.publish.artifacts
Aby opublikować pliki JAR w repozytorium artefaktów, należy ustawić tę właściwość na wartość true. Jeśli właściwość ma wartość false, metadane artefaktów są generowane, ale pliki JAR nie są kopiowane do repozytorium artefaktów. OSTRZEŻENIE: Jeśli wartość właściwości to true, należy upewnić się, że wartość właściwości p2.artifact.repo nie jest taka sama, jak położenie katalogów składania używanych przez komponent PDE/Build. W przeciwnym razie pliki JAR mogą zostać usunięte.
p2.root.name
p2.root.version
Służy do określania nazwy i wersji głównej jednostki IU, która będzie zawierać wszystkie zbudowane elementy.
Jeśli w budowaniu określono plik .product, te właściwości zostaną zignorowane. Zamiast tego, jeśli plik .product jest dostępny, nazwa i wersja elementu głównego będą identyfikatorem i wersją produktu z pliku .product. Więcej informacji na ten temat można znaleźć poniżej.

Generowanie metadanych dla produktów

Podczas uruchamiania budowania z plikiem produktu ustawionym w pliku konfiguracyjnym budowania najwyższego poziomu build.properties (w przypadku budowania zarówno z użyciem pliku productBuild.xml, jak i zwykłego pliku build.xml) komponent PDE/Build automatycznie wygeneruje metadane dla tego produktu.

Oprócz tworzenia jednostek instalowalnych dla wszystkich składników i pakunków utworzone zostaną także następujące jednostki instalowalne produktu:

Za pomocą tych wszystkich wygenerowanych jednostek instalowalnych możliwe jest użycie platformy p2 do zainstalowania kompletnego produktu z repozytorium.

Szczegóły

Komponent PDE/Build zasadniczo wywołuje zadanie generowania metadanych udostępniane przez platformę p2 w określonych punktach procesu budowania. Możliwe jest, że podczas budowania nie będzie sytuacji, w której wszystkie artefakty budowania będą istniały w tym samym położeniu na dysku. W związku z tym konieczne może być wywołanie generatora metadanych platformy p2 dla archiwów końcowych lub (w celu optymalizacji) wywołanie tego generatora wiele razy podczas budowania.

Generowanie metadanych będzie miało miejsce podczas faz składania i tworzenia pakietów. Taka sytuacja ma miejsce zarówno w przypadku normalnego budowania, jak i budowania z użyciem programu do tworzenia pakietów. Przykładowo w przypadku budowania produktu przy użyciu pliku productBuild.xml zostaną wygenerowane następujące skrypty (założenia: configs=win32,win32,x86 & linux,gtk,ppc):

Skrypty składania służą do zbierania składników i wtyczek zbudowanych razem z powiązanymi plikami głównymi. Skrypty tworzenia pakietów służą do zbierania wstępnie zbudowanych wtyczek i składników binarnych. Skrypty specyficzne dla platformy służą do zbierania części dla tych konkretnych konfiguracji, a skrypty all delegują do poszczególnych skryptów specyficznych dla platformy.

Wywołania generowania platformy p2 wystąpią w następujący sposób:

  1. assemble win32.win32.x86: Generowanie metadanych zebranych składników i wtyczek dla systemu Windows.
  2. assemble win32.win32.x86: Drugie wywołanie wygenerowanych metadanych dla zebranych plików głównych na potrzeby systemu Windows.
  3. assemble linux.gtk.ppc: Generowanie metadanych zebranych składników i wtyczek dla systemu Linux.
  4. assemble linux.gtk.ppc: Drugie wywołanie wygenerowanych metadanych dla zebranych plików głównych na potrzeby systemu Linux.
  5. assemble all: W przypadku, gdy nie jest uruchamiany program do tworzenia pakietów: Generowanie metadanych dla głównej jednostki instalowalnej zawierającej wszystkie powyższe elementy.
  6. package win32.win32.x86: Generowanie metadanych spakowanych składników i wtyczek dla systemu Windows.
  7. package win32.win32.x86: Drugie wywołanie wygenerowanych metadanych w przypadku plików głównych z pakietów dla systemu Windows.
  8. package linux.gtk.ppc: Generowanie metadanych spakowanych składników i wtyczek dla systemu Linux.
  9. package linux.gtk.ppc: Drugie wywołanie wygenerowanych metadanych w przypadku plików głównych z pakietów dla systemu Linux.
  10. package all: Generowanie metadanych dla głównej jednostki instalowalnej zawierającej wszystkie powyższe elementy.

Zadanie generatora metadanych platformy p2 obsługuje generowanie przyrostowe. Poszczególne wywołania wygenerowanych metadanych platformy p2 są przeprowadzane przy użyciu parametru mode=incremental. Wywołanie końcowe służące do generowania głównej jednostki instalowalnej jest uruchamiane z parametrem mode="final".