PDE Build leveres med infrastruktur til at automatisere bygning af funktioner. Det meste af den nødvendige konfiguration til en sådan bygning kan udføres vha. nogle få ændringer i skabelonen build.properties, som leveres 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.
Det første trin i konfigurationen af en bygning er at oprette biblioteket til byggekonfigurationen. Det er det bibliotek, hvor de filer, der bruges til at styre og tilpasse hovedløse bygninger, opbevares.
Hovedfilen til styring af bygning er filen build.properties på byggekonfigurationens øverste niveau. Når du konfigurerer en ny bygning, skal du kopiere den skabelonfil fra bundtet org.eclipse.pde.build i Eclipse-installationen, som du vil bruge til at køre bygningen. Skabelonfilen findes under org.eclipse.pde.build/templates/headless-build/build.properties.
I egenskaberne for byggeprogrammet, som normalt angives på ant-kommandolinjen, refereres til dette bibliotek.
Egenskaben buildDirectory angiver det bibliotek, hvori PDE/Build vil generere scripts og foretage den egentlige bygning. Plugins og funktioner, der bygges, skal placeres i underbibliotekerne ${buildDirectory}/plugins og ${buildDirectory}/features. Hvis bundter og funktioner hentes fra et opbevaringssted (se Hent fra opbevaringssteder), vil de også blive placeret her.
Biblioteket kan være det samme som biblioteket til byggekonfigurationen eller et andet bibliotek. Det kan være en fordel at bruge et særskilt bibliotek, især hvis byggekonfigurationen opbevares i CVS, og du ikke vil fylde det med genererede byggeartefakter.
Du kan konfigurere en grundlæggende funktionsbygning ved at redigere byggekonfigurationsfilen build.properties og angive følgende egenskaber:
Den tidligere version af PDE/Build kræver også filen allElements.xml. Den er ikke længere nødvendig i 3.4. allElements.xml kan stadig bruges, men filen kræves kun, hvis du vil tilpasse visse aspekter af bygningen. Se Tilpas en hovedløs bygning.
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:
-buildfile=</sti/til/bygning.xml>
: Dette er stien til den build.xml-fil, som følger med PDE Build. Filen findes i biblioteket org.eclipse.pde.build/scripts. Det er det byggescript, der driver hele byggeprocessen.-Dbuilder=</sti/til/konfigurationsfolder>
:
Dette er stien til byggekonfigurationsfolderen.Udfør programmet antRunner med følgende kommando:
java -jar
<eclipseInstall>/plugins/org.eclipse.equinox.launcher_<version>.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).
Hvis du har brug for at tilpassebyggeprocessen yderligere, f.eks. hente fra et opbevaringssted, kan du finde flere oplysninger under Avancerede PDE Build-emner.