Byg funktioner

PDE Build leveres med infrastruktur til at automatisere bygning af funktioner. Det meste af den nødvendige konfiguration til bygning kan udføres med nogle få ændringer til skabelonen build.properties, som følger med PDE Build. Det følgende afsnit koncentrerer sig om at konfigurere en enkelt bygning, idet det antages, at alle de plugins og funktioner (både dem, der skal bygges, og dem, der er bygget), der henvises til fra den funktion, som bygges, findes på den lokale disk.

Basiskonfiguration

Det første trin i konfigurationen af en bygning er at oprette det bibliotek, hvor bygningen skal udføres. Dette bibliotek kaldes byggebiblioteket og indeholder de plugins og funktioner, der skal bygges, samt alle de genererede artefakter. Derefter skal du kopiere dine plugins og funktioner til underbibliotekerne "plugins" og "features". Funktionsfolderen vil indeholde den funktion, der bygges.

Det andet trin i konfigurationen af en bygning består i at kopiere skabelonfilen build.properties fra org.eclipse.pde.build/templates/headless-build til et nyt bibliotek, som skal være byggekonfigurationsbiblioteket (dette kaldes også konfigurationsbiblioteket). Redigér den kopierede build.properties-fil, og angiv følgende egenskaber:

Kontrollér, hvad der bygges: allElements.xml

Kopiér filen allElements.xml fra org.eclipse.pde.build/templates/headless-build til konfigurationsbiblioteket. Dette er den fil, der fortæller PDE, hvilken funktion du bygger. Filen indeholder to typer af mål:  allElementsDelegator, som angiver den funktion, der bygges, og samlingsmålene, der kaldes for at samle individuelle konfigurationer.  Dette er allElementsDelegator til en funktion med navnet org.foo.Feature:
 	<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
Samlingsmålene gør det muligt at kontrollere navnet på det endelige arkiv for hver konfiguration. Du bør have et mål til hver konfiguration, som du bygger. Når du f.eks. bygger org.foo.Feature til Windows (når configs er angivet til win32, win32, x86), bør du have følgende mål:
<!--Mål til samling  styresystem=win32, vinduessystem=win32, arkitektur=x86 -->
<target name="assemble.org.foo.Feature.win32.win32.x86">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}/">
</target>
Ved bygning af en platformsuafhængig konfiguration (når configs ikke er angivet eller er angivet til *,*,*) bør du angive et mål som følger:
<!--Platformsuafhængigt samlingsmål-->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>

Udfør bygningen

For at udføre bygningen skal du benytte programmet org.elipse.ant.core.antRunner. Når eclipse startes med dette program for at bygge, skal du angive to argumenter på kommandolinjen:
Udfør programmet antRunner med følgende kommando:
java -jar <eclipseInstall>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml> -Dbuilder=<sti til byggekonfigurationsfolderen>
Når bygningen er færdig, finder du resultatet i byggebiblioteket i folderen I.TestBuild (navnet kan konfigureres ved indstilling af egenskaben buildLabel).

Avancerede scenarier

Hvis du har brug for at konfigurere byggeprocessen yderligere, f.eks. hente fra et opbevaringssted, kan du finde flere oplysninger under Avancerede PDE Build-emner.