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 leveres av 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

Byggekonfigurasjonskatalogen

Det første trinnet i konfigureringen av en bygging er å opprette katalogen der byggingen skal finne sted. Dette er katalogen der filene som styrer og tilpasser headless-byggingen, oppbevares.

Hovedfilen for å styre byggingen er toppnivåfil for byggekonfigurasjon, build.properties. Ved konfigurering av en ny bygging kopieres malfilen fra bunten org.eclipse.pde.build i Eclipse-installeringen som skal brukes til å utføre byggingen. Malfilen befinner seg under org.eclipse.pde.build/templates/headless-build/build.properties.

Denne katalogen refereres til av egenskapen builder, som normalt defineres på ant-kommandolinjen.

buildDirectory

Egenskapen buildDirectory spesifiserer katalogen der PDE/Build skal generere skript og utføre den faktiske byggingen. Plugin-moduler og funksjoner som bygges, plasseres i underkatalogene ${buildDirectory}/plugins og ${buildDirectory}/features. Hvis bunter og funksjoner hentes fra et datalager (se Hente fra datalagre), blir de plassert her også.

Denne katalogen kan være den samme som byggekonfigurasjonskatalogen, eller den kan være en annen katalog. Det kan være ønskelig å bruke en separat katalog, særlig hvis byggekonfigurasjonen oppbevares i CVS og du ikke vil forurense den med genererte byggeartefakter.

Startegenskaper

For å konfigurere en grunnleggende funksjonsbygging må du redigere byggekonfigurasjonsfilen build.properties og definere følgende egenskaper:

Forrige versjon av PDE/Build krevde også filen allElements.xml, men den er ikke lenger nødvendig i 3.4. allElements.xml kan fortsatt brukes, men den er nødvendig bare hvis du ønsker å tilpasse visse aspekter av byggingen. Se Tilpasse et headless-bygg.

Utføre byggingen

Når du skal utføre byggingen, bruker du applikasjonen org.eclipse.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>/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=<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.