Byg funktioner
PDE Build leveres med infrastruktur til at automatisere bygning af funktioner.
Det meste af den nødvendige konfiguration til bygning kan udføres med nogle få ændringer til skabelonen build.properties, som følger med
PDE Build. Det følgende afsnit koncentrerer sig om at konfigurere en enkelt bygning, idet det antages, at alle de plugins og funktioner (både dem, der skal bygges, og dem, der er bygget), der henvises til fra den funktion, som bygges, 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".
Funktionsfolderen vil indeholde den funktion, der bygges.
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:
- baseLocation: Placeringen af en
eclipse-installation med alle de forudbyggede funktioner i underbibliotekerne
features/ og plugins/.
- baseos: Angiv styresystemet for den
eclipse, som er angivet af baseLocation.
- basews: Angiv vinduessystem for den
eclipse, som er angivet af baseLocation.
- basearch: Angiv arkitekturen for den
eclipse, som er angivet af baseLocation.
- buildDirectory:
Det bibliotek, der skal bygges i. Angiv dette til den fuldstændige sti til det byggebibliotek, som du tidligere har angivet.
- configs: Angiv en liste over de konfigurationer, som funktionen skal bygges til. Du kan slette kommentarerne for de angivne konfigurationer (vær forsigtig med linjefortsættelser). Hvis den funktion, du bygger, er platformsuafhængig, behøver du ikke at angive egenskaben, eller den kan angives til *,*,*.
- archivePrefix:
Navnet på det bibliotek, hvor funktionen skal pakkes ud på disken.
Kontrollér, hvad der bygges: allElements.xml
Kopiér filen allElements.xml fra org.eclipse.pde.build/templates/headless-build til konfigurationsbiblioteket. Dette er den fil, der fortæller PDE, hvilken funktion du bygger. Filen indeholder to typer af mål: allElementsDelegator, som angiver den funktion, der bygges, og samlingsmålene, der kaldes for at samle individuelle konfigurationer.
Dette er allElementsDelegator til en funktion med navnet org.foo.Feature
:
<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
Samlingsmålene gør det muligt at kontrollere navnet på det endelige arkiv for hver konfiguration. Du bør have et mål til hver konfiguration, som du bygger. Når du f.eks. bygger
org.foo.Feature
til Windows (når configs er angivet til win32, win32, x86), bør du have følgende mål:
<!--Mål til samling styresystem=win32, vinduessystem=win32, arkitektur=x86 -->
<target name="assemble.org.foo.Feature.win32.win32.x86">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}/">
</target>
Ved bygning af en platformsuafhængig konfiguration (når configs ikke er angivet eller er angivet til *,*,*) bør du angive et mål som følger:
<!--Platformsuafhængigt samlingsmål-->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>
Udfør bygningen
For at udføre bygningen skal du benytte programmet org.elipse.ant.core.antRunner. Når eclipse startes med dette program for at bygge, skal du angive to argumenter på kommandolinjen:
-buildfile=</sti/til/bygning.xml>
: Dette er stien til den build.xml-fil, som følger med PDE Build. Filen findes i biblioteket org.eclipse.pde.build/scripts. Dette er den byggefil, der driver hele byggeprocessen.
-Dbuilder=</sti/til/Konfigurationsfolder>
:
Dette er stien til byggekonfigurationsfolderen.
Udfør programmet antRunner med følgende kommando:
java -jar
<eclipseInstall>/startup.jar
-application org.eclipse.ant.core.antRunner -buildfile
<<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml>
-Dbuilder=<sti til byggekonfigurationsfolderen>
Når bygningen er færdig, finder du resultatet i byggebiblioteket i folderen I.TestBuild (navnet kan konfigureres ved indstilling af egenskaben buildLabel).
Avancerede scenarier
Hvis du har brug for at konfigurere byggeprocessen yderligere, f.eks. hente fra et opbevaringssted, kan du finde flere oplysninger under Avancerede
PDE Build-emner.