Metadane danego składnika lub pakunku mogą się od siebie różnić w zależności od sposobu ich wygenerowania. Szczególnie w przypadku dostosowywania metadanych lub wtedy, gdy składniki wnoszą pliki główne.
Z tego powodu, jeśli to możliwe, zawsze dobrze jest ponownie wykorzystywać metadane zamiast generować je ponownie w oparciu o pakunki i składniki binarne, które mogą nie należeć do użytkownika.
Zadanie Ant <p2.repo2runnable> transformuje artefakty składników i pakunków do postaci zainstalowanej. Ogólnie mówiąc, jest to postać, którą muszą mieć wtyczki, aby można było względem nich wykonać kompilowanie. Zadanie to umożliwia łatwe ponowne wykorzystywanie repozytoriów z innych projektów we własnym budowaniu. Komponent PDE/Build ma wbudowany mechanizm integracji z tym zadaniem dzięki następującym właściwościom:
| repoBaseLocation | Folder zawierający repozytoria przeznaczone do transformacji. Folder ten może zawierać repozytoria spakowane w formacie ZIP oraz podfoldery, które są repozytoriami. |
| transformedRepoLocation | Folder, w którym mają zostać umieszczone artefakty po transformacji. Folder ten stanie się wtedy repozytorium p2. |
build.properties:
repoBaseLocation=${buildDirectory}/inputRepositories
transformedRepoLocation=${buildDirectory}/transformedRepo
customTargets.xml:
<target name="preProcessRepos">
<p2.mirror source="http://download.eclipse.org/releases/galileo" destination="file:${repoBaseLocation}/mirrored">
<iu id="org.eclipse.equinox.p2.user.ui.feature.group" />
<iu id="org.eclipse.cdt.feature.group"/>
</p2.mirror>
<property name="RCP.Repo-3.5RC3" value="http://download.eclipse.org/eclipse/downloads/drops/S-3.5RC3-200905282000/org.eclipse.rcp-p2repo-3.5RC3.zip" />
<property name="Equinox.Repo-3.5RC3" value="http://download.eclipse.org/equinox/drops/S-3.5RC3-200905282000/equinox-SDK-3.5RC3.zip" />
<get src="${RCP.Repo-3.5RC3" dest="${repoBaseLocation}/org.eclipse.rcp-p2repo-3.5RC3.zip" />
<get src="${Equinox.Repo-3.5RC3" dest=""${repoBaseLocation}/eclipse-equinox-3.5RC3.zip" />
</target>
Podczas tworzenia dokumentacji położenie ostatecznych plików ZIP w wersji
3.5 nie było jeszcze znane. Adresy URL służą wyłącznie jako przykład i mogą
być niepoprawne w późniejszym czasie.
Komponent PDE/Build w pierwszej kolejności wywoła niestandardowy element docelowy repozytorium preProcessRepos, a następnie wywoła zadanie Ant repo2runnable w celu wykonania transformacji pobranych repozytoriów do postaci, w której będzie można je ponownie wykorzystywać w mechanizmie budowania.
Właściwość transformedRepoLocation, która definiuje położenie danych wyjściowych transformacji, służy także jako repozytorium kontekstu.
Właściwość p2.context.repos to rozdzielona przecinkami lista repozytoriów służących jako kontekst budowania.
Podczas generowania metadanych mechanizm budowania najpierw sprawdzi repozytoria kontekstów, aby ustalić, czy istnieją już metadane składnika lub wtyczki. Jeśli metadane już istnieją, zostaną skopiowane do lokalnego repozytorium budowania (${p2.build.repo}) i nowe metadane nie będą generowane.
Dodatkowo, jeśli składniki, pakunki lub produkty dostosowały metadane i są zależne od elementu, który nie został włączony do budowania, komponent PDE/Build utworzy kopię lustrzaną na podstawie repozytoriów kontekstów. Operacja tworzenia kopii lustrzanej obejmie wszystkie jednostki instalowalne, które zostały dodane do metadanych składnika lub wtyczki.