Bygga funktioner

PDE-bygget har en infrastruktur som gör det möjligt att automatisera bygget av funktioner. 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 bygge 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 den funktion som byggs, redan finns tillgängliga på hårddisken.

Grundläggande steg för bygge

Byggkonfigurationskatalog

Det första steget när du förbereder ett bygge är att skapa byggkonfigurationskatalogen. Detta är den katalog där filerna som styr och anpassar det konsollösa bygget lagras.

Huvudfilen som styr bygget är byggkonfigurationsfilen build.properties på den översta nivån. När du konfigurerar ett nytt bygge kopierar du mallfilen från samlingspaketet org.eclipse.pde.build i eclipseinstallationen som du ska använda för att köra bygget. Mallfilen ligger under org.eclipse.pde.build/templates/headless-build/build.properties.

Denna katalog hänvisas till av de byggar-egenskaper som normalt anges på ant-kommandoraden.

Byggkatalogen

Egenskapen buildDirectory ange den katalog där PDE/Build kommer att generera skript och utföra det faktiska bygget. Insticksprogram och funktioner som byggs ska placeras i underkatalogerna ${buildDirectory}/plugins och ${buildDirectory}/features. Om samlingspaket och funktioner ska hämtas från ett lager (se Hämta från lager), placeras även de här.

Den här katalogen kan vara densamma som byggkonfigurationskatalogen eller så kan den vara en annan katalog. Det kan vara önskvärt att använda en separat katalog, i synnerhet om byggkonfigurationen lagras i CVS och du inte vill smutsa ned den med genererade byggartefakter.

Ursprungliga egenskaper

Om du vill konfigurera ett grundläggande funktionsbygge måste du redigera byggkonfigurationsfilen build.properties och ange följande egenskaper:

Föregående version av PDE/Build krävde även filen allElements.xml, detta behövs inte längre i 3.4. allElements.xml kan fortfarande användas, men krävs bara om du vill anpassa vissa aspekter av bygget. Se Anpassa ett konsollöst bygge.

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>/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 bygget är klart kan du kan du hämta resultatet i byggkatalogen i mappen I.TestBuild (det här namnet kan konfigureras med hjälp av egenskapen buildLabel).

Avancerade scenarier

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