Budowanie produktów przy użyciu platformy p2

Zdefiniowanie nowej właściwości:

p2.gathering = true

wprowadzi kilka zmian w procesie budowania produktów. W szczególności budowanie tworzy poprawnie zainstalowane produkty z pełną obsługą platformy p2.

Poniższa lista zawiera wykaz pokrewnych właściwości (starych i nowych):

p2.gatheringAby włączyć budowanie w oparciu o publikator p2, tej właściwości należy nadać wartość true.
p2.build.repoIdentyfikator URI repozytorium p2 budowania lokalnego. Wartość domyślna: file:${buildDirectory}/buildRepo. Wyniki zostaną umieszczone w tym miejscu, a następnie w położeniu archiwum końcowego zostanie utworzona ich kopia lustrzana.
generate.p2.metadataJest to właściwość wcześniejszej wersji integracji generatora metadanych. Nie działa w przypadku ustawienia właściwości p2.gathering=true.
p2.metadata.repo
p2.artifact.repo
Te właściwość to identyfikatory URI. Domyślnie w przypadku budowania produktów archiwa końcowe to zainstalowane produkty. Metadane i artefakty pozostają w repozytorium ${p2.build.repo}. Jeśli zostaną zdefiniowane właściwości p2.metadata.repo i p2.artifact.repo, zostanie utworzona kopia lustrzana artefaktów i metadanych produktu znajdujących się w repozytorium budowania.
p2.metadata.repo.name
p2.artifact.repo.name
Opcjonalne. Właściwości te służą do nadawania nazwy końcowemu repozytorium, jeśli określono właściwości p2.metadata.repo i p2.artifact.repo.
p2.compressAby skompresować końcowe repozytorium w formacie XML do pliku JAR, tej właściwości należy nadać wartość true.
p2.flavorRodzaj produktu używany jako kwalifikator w metadanych konfiguracji produktu. Patrz poniżej.
p2.product.qualifierKwalifikator do użycia w przypadku zastępowania kwalifikatora „1.0.0.kwalifikator” w wersji produktu. Jeśli ta właściwość nie zostanie ustawiona, kwalifikator zostanie określony na podstawie właściwości forceContextQualifier lub znacznika czasu.
p2.publish.artifactsNie działa w przypadku ustawienia właściwości p2.gathering=true (stara właściwość).
p2.root.name
p2.root.version
Nie działa w przypadku ustawienia właściwości p2.gathering=true (stara właściwość).
p2.context.reposDefiniuje repozytoria kontekstu. Patrz sekcja dotycząca ponownego wykorzystywania metadanych.
repoBaseLocationFolder zawierający repozytoria przeznaczone do transformacji przy użyciu zadania <p2.repo2runnable>. Patrz także sekcja dotycząca ponownego wykorzystywania metadanych.
transformedRepoLocationFolder zawierający dane wyjściowe zadania <p2.repo2runnable>. Patrz także sekcja dotycząca ponownego wykorzystywania metadanych.
p2.category.siteAdres URL wskazujący plik site.xml służący do definiowania kategorii.
p2.category.definitionAdres URL wskazujący plik category.xml służący do definiowania kategorii.
p2.category.prefixZdefiniowanie przedrostka zapewnia zastosowanie unikalnych identyfikatorów dla jednostek instalowalnych kategorii wygenerowanych na podstawie plików serwisu/kategorii, które nie używają nazw unikalnych.
skipMirroringSłuży do pomijania końcowego zapisu lustrzanego z repozytorium ${p2.build.repo} do ${p2.metadata.repo}.
skipDirectorSłuży do pomijania wywołania obiektu kierującego. Nie zostanie utworzony żaden zainstalowany produkt. Jeśli repozytoria p2.metadata.repo i p2.artifact.repo zostaną zdefiniowane, to będą one zawierać metadane i artefakty produktu. W przeciwnym razie wyniki będą znajdować się w repozytorium ${p2.build.repo}.
p2.director.logPołożenie pliku dziennika służącego do rejestrowania wyników wywołania obiektu kierującego.
p2.director.profileNazwa, która będzie używana dla profilu p2 utworzonego przez obiekt kierujący. Ogólnie zalecane jest nadanie nazwy związanej z produktem. Wartość domyślna to profile.
p2.director.extraArgsDodatkowe argumenty do przekazania do katalogu. Wartość domyślna to -profileProperties org.eclipse.update.install.features=true.
Właściwości zapisu lustrzanegoPodczas budowania produktów lub składników komponent PDE/Build tworzy kopie lustrzane zależności znajdujących się w repozytoriach kontekstu i dołącza je do kompilacji. Te właściwości decydują o tym, które zależności są uwzględniane w danej operacji. Szczegółowe informacje na ten temat zawiera sekcja Zadanie Ant p2.mirror.
p2.mirror.rawWartość domyślna to false. Ustawienie wartości na true powoduje ponowne wykorzystanie deskryptorów artefaktów z repozytoriów źródłowych.
p2.mirror.slicing.filterWartość domyślna to brak filtru. Służy do ustawiania dodatkowych właściwości filtru, które muszą być spełnione przez jednostki instalowalne, aby można je było dołączyć.
p2.mirror.slicing.followOnlyFilteredRequirementsWartość domyślna to false. Ustawienie wartości na true powoduje odwrócenie filtrów w celu dołączenia jednostek instalowalnych, które nie spełniają ich warunków.
p2.mirror.slicing.followStrictWartość domyślna to false. Ustawienie wartości na true powoduje dołączenie tylko tych zależności, których wersje są dokładnie określone.
p2.mirror.slicing.includeFeaturesWartość domyślna to true. Określa, czy mają być dołączane składniki.
p2.mirror.slicing.includeNonGreedyWartość domyślna to false. Określa, czy mają być dołączane zależności niezachłanne.
p2.mirror.slicing.includeOptionalWartość domyślna to true. Określa, czy mają być dołączane zależności opcjonalne.
p2.mirror.slicing.latestVersionOnlyWartość domyślna to false. Określa, czy mają być dołączane tylko najnowsze wersje zależności, gdy wymaganie jest zdefiniowane przez zakres i dostępnych jest wiele wersji.
p2.mirror.slicing.platformFilterWartość domyślna to brak filtru. Zestaw trzech elementów - system operacyjny, system okienkowy, architektura - które mają zostać ustawione jako platforma i względem których będą dopasowywane filtry LDAP jednostki instalowalnej. Dla jednostek instalowalnych niezgodnych z filtrem nie będzie tworzona kopia lustrzana.

