Bygga funktioner

PDE-bygget har en infrastruktur som gör det möjligt att automatisera bygge av funktioner. Den största delen av den konfiguration som krävs för ett sådant bygge kan göras med några få ändringar av mallen build.properties som medföljer PDE-bygget. I följande avsnitt ligger fokus på att skapa ett enkelt bygge där det förutsätts att alla insticksprogram och funktioner (både sådana som ska byggas och förbyggda), som refereras till från den funktion som byggs, redan finns tillgängliga på hårddisken.

Grundläggande steg för bygge

Det första steget när du förbereder ett bygge är att skapa den katalog där bygget ska utföras. Den katalogen kallas build directory och innehåller de insticksprogram och funktioner som ingår i bygget samt alla genererade testobjektssamlingar. Sedan kopierar du insticksprogram och funktioner till underkatalogen "plugins" respektive "features". Funktionsmappen förväntas innehålla den funktion som skapas.

Det andra steget när du skapar ett bygge är att kopiera mallfilen build.properties från org.eclipse.pde.build/templates/headless-build till en ny katalog, "build configuration directory" (eller bara configuration directory). Redigera den kopierade filen build.properties och ange följande egenskaper:

Kontroll av vad som ska skapas: allElements.xml

Kopiera filen allElements.xml från org.eclipse.pde.build/templates/headless-build till konfigurationskatalogen. Det här är den fil som meddelar PDE vilken funktion du bygger.   Den här filen innehåller två typer av mål  allElementsDelegator som anger den funktion som skapas och de byggmål som anropas för bygge av enskilda konfigurationer.  allElementsDelegator för en funktion med namnet org.foo.Feature är:
 	<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
Med hjälp av byggmål kan du kontrollera namnet på det slutliga arkivet per konfiguration.  Du bör ha ett mål för varje konfiguration du bygger.   När du till exempel bygger org.foo.Feature för Windows (när configs har värdet win32, win32, x86) bör du använda följande mål:
<!--Mål för bygge os=win32, ws=win32, arch=x86 -->
<target name="assemble.org.foo.Feature.win32.win32.x86">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}/">
</target>
När du bygger en plattformsoberoende konfiguration (när configs inte har något värde eller värdet *,*,*) bör du använda ett mål liknande det följande:
<!--Det plattformsoberoende byggmålet-->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>

Köra bygget

När du vill köra bygget använder du tillämpningen org.elipse.ant.core.antRunner. När du anropar Eclipse med den här tillämpningen för att utföra ett bygge måste du ange två argument på kommandoraden:
Kör tillämpningen antRunner med hjälp av följande kommando:
java -jar <eclipseInstall>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml> -Dbuilder=<sökvägen till mappen för byggkonfigurationen>
När bygget är klart kan du kan du hämta resultatet i byggkatalogen i mappen I.TestBuild (det här namnet kan konfigureras med hjälp av egenskapen buildLabel).

Avancerade scenarion

Om du vill anpassa bygget ytterligare, dvs. hämta det från ett lager, kan du läsa informationen i avsnitten om avancerade PDE-byggen.