Vlastnosti konfigurace sestavení funkce a modulu plug-in
Mechanizmus sestavení se řídí konfigurací sestavení. Konfigurace sestavení
pro jednotlivý modul plug-in, fragment nebo funkci se nachází v souboru
build.properties pro příslušný prvek.
Průvodci vytvořením projektu prostředí PDE generují soubor build.properties
při vytváření projektů modulů plug-in. Soubor obsahuje informace o tom, jak zkompilovat
zdrojové složky do souborů JAR. Tyto informace lze nepřímo aktualizovat na stránce
Běhové prostředí v editoru souborů typu manifest. Lze je také upravovat přímo pomocí příslušného editoru.
Prostředí PDE poskytuje pro build.properties jednoduchý editor, který má pohledy formuláře a zdroje.
Soubor samotný má formát vlastností prostředí Java. Musíte poskytnout množství klíčů
a jejich odpovídající hodnoty. Více hodnot se odděluje použitím čárky jako oddělovače.
Společné vlastnosti
- bin.includes - Uvádí soubory, které budou zahrnuty v binární verzi sestavovaného modulu plug-in;
- bin.excludes - Uvádí soubory, které se mají vyloučit z binárního sestavení.
- qualifier - Když verze prvku končí znaky .qualifier, označuje, jakou hodnotou se má ".qualifier" nahradit. Hodnotou vlastnosti může být buď context, <hodnota>, nebo none. Hodnota "context" vygeneruje datum podle systémového data, nebo použije značky CVS, pokud je sestavení automatizováno. "Hodnota" je skutečnou hodnotou. Hodnota None odebere příponu ".qualifier". Pokud je vlastnost vynechána, použije se kontext. (Viz Kvalifikátory verzí.)
- custom=true - Označuje, že skript sestavení byl vytvořen ručně, nikoliv generován automaticky. Na žádnou jinou hodnotu se tedy nebere ohled.
- customBuildCallbacks -
označuje soubor xml obsahující vlastní cíle, které se mají použít v případě
použití této funkce/modulu plug-in. (Viz Kroky vlastního sestavení
funkce a modulu plug-in)
- customBuildCallbacks.failonerror -
nastavuje parametry selhání při chybě u úlohy subant. Výchozí nastavení je "false".
- customBuildCallbacks.buildpath -
nastavuje parametry cesty sestavení úlohy subant. Použijte tehdy, když umístění souboru vlastního zpětného volání není
relativní vzhledem ke kořeni modulu plug-in.
- customBuildCallbacks.inheritall - nastavuje vnitřní parametry u úlohy subant. Výchozí nastavení ant je false.
Vlastnosti specifické pro moduly plug-in
- source.<library> - Uvádí zdrojové složky, které budou kompilovány (např. source.xyz.jar=src/, src-ant/). Pokud je knihovna ve vašem souboru plug-in.xml nebo manifest.mf uvedena, hodnota by se měla shodovat.
- output.<library> - Uvádí výstupní složku pro přijetí výsledku kompilace.
- exclude.<library> - Uvádí soubory, které by neměly být kopírovány kompilátorem do knihovny.
- extra.<library> - Další cesty ke třídě použité k provedení automatického sestavení. Cesty ke třídě mohou být buď relativními cestami, nebo adresami URL platformy, které odkazují na moduly plug-in a fragmenty vašeho vývojového prostředí (např. ../someplugin/xyz.jar, platform:/plugins/org.apache.ant/ant.jar).
Adresy URL platformy jsou doporučeny pomocí relativních cest.
- manifest.<library> - Označuje soubor, který bude použit jako soubor typu manifest pro knihovnu. Soubor musí být umístěn v jedné ze zdrojových složek použitých jako vstup pro jar.
- src.includes - Uvádí soubory, které se mají zahrnout do sestavení zdroje.
- src.excludes - Uvádí soubory, které se mají vyloučit ze sestavení zdroje.
- jars.extra.classpath - (Zamítnuté) má stejný vliv jako extra.<library>, s výjimkou toho, že se položky použijí pro všechny knihovny.
- jars.compile.order - Definuje pořadí, v němž se mají soubory JAR sestavit (v případě, že existuje více knihoven).
Volby související s kompilátorem. Viz rovněž stránky Řízení kompilačního prostředí a Volby kompilátoru.
- jre.compilation.profile -
Nastavte Prostředí pro kompilaci tohoto balíku.
- javacSource - Nastavte
úroveň kompatibility zdrojů pro kompilaci tohoto balíku.
Přepíše jre.compilation.profile.
- javacTarget - Nastavte
úroveň kompatibility třídy .class cíle pro kompilaci tohoto balíku.
Přepíše jre.compilation.profile.
- bootClasspath - Nastavte
cestu bootclasspath, dle které se má tento balík zkompilovat, přepíše
jre.compilation.profile.
- javacWarnings.<library>
- Nastavte volby varování, které se mají předat kompilátoru. (Viz volbu -warn v tématu
Použití dávkového kompilátoru
v příručce Java development user guide).
- javacErrors.<library>
- nastavuje volby chyb pro předání kompilátoru. (Viz volbu -err v tématu
Použití dávkového kompilátoru
v příručce Java development user guide).
- javacDefaultEncoding.<library>
- Nastaví výchozí kódování pro použití při kompilování určené knihovny.
- javacCustomEncodings.<library>
- čárkami oddělený seznam
cest a kódování pro použití při kompilování určené knihovny.
Příklad:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-2]
- javacProjectSettings - Relativní cesta k souboru předvoleb, který určuje vlastnosti pro kompilátor JDT. Nastavte hodnotu true, chcete-li použít výchozí ".settings/org.eclipse.jdt.core.prefs".
- compilerArg - zadejte vlastní argumenty kompilátoru
- compilerAdapter - zadejte vlastní adaptér kompilátoru, který má být použit místo výchozího adaptéru org.eclipse.jdt.core.JDTCompilerAdapter
- compilerAdapter.useLog - true/false: zda má nebo nemá vlastní adaptér kompilátoru přijmou argument -log
- compilerAdapter.useArgFile - true/false: zda má nebo nemá vlastní adaptér kompilátoru přijmout vygenerovaný soubor argumentů javaCompiler.<library>.args
- sourceFileExtensions - seznam přípon názvů souborů (*.java, *.aj), které mají být považovány za zdrojové při použití vlastního adaptéru kompilátoru
Hodnoty definované pro klíče končící znaky "includes" nebo "excludes" se vyjadřují jako "vzorky" pro Ant. Standardní formáty poskytují očekávané výsledky. Například, "*.jar" označuje všechny soubory jar v adresáři nejvyšší úrovně. Standardně vzorky nejdou do hloubky. Chcete-li
například popsat všechny soubory Java, měli byste použít vzorek "**/*.java".
Vzorek "**" odpovídá libovolnému počtu úrovní adresářů.
Podobně, chcete-li popsat celé podstromy, použijte "xyz/".
Vlastnosti specifické pro funkce
- root - Uveďte seznam souborů a složek, které musí být obsaženy v kořenovém adresáři produktu. V části Stránka nápovědy pro kořenové soubory najdete více podrobností včetně následujících dalších vlastností:
- root.<config>: pro konfigurační kořenové soubory.
- root.folder: kořenové soubory umístěné v podsložkách.
- root.permissions: provést chmods na kořenových souborech.
- root.link: generovat odkazy softlink pro kořenové soubory.
- root.<config> - Uveďte seznam souborů a složek, které musí být obsaženy v kořenovém adresáři produktu, když se sestavuje pro určenou konfiguraci. Hodnota "config" se skládá ze tří (3) segmentů konfigurace oddělených tečkou.
- root.permissions.<permissionValue> - Uvádí soubory a složky pro chmod pro danou hodnotu. Odkazy na složky musejí končit na a '/'.
- root.permissions.<config>.<permissionValue> - Uvádí soubory a složky pro chmod pro danou hodnotu pro specifickou konfiguraci. Odkazy na složky musejí končit na '/'.
- root.link - Uveďte páry souborů a složek (oddělené čárkou), které se mají symbolicky propojit. První položka označuje zdroj (cíl v terminologii systému unix) a druhá položka název propojení.
- root.link.<config> - Seznam párů souborů a složek oddělených čárkami, které se mají pro specifickou konfiguraci symbolicky propojit. První položka označuje zdroj (cíl v terminologii systému unix) a druhá položka název propojení.
- generate.feature@<featureID> - Označuje, že zdrojová funkce featureId bude zdrojovou funkcí pro funkci, která je zadána jako hodnota této vlastnosti. Hodnoty uvedené za první čárkou
označují prvky, které mají být načteny z úložiště. (Viz Generování zdrojového modulu plug-in a funkce)
- generate.plugin@<pluginId> - Označuje, že modul plug-in pluginId bude zdrojovým modulem plug-in pro ty, co jsou uvedeny jako hodnota této vlastnosti.
- significantVersionDigits
- Počet důležitých číslic použitých při generování přípon verzí funkce (Viz Kvalifikátory verzí)
- generatedVersionLength -
Délka generované přípony verze funkce.
Následující příklad byl extrahován ze souboru build.properties funkce 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*