Skapa en RCP-tillämpning från en produktkonfigurationsfil

PDE-bygget levereras med en infrastruktur där det går att bygga en fullständig RCP-tillämpning från en produktkonfigurationsfil. Den största delen av den konfiguration som krävs för ett sådant bygge kan göras med några få ändringar av mallen build.properties som medföljer PDE-bygget. I följande avsnitt ligger fokus på att skapa ett enkelt produktbygge där det förutsätts att alla insticksprogram och funktioner (både sådana som ska byggas och förbyggda), som refereras till från produktfilen, redan finns tillgängliga på hårddisken.

Grundläggande steg för bygge

Det första steget när du förbereder ett bygge är att skapa den katalog där bygget ska utföras. Den katalogen kallas build directory och innehåller de insticksprogram och funktioner som ingår i bygget samt alla genererade testobjektssamlingar. Sedan kopierar du insticksprogram och funktioner till underkatalogen "plugins" respektive "features". Produktkonfigurationsfilen förväntas finnas i någon av de här plugins-/features-katalogerna.

Det andra steget när du skapar ett bygge är att kopiera mallfilen build.properties från org.eclipse.pde.build/templates/headless-build till en ny katalog, "build configuration directory" (eller bara configuration directory). Redigera den kopierade filen build.properties och ange följande egenskaper:

Översikt över katalogstrukturen

<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
...

Köra bygget

När du vill köra bygget använder du tillämpningen org.elipse.ant.core.antRunner. När du anropar Eclipse med den här tillämpningen för att utföra ett bygge måste du ange två argument på kommandoraden:
Kör tillämpningen antRunner med hjälp av följande kommando:
java -jar <eclipseInstall>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/productBuild/productBuild.xml> -Dbuilder=<sökvägen till mappen för byggkonfigurationen>

Avancerade scenarion

Bakom kulisserna genererar den här konfigurationen en funktion som innehåller de insticksprogram och funktioner som angavs i produktkonfigurationsfilen.  Den här genererade funktionen används sedan till att driva en normal funktion baserat på konsollöst bygge. Om du vill anpassa bygget ytterligare, dvs. hämta det från ett lager, kan du läsa informationen i avsnitten om avancerade PDE-byggen.