Rodzaj produktu

W ramach budowania produktu komponent PDE/Build automatycznie generuje domyślne metadane konfiguracji w celu ustawienia poziomów uruchamiania i wartości właściwości config.ini. Metadane są powszechnie nazywane jednostkami konfiguracji. W szczególności poziomy uruchamiania są ustawiane przy użyciu fragmentów jednostek konfiguracji w jednostce instalowalnej uruchamianego pakunku. Rodzaj jest używany jako kwalifikator podczas generowania nazwy jednostki konfiguracji w oparciu o jednostkę instalowalną.

Na przykład dla wartości p2.flavor = narzedzia, nazwa jednostki konfiguracji, która konfiguruje pakunek org.eclipse.core.runtime w systemie Windows to narzedziawin32.win32.x86org.eclipse.core.runtime. Dobrym rozwiązaniem może być użycie rodzaju opartego na identyfikatorze produktu, aby uniknąć konfliktów z innymi metadanymi, zwłaszcza jeśli produkt ma szczególne wymagania dotyczące poziomów uruchamiania.

Patrz także strona poświęcona konfigurowaniu produktów.

Wywołanie obiektu kierującego

Komponent PDE/Build obejmuje element docelowy runDirector, który jest wywoływany na potrzeby wykonywania instalacji podczas budowania produktu. Obecnie jest to rozwidlenie aplikacji obiektu kierującego w nowym procesie. W bardziej zaawansowanych scenariuszach inżynierii wersji możliwe jest ponowne wykorzystanie tego zadania w celu przeprowadzenia dodatkowych instalacji. Zadanie wymaga zdefiniowania położenia programu uruchamiającego Equinox dla programu budującego. Przykładowe wywołanie może wyglądać następująco:
	<property name="equinoxLauncherJar" value="/builder/eclipse/plugins/org.eclipse.equinox.launcher_1.0.200.v20090520.jar"/>
	<ant antfile="${eclipse.pdebuild.scripts}/genericTargets.xml" target="runDirector" inheritAll="true">
		<property name="ws" value="gtk"/>
		<property name="os" value="linux"/>
		<property name="arch" value="x86"/>
		<property name="p2.director.installPath" value="${installFolder}"/>
		<property name="p2.repo" value="${p2.build.repo}"/>
		<property name="p2.director.iu" value="my.rcp.product"/>
		<property name="p2.director.version" value="1.0.0"/>
	</ant>