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 - filer som ska tas med i den binära versionen av det insticksprogram som byggs
- bin.excludes - 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. (Se Versionskvalificerare.)
- custom=true - byggskriptet skapats manuellt i stället för att genereras automatiskt. Därför beaktas inget annat värde.
- customBuildCallbacks - 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)
- customBuildCallbacks.failonerror -
byggsökvägsparametern för failonerror-parametern. Standardvärdet är "false".
- customBuildCallbacks.buildpath -
byggsökvägsparametern för Ant-deluppgiften. Används när platsen för den anpassade återanropsfilen inte är relativ till insticksprogrammets rot.
- customBuildCallbacks.inheritall -
byggsökvägsparametern för Ant-deluppgiften. Standardvärdet för Ant är "false".
Specifika egenskaper för insticksprogram
- source.<library> - källmappar som ska 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> - den utdatamapp som tar emot resultatet av kompileringen.
- exclude.<library> - 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> - den fil som ska 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 - filer som ska tas med i källbygget.
- src.excludes - filer som inte ska tas med i källbygget.
- jars.extra.classpath - (avvecklat) samma effekt som extra.<library> utom att posterna tillämpas på alla bibliotek.
- jars.compile.order - definierar i vilken ordning JAR-filer ska kompileras i (om det finns flera bibliotek).
Kompilatorrelaterade alternativ. Se även sidorna Styra kompileringsmiljön och Kompilatoralternativ.
- jre.compilation.profile - den miljö som används för kompileringen av paketet.
- javacSource - källkompatibilitetsnivån för kompilering av paketet. Åsidosätter
jre.compilation.profile.
- javacTarget - målkompatibilitetsnivåklassen för kompilering av samlingspaketet. Åsidosätter
jre.compilation.profile.
- bootClasspath - boot-klassökvägen som paketet ska kompileras mot. Åsidosätter
jre.compilation.profile.
- javacWarnings.<library>
- varningsalternativ som ska skickas till kompilatorn. (Se alternativet -warn i Använda batchkompilatorn
i användarhandboken för Java-utveckling).
- javacErrors.<library>
- felalternativ som ska skickas till kompilatorn. (Se alternativet -err i Använda batchkompilatorn
i användarhandboken för Java-utveckling).
- javacDefaultEncoding.<library>
- standardkodning 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]
- javacProjectSettings - en relativ sökväg till en inställningsfil med egenskaper för JDT-kompilatorn. Ange true om du vill använda standarden .settings/org.eclipse.jdt.core.prefs".
- compilerArg - anpassade kompileringsargument
- compilerAdapter - en anpassad kompilatoradapter som ska användas i stället för standardadaptern org.eclipse.jdt.core.JDTCompilerAdapter
- compilerAdapter.useLog - true/false: om den anpassade kompilatoradaptern ska ta emot argumentet -log.
- compilerAdapter.useArgFile - true/false: om den anpassade kompilatoradaptern ska ta emot den genererade argumentfilen javaCompiler.<library>.args.
- sourceFileExtensions - en lista över tillägg (*.java, *.aj) som ska beaktas som källa när en anpassad kompilatoradapter används.
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 - visa en lista med de filer och mappar som måste tas med i roten i en produkt. Se hjälpsidan för rotfiler för mer information, inklusive följande ytterligare egenskaper:
- root.<config>: per konfigurationsrotfiler.
- root.folder : rotfiler placerade i undermappar.
- root.permissions : utför chmods på rotfiler.
- root.link : generera softlinks för rotfiler.
- root.<config> - 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> - filer och mappar där chmod ska köras till givet värde. Referensen till mapparna måste sluta med '/'.
- root.permissions.<config>.<permissionValue> - 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 - filer och mappar som behöver länkas symboliskt. Anges parvis avgränsade av komma. Den första posten anger källan (målet med Unix-terminologi) och den andra länknamnet.
- root.link.<config> - en kommaavgränsad 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> - källfunktionen featureId kommer att vara källfunktionen för den funktion som anges som värdet fö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> - källinsticksprogrammet pluginId kommer att vara källinsticksprogrammet för det insticksprogram som anges som värdet för egenskapen.
- significantVersionDigits
- antalet signifikanta siffror 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,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*