Kääntäjän asetukset
PDE/koonti tukee useita asetuksia, joilla voidaan ohjata yksittäisten lisäosien kääntäjää. Lähde- ja kohdetasoihin ja
aloitusluokkapolkuun liittyvistä asetuksista on lisätietoja kohdassa "Käännösympäristön määritys".
Varoitukset ja virheet
PDE:n/koonnin ansiosta build.properties-tiedostoon voidaan määrittää mukautettuja käännösvaroituksia ja virheitä. Nämä voidaan määrittää kirjastokohtaisesti (yksi lisäosa voi sisältää useita JAR-kirjastoja) asetuksilla javacWarnings.<library> ja javacErrors.<library>. Näiden ominaisuuksien arvot
annetaan annetaan Java-kehityksen käyttäjän oppaassa eräkääntäjän käytöstä kertovan sivun -warn:...-kohdassa.
Esimerkki:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Projektin oletusasetusten varoitukset ja virheet
JDT-projektin oletusasetuksia voidaan käyttää nyt myös PDE:n/koonnin aikana. PDE/koonti ei pysty itse lukemaan oletusasetustiedostoja, mutta se osaa siirtää ne eteenpäin JDT-kääntäjälle, joka ymmärtää niitä.
Tämän toiminnon käyttäminen edellyttää, että javacProjectSettings-ominaisuus määritetään lisäosan build.properties-tiedostossa. Arvon tulee olla:
- javacProjectSettings=true : Käytä projektiasetusta, joka on määritetty oletusarvoisessa .settings/org.eclipse.jdt.core.prefs-oletusasetustiedostossa.
- javacProjectSettings=path/to/jdt.prefs : Käytä määritettyä oletusasetustiedostoa.
Jotkut projektit saattavat haluta käyttää työtilassa releng-koontiversiosta poikkeavia varoitus- ja virheasetuksia työtilassa. Tällä tavoin nämä asetukset voidaan määrittää kätevämmin kuin mitä "javacWarnings.<library>" -ominaisuuden avulla.
Tiedostojen koodaus
PDE/koonti hyväksyy kirjasto-, kansio- tai tiedostokohtaiset mukautetut tiedostojen koodaukset.
- javacDefaultEncoding.<library> - asettaa kirjaston käännöksessä käytettävän oletuskoodauksen.
- javacCustomEncodings.<library> - pilkuin erotettu luettelo kirjaston käännöksessä käytettävistä poluista ja koodauksista. Jos määrität kansion, koodausta käytetään kansion koko sisältöön. Jos määrität tiedoston, koodausta käytetään vain kyseiseen tiedostoon. Esimerkki:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Mukautetut kääntäjän argumentit
Mukautettuja kääntäjän argumentteja voidaan määrittää nyt resurssijoukkokohtaisesti käyttämällä resurssijoukon build.properties-tiedoston compilerArg-ominaisuutta. Tämä ominaisuus on samankaltainen kuin koontitoiminnon kokoonpanon
compilerArg-ominaisuus, mutta se vaikuttaa kaikkien lisäosien sijaan vain yhteen lisäosaan. Tämän kohdan argumentit riippuvat käytettävästä kääntäjästä. JDT-kääntäjän argumenttien luettelo on täällä.
Kääntäjän asetusten ensisijaisuusjärjestys
Kääntäjän eri asetuksia voidaan määrittää useilla eri tavoilla. Asetusten ensisijaisuusjärjestys on yleensä seuraava:
- javacDefaultEncoding.<library> on etusijalla mukautettuun -encoding-komentoriviasetukseen nähden.
- Yleiset asetukset: kääntäjän komentorivillä myöhemmin esiintyvä asetus korvaa aiemmat asetukset. Asetukset siirretään JDT:hen seuraavassa järjestyksessä:
- Koontitoiminnon kokoonpanon compilerArg-ominaisuus. (Koskee kaikkia resurssijoukkoja).
- Tämän lisäosan build.properties-tiedoston compilerArg-ominaisuus.
- JavacProjectSettings-asetusten avulla määritetty kääntäjän oletusasetustiedosto.
- Luotu kääntäjän argumenttitiedosto (javaCompiler.<library>.args), joka sisältää tiedostojen koodaukset, javacWarnings-varoitukset, javacErrors-virheet ja saantisäännöt.
Mukautetun kääntäjän käyttäminen
Resurssijoukko voi nyt käyttää mukautettua kääntäjää määrittämällä compilerAdapter-ominaisuuden. Valitun kääntäjän sovittimen on oltava käytettävissä Ant-ympäristössä. Oletusarvoisesti käytettävä JDT-kääntäjän sovitin on
org.eclipse.jdt.core.JDTCompilerAdapter. Yksi vaihtoehtoisen kääntäjän määrittämisen syistä on Aspect J- tai Groovy-resurssijoukot. Sellaisten resurssijoukkojen, jotka määrittävät mukautetun kääntäjän sovittimen, on määritettävä mahdollisesti myös joitakin seuraavista ominaisuuksista:
- sourceFileExtensions : Lähdetiedostoina pidettävien tiedostojen tiedostopääteluettelo. (esim. *.java, *.aj, *.groovy).
- compilerAdapter.useLog : välitetäänkö "-log"-argumentti kääntäjälle
- compilerAdapter.useArgFile : välitetäänkö luotu javaCompiler.<library>.args -argumenttitiedosto eteenpäin. (Sisältää saantisäännöt, tiedostojen koodaukset ja varoitus-/virhetasot).