Egenskaber for byggekonfiguration til funktioner og plugins
Byggemekanismen styres af en byggekonfiguration. Byggekonfigurationen til individuelle plugins, fragmenter eller funktioner findes i en fil, der hedder build.properties og hører til det tilsvarende element.
Guider til PDE-projektoprettelse genererer filen build.properties, når plugin-projekter oprettes. Filen indeholder oplysninger om, hvordan kildefoldere kompileres til JARs. Disse oplysninger kan opdateres indirekte på Runtime-siden til manifesteditoren. De kan også ændres direkte vha. den relevante editor.
PDE er en enkel editor til de build.properties, der indeholder format- og kildeoversigter.
Selve filen overholder formatet for Java-egenskaber. Du skal angive et antal taster og de tilhørende værdier. Flere værdier adskilles ved et komma.
Generelle egenskaber
- bin.includes - viser filer, der bliver inkluderet i den binære version af den plugin, der bygges.
- bin.excludes - viser filer, der ekskluderes fra den binære bygning.
- qualifier - når elementets versionsnummer ender med .qualifier, angiver det, hvilken værdi ".qualifier" skal erstattes af. Værdien for egenskaben kan enten være context, <value> eller none. Værdien 'context' genererer en dato i henhold til systemdatoen eller bruger CVS-koder, når bygningen foregår automatisk. Værdien 'value' er en faktisk værdi. Ved 'ingen' fjernes ".qualifier". Hvis egenskaben udelades, bruges 'context'. Se Versionskvalifikatorer.
- custom=true - angiver, at byggekommandofilen er manuelt udformet i modsætning til automatisk genereret. Derfor anvendes ingen andre værdier.
- customBuildCallbacks - angiver en XML-fil med tilpassede mål, der skal bruges, når denne funktion/plugin bruges. (Se Tilpas bygning af funktioner og plugin)
- customBuildCallbacks.failonerror - angiver parameteren failonerror for ant-underopgaven. Standardværdien er "false".
- customBuildCallbacks.buildpath - angiver parameteren buildpath for ant-underopgaven. Bruges når placeringen af den tilpassede callback-fil ikke er relativ i forhold til plugin-roden.
- customBuildCallbacks.inheritall - angiver parameteren inheritall for ant-underopgaven. Ants standardværdi er false.
Plugin-specifikke egenskaber
- source.<library> - viser de kildefoldere, der bliver kompileret (f.eks. source.xyz.jar=src/, src-ant/). Hvis biblioteket angives i plug-in.xml eller manifest.mf, skal værdien matche det.
- output.<library> - viser, hvilken outputfolder der modtager resultatet af kompileringen.
- exclude.<library> - viser de filer, compileren ikke skal kopiere til biblioteket.
- extra.<library> - ekstra CLASSPATHS, som bruges til at udføre automatiske bygninger. CLASSPATHs kan enten være relative stier eller platform-URL'er, der refererer til plugins og fragmenter i udviklingsmiljøet (f.eks. ../someplugin/xyz.jar, platform:/plugins/org.apache.ant/ant.jar).
Platform-URL'er anbefales frem for relative stier.
- manifest.<library> - angiver, hvilken fil der skal bruges som manifest for biblioteket. Filen skal være placeret i en af de kildefoldere, der bruges som input for JAR.
- src.includes - viser filer, der skal inkluderes i kildebygningen.
- src.excludes - viser filer, der skal ekskluderes fra kildebygningen.
- jars.extra.classpath - (forældet) samme virkning som extra.<library>, bortset fra at indgangene anvendes på alle biblioteker.
- jars.compile.order - definerer den rækkefølge, JARs skal kompileres i (i tilfælde af flere biblioteker).
Compilerrelaterede indstillinger. Se også siderne Angiv kompileringsmiljøet og Compilerindstillinger.
- jre.compilation.profile - angiv det miljø, der bruges til at kompilere dette bundt.
- javacSource - angiv det kildekompatibilitetsniveau, der skal gælde for kompileringen af bundtet. Tilsidesætter jre.compilation.profile.
- javacTarget - angiv det målkompatibilitetsniveau for .class, der skal gælde for kompileringen af bundtet. Tilsidesætter jre.compilation.profile.
- bootClasspath - Angiv den bootclasspath, bundtet skal kompileres mod. Tilsidesætter
jre.compilation.profile.
- javacWarnings.<bibliotek>
- angiv de advarselsparametre, der skal overføres til compileren. Se indstillingen -warn i Brug batch-compileren i brugervejledningen til Java-udvikling.
- javacErrors.<library>
- angiv de fejlindstillinger, der skal overføres til compileren. Se indstillingen -err i Brug batch-compileren i brugervejledningen til Java-udvikling.
- javacDefaultEncoding.<bibliotek>
- angiver den standardkodning, der skal bruges ved kompilering af det angivne bibliotek.
- javacCustomEncodings.<bibliotek>
- en kommasepareret liste over stier og kodninger, der skal bruges ved kompilering af det angivne bibliotek. Eksempel:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
- javacProjectSettings - en relativ sti til en indstillingsfil, der angiver indstillinger for JDT-compileren. Angiv til true for at bruge standardindstillingen ".settings/org.eclipse.jdt.core.prefs".
- compilerArg - angiv tilpassede compilerargumenter
- compilerAdapter - angiv en tilpasset compileradapter, der skal bruges i stedet for standarden, org.eclipse.jdt.core.JDTCompilerAdapter
- compilerAdapter.useLog - true/false: angiv, om den tilpassede compileradapter skal modtage argumentet -log.
- compilerAdapter.useArgFile - true/false: angiv, om den tilpassede compileradapter skal modtage den genererede javaCompiler.<library>.args-argumentfil.
- sourceFileExtensions - en liste over udvidelser (*.java, *.aj), der skal betragtes som kilde, når der bruges en tilpasset compileradapter.
De værdier, der er defineret for disse taster, og som ender på "includes" eller "excludes", udtrykkes som Ant-"mønstre". Standardformater giver de forventede resultater. For eksempel angiver "*.jar" alle JAR-filer i det øverste bibliotek. Mønstrene er som standard ikke dybe. Hvis du f.eks. vil beskrive alle Java-filer, skal du bruges mønstret "**/*.java".
Mønstret "**" matcher et vilkårligt antal biblioteksniveauer. Tilsvarende gælder, at du for at beskrive hele underordnede trækstrukturer skal bruge "xyz/".
Funktionsspecifikke egenskaber
- root - viser de filer og foldere, der skal inkluderes i roden til produktet. Der er flere oplysninger på hjælpesiden vedrørende rodfiler, herunder følgende yderligere egenskaber:
- root.<config>: rodfiler pr. konfiguration.
- root.folder: rodfiler placeret i underfoldere.
- root.permissions: revidér tilladelser for rodfiler.
- root.link: generér symbolske link til rodfiler.
- root.<config> - viser de filer og foldere, der skal inkluderes i roden til produktet, når de bygges til den angivne konfiguration. 'config' består af de tre (3) segmenter i en konfiguration, adskilt ved punktum.
- root.permissions.<permissionValue> - viser de filer og foldere, der skal udføres 'chmod' af til den givne værdi. Referencen til folderne skal slutte med '/';
- root.permissions.<config>.<permissionValue> - viser de filer og foldere, der skal udføres 'chmod' af til den givne værdi for en bestemt konfiguration. Referencen til folderne skal slutte med '/';
- root.link - viser, adskilt ved kommaer og inddelt parvist, de filer og foldere, der skal sammenkædes symbolsk. Den første indgang angiver kilden (målet i Unix-terminologi), og den anden indgang angiver linknavnet.
- root.link.<config> - en liste over parvist opstillede filer og foldere, adskilt ved komma, som skal sammenkædes symbolsk til en bestemt konfiguration. Den første indgang angiver kilden (målet i Unix-terminologi), og den anden indgang angiver linknavnet.
- generate.feature@<featureId> - angiver, at kildefunktionen featureId skal være kildefunktion for den funktion, der er angivet som værdien for denne egenskab. Værdierne efter det første komma angiver elementer, der skal hentes vha. fetch fra opbevaringsstedet. (Se Generér kildefunktioner og -plugin)
- generate.plugin@<pluginId> - angiver, at kilde-plugin pluginId skal være kilde-plugin for den værdi, der er angivet for egenskaben.
- significantVersionDigits
- Antallet af betydende cifre, der bruges ved generering af funktionsversionssuffikser (se Versionskvalifikatorer)
- generatedVersionLength -
Længden på det genererede funktionsversionssuffiks.
Følgende eksempel er hentet fra build.properties til funktionen org.eclipse.platform.
bin.includes=epl-v10.html,eclipse_update_120.jpg,feature.xml,feature.properties,license.html
root=rootfiles,configuration/
root.permissions.755=eclipse
root.linux.motif.x86=../../plugins/platform-launcher/bin/linux/motif,linux.motif
root.linux.motif.x86.link=libXm.so.2.1,libXm.so.2,libXm.so.2.1,libXm.so
root.linux.motif.x86.permissions.755=*.so*