Volby kompilátoru
PDE/sestavení podporuje řadu voleb pro řízení kompilátoru pro jednotlivé moduly plug-in. Nastavení související se zdrojovou a cílovou úrovní a cestou Bootclasspath viz téma "Nastavení kompilačního prostředí".
Varování a chyby
PDE/sestavení umožňuje určení vlastních varování a chyb kompilace v souboru build.properties. Tato nastavení mohou být nastavena vždy pro jednu knihovnu (jeden modul plug-in může
obsahovat více knihoven souborů JAR) s volbami javacWarnings.<library> a javacErrors.<library>. Hodnoty těchto vlastností jsou uvedeny v sekci "-warn:..." na stránce Použití dávkového kompilátoru (v uživatelské příručce pro vývoj v jazyce Java).
Příklad:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Varování a chyby z předvoleb projektu
Předvolby projektu JDT lze nyní použít také v průběhu PDE/sestavení. PDE/sestavení samo nemůže číst soubory předvoleb, ale může je předávat kompilátoru JDT, který jim rozumí. Chcete-li tento postup použít, modul plug-in by měl určovat vlastnost javacProjectSettings ve svém souboru build.properties. Hodnota by měla být následující:
- javacProjectSettings=true: Použít nastavení projektu určené ve výchozím souboru předvoleb .settings/org.eclipse.jdt.core.prefs.
- javacProjectSettings=path/to/jdt.prefs: Použít určený soubor předvoleb.
Některé projekty mohou vyžadovat použití jiných nastavení varování a chyb v pracovním prostoru oproti sestavení releng. To poskytuje vhodnější metodu určování těchto nastavení
v porovnání s vlastností "javacWarnings.<library>". Kódování souboru
PDE/sestavení může přijmout přizpůsobené kódování souborů vždy pro jednu knihovnu, složku nebo soubor.
- 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ři určování složky se kódování používá pro vše, co je v této složce obsaženo. Při určování souboru se kódování používá pouze pro tento soubor.
Příklad:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-2]
Vlastní argumenty kompilátoru
Vlastní argumenty kompilátoru lze nyní určovat pro každý balík pomocí vlastnosti compilerArg v souboru vlastností balíku: build.properties. Tato vlastnost je podobná vlastnosti compilerArg v konfiguraci tvůrce, s výjimkou toho, že ovlivňuje pouze jeden modul plug-in namísto všech modulů plug-in. Specifické argumenty zde závisejí na použitém kompilátoru. Argumenty
kompilátoru JDT jsou uvedeny zde. Priorita voleb kompilátoru
Existuje řada různých způsobů určení různých voleb
kompilátoru. Priorita voleb se řídí tímto obecným pravidlem:
- Volba javacDefaultEncoding.<library> má
prioritu před vlastní volbou příkazového řádku -encoding.
- V případě obecných voleb platí, že volba zobrazená
později na příkazovém řádku kompilátoru potlačí volby
určené dříve. Volby jsou poskytovány JDT v následujícím pořadí:
- Vlastnost compilerArg z konfigurace tvůrce. (Ovlivňuje
všechny balíky).
- Vlastnost compilerArg z tohoto souboru
modulu plug-in: build.properties.
- Soubor předvoleb kompilátoru určený pomocí nastavení
javacProjectSettings.
- Vygenerovaný soubor argumentů kompilátoru
(javaCompiler.<library>.args) obsahující
kódování souboru, varování javacWarnings,
chyby javacErrors a přístupová pravidla.
Použití vlastního kompilátoru
Balík může nyní použít vlastní kompilátor, je-li
nastavena vlastnost compilerAdapter. Určený
adaptér kompilátoru musí být dostupný v prostředí Ant. Standardně
používaný adaptér kompilátoru JDT je
org.eclipse.jdt.core.JDTCompilerAdapter. Jednou
konkrétní příčinou pro určení jiného kompilátoru jsou balíky Aspect J nebo Groovy. Balíky
určující vlastní adaptér kompilátoru mohou také
vyžadovat určení některé z těchto vlastností:
- sourceFileExtensions: Seznam přípon, které mají
být považovány za zdroje. (Například *.java, *.aj,
*.groovy atd.).
- compilerAdapter.useLog: Zda se má nebo nemá předat
argument "-log" kompilátoru.
- compilerAdapter.useArgFile: Zda se má nebo
nemá předat vygenerovaný soubor argumentů
javaCompiler.<library>.args. (Obsahuje přístupová
pravidla, kódování souborů a úrovně varování/chyb).