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 finnes i 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
Det første
trinnet i oppsettet av en bygging er å opprette katalogen der byggingen skal
finne sted. Denne katalogen
blir kalt byggekatalogen, og den skal inneholde plugin-modulene og funksjonene som skal bygges, i tillegg til
alle de genererte artefaktene.
Deretter
kopierer du plugin-modulene og funksjonene henholdsvis til
underkatalogene "plugins" og "features".
Det forventes
at features-mappen inneholder funksjonen som blir bygd.
Det andre trinnet
i oppsettet av en bygging, er å kopiere malen build.properties file fra org.eclipse.pde.build/templates/headless-build
til en ny katalog som skal være katalogen for byggekonfigurasjonen (også kalt
konfigurasjonskatalogen). Rediger den
kopierte build.properties-filen, og definer disse egenskapene:
- baseLocation:
Plasseringen av en Eclipse-installasjon som inneholder alle de forhåndsbygde funksjonene og plugin-modulene
i underkatalogene features/ og plugins/.
- baseos:
Oppgi operativsystemet for Eclipse, som oppgitt av baseLocation.
- basews:
Oppgi vindussystemet for Eclipse, som oppgitt av baseLocation.
- basearch:
Oppgi arch for Eclipse, som oppgitt av baseLocation.
- buildDirectory:
Katalogen som byggingen vil finne sted i. Definer denne
til den fullstendige banen for byggekatalogen som ble opprettet tidligere.
- configs:
Viser konfigurasjonene som funksjonen skal bygges for. Du kan oppheve
kommentaren for konfigurasjonen(e) som er oppgitt (pass på linjefortsettelsene). Hvis funksjonen
du bygger er plattformuavhengig, er det ikke nødvendig å definere denne egenskapen, eller den kan
defineres til *,*,*.
- archivePrefix:
Navnet på katalogen der funksjonen skal pakkes ut på disken.
Styre hva som skal bygges: allElements.xml
Kopier filen allElements.xml
fra org.eclipse.pde.build/templates/headless-build til konfigurasjonskatalogen. Dette er filen
som forteller PDE hvilken funksjon du bygger. Denne filen inneholder
to typer mål: allElementsDelegator
som oppgir funksjonen som blir bygd, og assembleringsmålene som det sendes kall til for å
assemblere individuelle konfigurasjoner. allElementsDelegator for
en funksjon kalt org.foo.Feature
er:
<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
Med assembleringsmålene
kan du styre navnet på det endelige arkivet per konfigurasjon. Du bør ha
ett mål for hver konfigurasjon du bygger. Når du
for eksempel bygger org.foo.Feature
for Windows (når configs er definert til win32, win32, x86), må du ha det følgende målet:
<!--Target for assembling 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 plattformuavhengig konfigurasjon (når configs ikke er definert eller er definert til
*,*,*), bør du ha et mål som dette:
<!--The platform independent assemble target-->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>
Kjøre byggingen
Når du
skal kjøre byggingen, bruker du applikasjonen org.elipse.ant.core.antRunner. Når du
aktiverer Eclipse med denne applikasjonen for å utføre en bygging, må du definere to
argumenter på kommandolinjen:
-buildfile=</path/to/build.xml>
:
Dette er banen til build.xml som er oppgitt av PDE Build. Den ligger i
katalogen org.eclipse.pde.build/scripts. Dette er
byggefilen som driver hele byggeprosessen.
-Dbuilder=</path/to/configuration folder>
:
Dette er banen til byggekonfigurasjonsmappen.
Kjør antRunner-applikasjonen med denne kommandoen:
java -jar
<eclipseInstall>/startup.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.