Opcje kompilatora
Komponent PDE/Build obsługuje pewną liczbę opcji sterujących kompilatorem dla
poszczególnych wtyczek. Ustawienia dotyczące
poziomów źródła i celu oraz argumentu bootclasspath znajdują się w sekcji
Konfigurowanie środowiska kompilacji.
Ostrzeżenia i błędy
Komponent PDE/Build umożliwia określanie niestandardowych ostrzeżeń i błędów kompilatora w pliku build.properties. Istnieje możliwość ustawienia ich dla poszczególnych bibliotek (pojedyncza
wtyczka może zawierać wiele bibliotek JAR) przy użyciu
właściwości javacWarnings.<biblioteka> i
javacErrors.<biblioteka>. Wartości dla tych właściwości
są podane w sekcji "-warn:..." na stronie Korzystanie z kompilatora wsadowego (dostępnej w podręczniku programowania Java).
Przykład:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Ostrzeżenia i błędy z preferencji projektu
Preferencji projektu JDT można teraz także używać podczas budowania w komponencie PDE/Build. Sam komponent PDE/Build
nie może odczytywać plików preferencji, ale może przekazać je do kompilatora JDT, który jest w
stanie je zinterpretować.
W tym celu wtyczka powinna określać właściwość
javacProjectSettings w swoim pliku build.properties. Właściwa wartość to:
- javacProjectSettings=true: użycie ustawienia projektu określonego w
domyślnym pliku preferencji .settings/org.eclipse.jdt.core.prefs.
- javacProjectSettings=sciezka/do/pliku/jdt.prefs: użycie określonego pliku preferencji.
Niektóre projekty mogą wymagać użycia innych ustawień ostrzeżeń i błędów w obszarze roboczym w
porównaniu do kompilacji inżynierii wersji. Umożliwia to wygodniejsze określanie tych
ustawień w porównaniu z użyciem właściwości javacWarnings.<biblioteka>.
Kodowanie plików
Komponent PDE/Build akceptuje niestandardowe kodowania plików dla poszczególnych bibliotek, folderów lub plików.
- javacDefaultEncoding.<biblioteka>
- umożliwia określenie domyślnego kodowania przy kompilowaniu danej biblioteki.
- javacCustomEncodings.<biblioteka>
- rozdzielona przecinkami lista ścieżek i kodowań do użycia przy kompilowaniu danej biblioteki. Jeśli
określono folder, kodowanie jest używane dla całej zawartości tego folderu. Jeśli określono plik,
kodowanie jest używane tylko dla tego pliku. Przykład:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Niestandardowe argumenty kompilatora
Niestandardowe argumenty kompilatora można teraz określać dla poszczególnych pakunków, używając
właściwości compilerArg w pliku build.properties pakunku. Ta właściwość jest podobna do
właściwości compilerArg w konfiguracji
programu budującego z tym wyjątkiem, że dotyczy tylko pojedynczej wtyczki, a nie wszystkich
wtyczek. Konkretne argumenty w tym miejscu zależą od używanego kompilatora. Argumenty kompilatora
JDT są wymienione tutaj.
Kolejność wykonywania opcji kompilatora
Opcje kompilatora można określać na różne sposoby. Ogólna reguła dotycząca kolejności wykonywania opcji
kompilatora jest następująca:
- Właściwość javacDefaultEncoding.<biblioteka> ma priorytet nad opcją wiersza
komend -encoding określoną przez użytkownika.
- W przypadku opcji ogólnych opcja występująca później w wierszu komend kompilatora przesłania
opcje określone wcześniej. Opcje są udostępniane środowisku JDT w następującej kolejności:
- Właściwość compilerArg z konfiguracji programu budującego. (Wpływa na wszystkie
pakunki).
- Właściwość compilerArg z pliku build.properties tej wtyczki.
- Plik preferencji kompilatora określony przy użyciu właściwości javacProjectSettings.
- Wygenerowany plik argumentów kompilatora
(javaCompiler.<biblioteka>.args) zawierający kodowania pliku, właściwości
javacWarnings i
javacErrors oraz reguły dostępu.
Używanie niestandardowego kompilatora
Pakunek może teraz używać niestandardowego kompilatora przez ustawienie właściwości compilerAdapter. Adapter
określonego kompilatora musi być dostępny w środowisku narzędzia Ant. Domyślnie używany
adapter kompilatora JDT to org.eclipse.jdt.core.JDTCompilerAdapter. Jedną z przyczyn
określania alternatywnego kompilatora może być użycie pakunków Aspect J lub Groovy. W przypadku
pakunków określających niestandardowy adapter kompilatora może być także wymagane określenie
niektórych z następujących właściwości:
- sourceFileExtensions: lista rozszerzeń plików, które mają być traktowane jako źródła. (Na
przykład *.java, *.aj, *.groovy).
- compilerAdapter.useLog: umożliwia określenie, czy parametr -log jest przekazywany do
kompilatora.
- compilerAdapter.useArgFile: umożliwia określenie, czy przekazywany jest
wygenerowany plik argumentów javaCompiler.<biblioteka>.args. (Zawiera reguły dostępu,
kodowania plików oraz poziomy ostrzeżeń i błędów).