Bygga funktioner
PDE-bygget har en infrastruktur som gör det möjligt att automatisera bygge 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
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".
Funktionsmappen förväntas innehålla den funktion som skapas.
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:
- baseLocation: platsen för en Eclipse-installation som innehåller alla förbyggda funktioner och insticksprogram i underkatalogerna features/ och plugins/.
- baseos: anger operativsystemet för den Eclipse-plattform som anges i baseLocation.
- basews: anger fönstersystemet för den Eclipse-plattform som anges i baseLocation.
- basearch: anger arkitekturen för den Eclipse-plattform som anges i baseLocation.
- buildDirectory:
den katalog där bygget ska utföras. Ange den fullständiga sökvägen till byggkatalogen som du skapade tidigare.
- configs: Ange de konfigurationer som du vill att funktionen ska byggas för. Du kan ta bort kommentarer för de tillgängliga konfigurationerna (var försiktig vad gäller fortsättning på rader). Om den funktion du bygger är plattformsoberoende behöver du inte ange den här egenskapen eller så kan du ange *,*,*.
- archivePrefix:
namnet på den katalog på hårddisken där funktionen zippas upp.
Kontroll av vad som ska skapas: allElements.xml
Kopiera filen allElements.xml från
org.eclipse.pde.build/templates/headless-build till konfigurationskatalogen. Det här är den fil som meddelar PDE vilken funktion du bygger. Den här filen innehåller två typer av mål allElementsDelegator
som anger den funktion som skapas och de byggmål som anropas för bygge av enskilda konfigurationer.
allElementsDelegator för en funktion med namnet org.foo.Feature
är:
<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
Med hjälp av byggmål kan du kontrollera namnet på det slutliga arkivet per konfiguration. Du bör ha ett mål för varje konfiguration du bygger. När du till exempel bygger org.foo.Feature
för Windows (när configs har värdet win32, win32, x86) bör du använda följande mål:
<!--Mål för bygge os=win32, ws=win32, arch=x86 -->
<target name="assemble.org.foo.Feature.win32.win32.x86">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}/">
</target>
När du bygger en plattformsoberoende konfiguration (när configs inte har något värde eller värdet *,*,*) bör du använda ett mål liknande det följande:
<!--Det plattformsoberoende byggmålet-->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>
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:
-buildfile=</path/to/build.xml>
: Det här är sökvägen till build.xml som tillhandahålls av PDE-bygget. Den finns i katalogen org.eclipse.pde.build/scripts. Det här är den byggfil som driver hela byggprocessen.
-Dbuilder=</path/to/configuration folder>
:
Det här är sökvägen till mappen för byggkonfigurationen.
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/build.xml>
-Dbuilder=<sökvägen till mappen för byggkonfigurationen>
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 scenarion
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.