Rozszerzenia komponentu PDE Build dla publikatora p2

Komponent PDE Build zawiera kilka zadań Ant rozszerzających funkcjonalność publikatora p2. Dzięki tym zadaniom komponent PDE Build może publikować metadane i artefakty bezpośrednio w repozytorium platformy p2.

Generowane skrypty budowania używają zadań w kontekście pełnego budowania, gdzie wykonuje się takie działania, jak kompilowanie plików klas i zastępowanie wersji. Jednak niektóre z zadań mogą być przydatne w szczególnych przypadkach w celu bezpośredniego publikowania metadanych, bez uruchamiania pełnego budowania.

eclipse.publish.featuresAndBundles

To zadanie jest podobne do zadania p2.publish.featuresAndBundles dostarczanego przez publikator p2. To zadanie spowoduje opublikowanie metadanych dla uprzednio istniejących binarnych składników i wtyczek, które nie są budowane na podstawie źródła. Spowoduje również opublikowanie kategorii opartych na udostępnionym pliku site.xml lub category.xml.

To zadanie obsługuje następujące atrybuty:

metadataRepository Identyfikator URI określający repozytorium metadanych na potrzeby publikowania.
artifactRepository Identyfikator URI określający repozytorium artefaktów na potrzeby publikowania.
repository Służy do określania zarówno atrybutu metadataRepository, jak i artifactRepository.
site Adres URL wskazujący plik site.xml, w którym określono informacje o kategorii.
category Adres URL pliku category.xml, w którym określono informacje o kategorii.
siteQualifier Kwalifikator służący do zapewniania unikalnych nazw jednostek IU kategorii wynikowej.
<features> Zagnieżdżony element zbioru plików określający położenia składników binarnych do opublikowania.
<bundles> Zagnieżdżony element zbioru plików określający położenia wtyczek binarnych do opublikowania.
Przykład:
 <eclipse.publish.featuresAndBundles repository="file:C:/build/repository" category="file:C:/build/category.xml" >
     <features dir="C:\eclipse\features\" includes="org.eclipse.cvs_1.1.100.v20090514-7E79FEc9BJ99r9XGQ3CICF" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.cvs_1.0.300.v20090520.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.core_3.3.200.I20090430-0408.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh_3.2.100.I20090508-2000.jar" />

     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh2_3.2.200.I20090508-2000.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ui_3.3.200.I20090521-1750.jar" />
 </eclipse.publish.featuresAndBundles>

eclipse.gatherBundle

Umożliwia opublikowanie wtyczki bezpośrednio ze źródła. Po skompilowaniu plików .class dla pakunku to zadanie spowoduje zebranie wszystkich plików tworzących wynik binarny i ich opublikowanie jako artefaktu p2 z metadanymi. To zadanie jest używane w zadaniu publish.bin.parts w wygenerowanym pliku build.xml wtyczki i zastępuje zadanie gather.bin.parts podczas budowania przy użyciu publikatora p2.

To zadanie obsługuje następujące atrybuty:

metadataRepository Identyfikator URI określający repozytorium metadanych na potrzeby publikowania.
artifactRepository Identyfikator URI określający repozytorium artefaktów na potrzeby publikowania.
buildResultFolder Folder zawierający zbudowane pliki .class, manifest oraz (potencjalnie) pliki .api_description.
targetFolder Treść w przypadku używania pliku customBuildCallbacks.
baseDirectory Położenie projektu, z którego ma być zbierana treść, gdy plik customBuildCallbacks nie jest używany.
unpack Określa, czy wtyczka powinna być rozpakowana do postaci folderu w trakcie instalacji.
gatheredSource W przypadku pakunków źródłowych jest to położenie źródła zbierania danych.
<outputFolder> Zagnieżdżone elementy określające alternatywne położenia, z których mają być pobierane pliki .class, używane podczas ponownego wykorzystywania plików .class z obszaru roboczego. Jest to zbiór plików Ant z dodatkowym atrybutem „library” określającym bibliotekę, do której należą pliki klas.
Przykład:
 <eclipse.gatherBundle metadataRepository="file:/build/repo" artifactRepository="file:/build/repo"
                       buildResultFolder="${basedir}" baseDirectory="${basedir}" unpack="true" >
     <outputFolder library="lib/pdebuild-ant.jar" dir="${basedir}" includes="bin_ant/**" />

     <outputFolder library="pdebuild.jar" dir="${basedir}" includes="bin/**" />
 </eclipse.gatherBundle>

eclipse.gatherFeature

Umożliwia opublikowanie składnika bezpośrednio ze źródła. To zadanie spowoduje zebranie wszystkich plików tworzących plik JAR składnika i ich opublikowanie jako artefaktu p2 z metadanymi. To zadanie spowoduje również opublikowanie artefaktów zawierających dowolne pliki główne dostarczane przez ten składnik. Jeśli w składniku nie zostanie określona właściwość bin.includes, plik JAR składnika nie zostanie wygenerowany, ale nadal będą istnieć artefakty plików głównych i metadane grupy składników.

To zadanie obsługuje następujące atrybuty:

metadataRepository Identyfikator URI określający repozytorium metadanych na potrzeby publikowania.
artifactRepository Identyfikator URI określający repozytorium artefaktów na potrzeby publikowania.
buildResultFolder Folder zawierający zmodyfikowany plik feature.xml z zastąpionymi wersjami.
targetFolder Treść w przypadku używania pliku customBuildCallbacks.
baseDirectory Położenie projektu składnika.
Przykład:
 <eclipse.gatherFeature
     metadataRepository="file:/build/repo"
     artifactRepository="file:/build/repo"
     buildResultFolder="${basedir}"
     baseDirectory="${basedir}"
 />


eclipse.brand.p2.artifacts

Umożliwia oznakowanie marką w przypadku artefaktów programu uruchamiającego dla produktu i ich ponowne opublikowanie z nową nazwą na potrzeby włączenia do danego produktu.

To zadanie obsługuje następujące atrybuty:

metadataRepository Identyfikator URI określający repozytorium metadanych na potrzeby publikowania.
artifactRepository Identyfikator URI określający repozytorium artefaktów na potrzeby publikowania.
config Konfiguracja, dla której zostaną użyte programy uruchamiające (np. gtk.linux.x86).
iconsList Położenia, w których mają być wyszukiwane ikony służące do oznaczania plików wykonywalnych.
tempDirectory Położenie tymczasowego katalogu, który może być używany.
productId Identyfikator produktu, dla którego jest przeprowadzane publikowanie.
productVersion Wersja produktu, dla którego jest przeprowadzane publikowanie.
launcherName Nazwa, która ma zostać nadana nowemu programowi uruchamiającemu.
launcherProvider Nazwa jednostki IU udostępniającej oryginalne artefakty programu uruchamiającego. Domyślnie jest to nazwa „org.eclipse.equinox.executable”, a zadanie będzie wyszukiwać artefakty o nazwie <launcherProvider>_root.<config>.