Budowanie produktów i repozytoriów platformy p2

Komponent PDE/Build ma wbudowaną obsługę publikowania metadanych platformy p2 przy użyciu nowego publikatora p2. Nadal można dokonywać integracji przy użyciu starego generatora metadanych w wersji 3.4, jednak nie obsługuje on nowszych funkcji, takich jak dostosowywanie metadanych.

Integracja w nowym publikatorze zbiera składniki i pakunki ze źródła i publikuje je bezpośrednio w repozytorium p2. Aby używać nowych funkcji, program budujący powinien zdefiniować właściwość:

p2.gathering = true

Ustawienie tej właściwości znacząco zmieni budowanie:

Więcej informacji na temat typów budowania można znaleźć na odpowiednich stronach pomocy budowania składników i produktów.

Przegląd zmian

Lokalne repozytorium budowania

Podczas budowania wszystkie metadane i artefakty zostaną opublikowane w repozytorium budowania zdefiniowanym przez właściwość p2.build.repo. Ta właściwość powinna określać identyfikator URI, a jej wartość domyślna to: file:${buildDirectory}/buildRepo.

Po opublikowaniu wszystkich metadanych i artefaktów w repozytorium końcowe skrypty składania i tworzenia pakietów utworzą kopię lustrzaną i/lub wykonają instalację z repozytorium do położeń, które będą archiwami utworzonymi przez proces budowania. Zapis lustrzany i instalację można pominąć, używając właściwości skipMirroring i skipDirector. Wyniki budowania pozostaną wtedy tylko w repozytorium budowania.

Generowany plik build.xml: zbieranie a publikowanie

W wygenerowanym pliku build.xml dla składników i wtyczek znajduje się element docelowy gather.bin.parts, którego rola polegała na zebraniu zawartości składników i wtyczek oraz skopiowaniu jej do katalogu końcowego w celu zarchiwizowania do pliku JAR (lub nie) oraz włączenia do wyników budowania. Używając właściwości p2.gathering=true, można zamiast tego opublikować składnik lub wtyczkę bezpośrednio w repozytorium p2. Oznacza to, że platforma p2 jest używana w celu zbierania artefaktów binarnych bezpośrednio ze źródła (stąd nazwa właściwości).

Służy do tego nowy element docelowy o nazwie publish.bin.parts, który używa nowych zadań Ant udostępnianych przez komponent PDE/Build. W starszych wersjach wywoływanie elementu gather.bin.parts podczas budowania następowało przy użyciu delegowania przez strukturę składnika. Wywoływanie elementu publish.bin.parts odbywa się natomiast bezpośrednio z nowego generowanego skryptu składania platformy p2.

Pliki główne udostępniane przez składniki

Wcześniejsze wersje mechanizmów integracji grupowały wszystkie pliki główne, wnoszone przez wszystkie składniki budowania, w pojedynczą jednostkę instalowalną i artefakt plików głównych (których nazwy mogły pochodzić od produktu). W nowym sposobie obsługi publikowania pliki główne są wiązane ze składnikiem, który je wniósł. Więcej informacji zawiera strona układu metadanych składnika.

Skrypty składania

We wcześniejszych wersjach integracja odbywała się przez wywoływanie generatora metadanych względem wyników binarnych podczas procesu składania i tworzenia pakietów. W przypadku używania właściwości p2.gathering=true dostępny jest nowy skrypt assemble.<składnik>.p2.xml.

Skrypt ten wywołuje element publish.bin.parts dla wszystkich budowanych składników i pakunków. Publikuje on również metadane wszystkich istniejących już binarnych składników i wtyczek oraz metadane produktów.

Po zakończeniu działania skryptu składania p2, ale przed wywołaniem pozostałych skryptów składania i tworzenia pakietów, gotowe jest kompletne repozytorium z pełnymi wynikami budowania. Pozostałe skrypty składania i tworzenia pakietów po prostu dzielą repozytorium na części i/lub dokonują instalacji przy użyciu obiektu kierującego platformy p2 w celu utworzenia archiwów końcowych będących wynikami budowania.