Byg et RCP-program ud fra en produktkonfigurationsfil

PDE Build leveres med infrastruktur til at bygge et komplet RCP-program ud fra en produktkonfigurationsfil. 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 konfigurationen af en simpel produktbygning, idet det antages, at alle plugins og funktioner (både til bygning og forudbygget), som produktfilen refererer til, 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". Produktkonfigurationsfilen forventes at være i en af disse plugins eller funktioner.

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:

Oversigt over biblioteksstrukturen

<buildDirectory>/
plugins/
pluginToBuildA
pluginToBuildB
myProduct.product
...
features/
featureToBuild
...

<buildConfiguration>/
build.properties

<baseLocation>
plugins/
org.eclipse.core.runtime
org.eclipse.ui
...
features/
org.eclipse.rcp
org.eclipse.platform.launchers
...

Udfør bygningen

For at udføre bygningen skal du benytte programmet org.eclipse.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>/plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/productBuild/productBuild.xml> -Dbuilder=<sti til byggekonfigurationsfolderen>

Avancerede scenarier

Bag scenen genererer denne konfiguration en funktion med de plugins eller funktioner, der er angivet i produktkonfigurationsfilen.  Den genererede funktion benyttes derefter til at drive en almindelig funktion baseret på en hovedløs bygning. Hvis du har brug for at tilpasse byggeprocessen yderligere, f.eks. hente fra et opbevaringssted, kan du finde flere oplysninger under Avancerede PDE Build-emner.