Byggkonfigurationsegenskaper för funktioner och insticksprogram
Byggmekanismen styrs av en byggkonfiguration. Byggkonfigurationen för ett enskilt insticksprogram, fragment eller funktion finns i en build.properties-fil för motsvarande element.
Guider för att skapa projekt i PDE genererar filen build.properties när projekt för insticksprogram skapas. Filen innehåller information om hur källmappar kompileras till JAR-filer. Den här informationen kan uppdateras indirekt på sidan Runtime i manifestredigeraren. Den kan också modifieras direkt med lämplig redigerare.
PDE tillhandahåller en enkel redigerare för build.properties som har format- och källvy.
Själva filen följer Java-egenskapsformatet. Du behöver tillhandahålla ett antal nycklar och deras motsvarande värden. Flera värden separeras med komma som avgränsare.
Gemensamma egenskaper
- bin.includes - anger filer som kommer att tas med i den binära versionen av det insticksprogram som byggs;
- bin.excludes - anger filer som inte ska tas med i det binära bygget;
- qualifier - när elementversionsnumret slutar med .qualifier anger det med vilket värde ".qualifier" ska ersättas. Värdet för egenskapen kan antingen vara context, <value> eller none.
Context genererar ett datum enligt systemdatumet, eller använder CVS-märkorden när bygget är automatiserat. Värdet är ett faktiskt värde. None tar bort ".qualifier". Om egenskapen utelämnas används context.
- custom=true - anger att byggskriptet skapats manuellt i motsats till genererats automatiskt. Därför konsulteras inget annat värde.
- customBuildCallbacks -
anger en xml-fil som innehåller anpassade mål som ska användas när den här funktionen/insticksprogrammet används. (Se Steg vid anpassat bygge av funktioner och insticksprogram)
Specifika egenskaper för insticksprogram
- source.<library> - anger källmappar som kommer att kompileras (t.ex. source.xyz.jar=src/, src-ant/).
Om biblioteket anges i plug-in.xml eller manifest.mf ska värdet matcha det;
- output.<library> - anger den utdatamapp som tar emot resultatet av kompileringen;
- exclude.<library> - anger de filer som inte ska kopieras till biblioteket av kompilatorn;
- extra.<library> - extra klassökvägar som används till att utföra automatiserat bygge. Klassökväg kan antingen vara relativa sökvägar eller plattforms-URL-adresser som refererar till insticksprogram och fragment i utvecklingsmiljön (t.ex. ../someplugin/xyz.jar, platform:/plugins/org.apache.ant/ant.jar).
Plattforms-URL-adresser rekommenderas framför relativa sökvägar;
- manifest.<library> - anger den fil som kommer att användas som manifest för biblioteket. Filen måste finnas i en av de källmappar som används som indata för JAR-filen.
- src.includes - anger filer som ska tas med i källbygget;
- src.excludes - anger filer som inte ska tas med i källbygget;
- jars.extra.classpath - (utkommenterad) samma effekt som extra.<library> utom att posterna tillämpas på alla bibliotek;
- jars.compile.order - definierar vilken ordning JAR-filer ska kompileras i (om det finns flera bibliotek).
- jre.compilation.profile -
ange den miljö som används för att kompilera det här paketet. (Se Kontrollera kompileringsmiljön)
- javacSource - ange källkompatibilitetsnivå för kompilering av det här paketet. Åsidosätter
jre.compilation.profile.
- javacTarget - ange målkompatibilitetsnivå .class för kompilering av det här samlingspaketet. Åsidosätter
jre.compilation.profile.
- bootClasspath - ange
boot-klassökvägen som paketet ska kompileras mot, åsidosätter
jre.compilation.profile.
- javacWarnings.<library>
- ange varningsalternativ som ska skickas till kompilatorn. (Se alternativet -warn
i Kompilera
Java-kod i utvecklarguiden för JDT-insticksprogram).
- javacDefaultEncoding.<library>
- anger standardkodning som ska användas vid kompilering av det aktuella biblioteket.
- javacCustomEncodings.<library>
- en kommaavgränsad lista med sökvägar och kodningar som ska användas vid kompilering av det aktuella biblioteket.
Exempel:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
De värden som definieras för de här nycklarna som slutar med "includes" eller "excludes" uttrycks som "patterns" för Ant. Standardformat ger förväntade resultat. Exempelvis indikerar "*.jar" alla jar-filer i toppnivåkatalogen. Mönstren är inte djupa som standard. Om du t.ex. vill beskriva alla
Java-filer ska du använda mönstret "**/*.java".
Mönstret "**" matchar valfritt antal katalognivåer.
På samma sätt använder du "xyz/" om du vill beskriva hela underträd.
Funktionsspecifika egenskaper
- root - ange de filer och mappar som måste tas med i roten för produkten. De olika värdena som kan användas är:
- <folderName> - en relativ sökväg till en mapp som ska kopieras:
- <fileName> - en relativ sökväg till en fil som ska kopieras:
- absolute:<folderName> - en absolut sökväg till en mapp som ska kopieras:
- absolute:file:<fileName> - en absolut sökväg till en fil som ska kopieras:
- root.<config> - ange de filer och mappar som måste tas med i roten för produkten när den byggs för den angivna konfigurationen. config består av de tre (3) segmenten för en konfiguration separerade med punkt;
- root.permissions.<permissionValue> - anger filer och mappar där chmod ska köras till givet värde. Referensen till mapparna måste sluta med '/';
- root.permissions.<config>.<permissionValue> - anger filer och mappar där chmod ska köras till givet värde för en viss konfiguration. Referensen till mapparna måste sluta med '/';
- root.link - ange (separerat med komma) i par de filer och mappar som behöver länkas symboliskt. Den första posten anger källan (målet med Unix-terminologi) och den andra länknamnet;
- root.link.<config> - en kommaseparerad lista över par med filer och mappar som behöver länkas symboliskt för en viss konfiguration. Den första posten anger källan (målet med Unix-terminologi) och den andra länknamnet;
- generate.feature@<featureId> - anger att källfunktionen featureId kommer att vara källfunktionen för den funktion som anges som värdet för den här egenskapen. De värden som anges efter det första kommat anger element som ska hämtas från lagret; (Se Källinsticksprogram och Funktionsgenerering)
- generate.plugin@<pluginId> - anger att källinsticksprogrammet pluginId kommer att vara källinsticksprogrammet för det insticksprogram som anges som värdet för den här egenskapen.
- significantVersionDigits
- Antalet signifikanta siffror som används vid generering av funktionsversionssuffix (Se Versionskvalificerare)
- generatedVersionLength -
Längden på det genererade funktionsversionssuffixet.
Följande exempel har extraherats från build.properties för funktionen org.eclipse.platform.
bin.includes=epl-v10.html,eclipse_update_120.jpg,feature.xml,feature.properties,license.html
root=rootfiles,file:../../plugins/org.eclipse.platform/startup.jar,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*