Bygge funksjoner

PDE Build har en infrastruktur som automatisere byggingen av funksjoner. Det meste av oppsettet som er nødvendig for en slik bygging, kan gjøres gjennom noen få endringer av malen build.properties, som finnes i PDE Build. Den følgende delen beskriver oppsett for en enkel bygging, forutsatt at alle plugin-moduler og funksjoner (både for bygging og forhåndsbygde) det refereres til fra funksjonen som blir bygd, allerede er lokalt tilgjengelige på disken.

Grunnleggende oppsett

Det første trinnet i oppsettet av en bygging er å opprette katalogen der byggingen skal finne sted. Denne katalogen blir kalt byggekatalogen, og den skal inneholde plugin-modulene og funksjonene som skal bygges, i tillegg til alle de genererte artefaktene. Deretter kopierer du plugin-modulene og funksjonene henholdsvis til underkatalogene "plugins" og "features". Det forventes at features-mappen inneholder funksjonen som blir bygd.

Det andre trinnet i oppsettet av en bygging, er å kopiere malen build.properties file fra org.eclipse.pde.build/templates/headless-build til en ny katalog som skal være katalogen for byggekonfigurasjonen (også kalt konfigurasjonskatalogen). Rediger den kopierte build.properties-filen, og definer disse egenskapene:

Styre hva som skal bygges: allElements.xml

Kopier filen allElements.xml fra org.eclipse.pde.build/templates/headless-build til konfigurasjonskatalogen. Dette er filen som forteller PDE hvilken funksjon du bygger. Denne filen inneholder to typer mål: allElementsDelegator som oppgir funksjonen som blir bygd, og assembleringsmålene som det sendes kall til for å assemblere individuelle konfigurasjoner. allElementsDelegator for en funksjon kalt org.foo.Feature er:
 	<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
Med assembleringsmålene kan du styre navnet på det endelige arkivet per konfigurasjon. Du bør ha ett mål for hver konfigurasjon du bygger. Når du for eksempel bygger org.foo.Feature for Windows (når configs er definert til win32, win32, x86), må du ha det følgende målet:
<!--Target for assembling  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 plattformuavhengig konfigurasjon (når configs ikke er definert eller er definert til *,*,*), bør du ha et mål som dette:
<!--The platform independent assemble target-->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>

Kjøre byggingen

Når du skal kjøre byggingen, bruker du applikasjonen org.elipse.ant.core.antRunner. Når du aktiverer Eclipse med denne applikasjonen for å utføre en bygging, må du definere to argumenter på kommandolinjen:
Kjør antRunner-applikasjonen med denne kommandoen:
java -jar <eclipseInstall>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml> -Dbuilder=<path to the build configuration folder>
Når byggingen er fullført, kan du finne resultatet i byggekatalogen i mappen I.TestBuild (dette navnet kan konfigureres ved å definere egenskapen buildLabel).

Avanserte scenarier

Hvis du trenger mer tilpasning av byggingen, for eksempel henting fra et datalager, finner du mer informasjon under Avanserte PDE Build-emner.