Sestavení produktů s p2

Definování nové vlastnosti:

p2.gathering = true

způsobí malý počet změn sestavení produktů. Sestavení zejména vytvoří správně instalované produkty plně podporující p2.

Následuje seznam souvisejících vlastností (starých a nových):

p2.gatheringHodnota true zapíná sestavení založená na vydavateli p2.
p2.build.repoIdentifikátor URI na lokální úložiště pro čas sestavení p2, výchozí nastavení je file:${buildDirectory}/buildRepo. Výsledky budou zrcadleny z tohoto místa do umístění konečného archivu.
generate.p2.metadataTato vlastnost je pro starou integraci generátoru metadat. Nemá vliv, je-li nastaveno p2.gathering=true.
p2.metadata.repo
p2.artifact.repo
Tyto vlastnosti jsou identifikátory URI. Standardně pro sestavení produktů jsou konečné archivy instalované produkty a metadata a artefakty ponechané v ${p2.build.repo}. Pokud jsou definovány vlastnosti p2.metadata.repo a p2.artifact.repo, budou artefakty a metadata pro produkt zrcadleny z úložiště sestavení.
p2.metadata.repo.name
p2.artifact.repo.name
Volitelné, tyto vlastnosti budou použity k pojmenování konečného úložiště při použití vlastností p2.metadata.repo a p2.artifact.repo.
p2.compressJe-li tato vlastnost nastavena na hodnotu true, dojde ke zkomprimování XML konečného úložiště do souboru JAR.
p2.flavorProvedení produktu, použito jako kvalifikátor v konfiguračních metadatech pro produkt. Viz níže.
p2.product.qualifierKvalifikátor, který má být použit pro nahrazení "1.0.0.qualifier" ve verzi produktu. Není-li nastaven, bude pro vytvoření kvalifikátoru použita vlastnost forceContextQualifier nebo časové razítko.
p2.publish.artifactsBez účinku, je-li nastaveno p2.gathering=true (stará vlastnost)
p2.root.name
p2.root.version
Bez účinku, je-li nastaveno p2.gathering=true (stará vlastnost)
p2.context.reposDefinuje úložiště kontextu. Viz opětovné použití metadat.
repoBaseLocationSložka obsahující úložiště k transformaci pomocí <p2.repo2runnable>. Viz rovněž opětovné použití metadat.
transformedRepoLocationSložka obsahující výstup <p2.repo2runnable>. Viz rovněž opětovné použití metadat.
p2.category.siteAdresa URL souboru site.xml použitého k definování kategorií.
p2.category.definitionAdresa URL souboru category.xml použitého k definování kategorií.
p2.category.prefixDefinuje předponu pro zajištění jedinečných identifikátorů pro instalovatelné jednotky kategorie vygenerované ze souborů webu/kategorie, které nepoužívají jedinečné názvy.
skipMirroringVynechat konečné zrcadlení z ${p2.build.repo} do ${p2.metadata.repo}.
skipDirectorVynechat volání vedoucího. Nebudou vytvořeny žádné instalované produkty. Jsou-li definovány úložiště p2.metadata.repo a p2.artifact.repo, budou obsahovat metadata a artefakty produktu. Jinak budou výsledky v úložišti ${p2.build.repo}.
p2.director.logUmístění souboru protokolu k protokolování výsledků volání vedoucího.
p2.director.profileNázev profilu p2 vytvářeného vedoucím. Obecně je užitečné použít název související věcně s vaším produktem. Výchozí hodnota je "profile".
p2.director.extraArgsDalší argumenty pro předání vedoucímu. Výchozí hodnota je "-profileProperties org.eclipse.update.install.features=true".
Vlastnosti zrcadleníPři sestavování produktů nebo funkcí zrcadlí Sestavení PDE závislosti z úložišť kontextu, která se mají zahrnout do sestavení. Tyto vlastnosti řídí, které závislosti jsou do této operace zahrnuty. Podrobnosti viz Úloha Ant p2.mirror.
p2.mirror.rawVýchozí hodnota: false. Chcete-li znovu použít deskriptory artefaktu ze zdrojových úložišť, nastavte hodnotu true.
p2.mirror.slicing.filterVýchozí hodnota je bez filtru. Nastavte další vlastnosti filtru, které musí instalovatelné jednotky splňovat, aby byly zahrnuty.
p2.mirror.slicing.followOnlyFilteredRequirementsVýchozí hodnota je false. Chcete-li invertovat filtry a zahrnout pouze instalovatelné jednotky, které jim neodpovídají, nastavte hodnotu true.
p2.mirror.slicing.followStrictVýchozí hodnota je false. Chcete-li zahrnout pouze závislosti, jejichž verze jsou přesně určeny, nastavte hodnotu true.
p2.mirror.slicing.includeFeaturesVýchozí hodnota je true. Zda budou nebo nebudou zahrnuty funkce.
p2.mirror.slicing.includeNonGreedyVýchozí hodnota je false. Zda budou nebo nebudou zahrnuty nasycené závislosti.
p2.mirror.slicing.includeOptionalVýchozí hodnota je true. Zda budou nebo nebudou zahrnuty volitelné závislosti.
p2.mirror.slicing.latestVersionOnlyVýchozí hodnota je false. Zda bude nebo nebude zahrnuta pouze nejnovější verze závislosti, když je požadavkem rozsah a je dostupných více verzí.
p2.mirror.slicing.platformFilterVýchozí hodnota je bez filtru. Triplet "os,ws,arch", který bude nastaven jako platforma, s níž budou porovnávány filtry LDPAD instalovatelných jednotek. Instalovatelné jednotky, které nezachytí filtr, nebudou zrcadleny.

Provedení produktu

V rámci sestavení produktu Sestavení PDE automaticky vygeneruje metadata výchozí konfigurace k nastavení spouštěcích úrovní a vlastnosti config.ini. Tato metadata se obvykle nazývají Konfigurační jednotky (CU - Configuration Unit). Spouštěcí úrovně se nastavují pomocí fragmentů CU v instalační jednotce pro spouštěný balík. Provedení se používá jako kvalifikátor při generování názvu konfigurační jednotky na základě instalační jednotky.

Například při použití "p2.flavor = tooling" bude 'toolingwin32.win32.x86org.eclipse.core.runtime' názvem konfigurační jednotky, jež konfiguruje balík org.eclipse.core.runtime ve Windows. Doporučujeme vám ve vhodném případě odvozovat provedení z ID svého produktu, a předejít tak kolizím s jinými metadaty. Toto platí zejména v situaci, kdy váš produkt má určité potřeby v souvislosti se spouštěcími úrovněmi.

Viz rovněž stránka Konfigurace produktů.

Volání vedoucího

Sestavení PDE zahrnuje cíl runDirector, který je volán k provedení instalací během sestavení produktu. V současné době vzniká tento proces rozvětvením procesu aplikace vedoucí do nového procesu. Ve složitějších situacích lze tuto úlohu opětovně využít k provedení dalších instalací. Úloha vyžaduje definování umístění spouštěcího programu equinox pro tvůrce. Následuje příklad volání:
	<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>