Опции компилятора
PDE/Компоновка поддерживает несколько опций компилятора,
позволяющих управлять отдельными модулями. Параметры, относящиеся
к исходному и целевому уровням и bootclasspath, описаны в разделе
"Задание среды компиляции".
Предупреждения и ошибки
PDE/Компоновка позволяет задавать нестандартные предупреждения
и ошибки компиляции в файле build.properties. Их можно задать по
библиотекам (один модуль может содержать несколько библиотек jar)
с опциями javacWarnings.<библиотека> и
javacErrors.<библиотека>. Значения этих свойств
указаны в разделе "-warn:..." страницы Работа с пакетным компилятором (в Руководстве пользователя по разработке на Java).
Пример:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Предупреждения и ошибки из ссылок проекта
Ссылки проекта JDT теперь также могут использоваться во время
PDE/Компоновки. Сама PDE/Компоновка не может считывать файлы
ссылок, но она может передать их компилятору JDT, который
распознает их.
Для этого модуль должен задавать свойство
javacProjectSettings в своем файле build.properties. Значение должно быть следующим:
- javacProjectSettings=true: использовать
значение проекта, указанное в файле параметров
.settings/org.eclipse.jdt.core.prefs по умолчанию.
- javacProjectSettings=path/to/jdt.prefs:
использовать указанный файл параметров.
Некоторые проекты могут использовать другие параметры
предупреждений и ошибок в рабочей области, по сравнению с
компоновкой releng. Это позволяет удобнее задавать эти параметры,
по сравнению со свойством "javacWarnings.<библиотека>".
Кодировка файлов
PDE/Компоновка может принимать нестандартные кодировки файлов,
действующие в пределах библиотеки, папки или файла.
- javacDefaultEncoding.<библиотека>
- кодировка по умолчанию для компиляции библиотеки.
- javacCustomEncodings.<библиотека>
- список путей и кодировок через запятую для компиляции
библиотеки. При указании папки кодировка распространяется на все
содержимое этой папки. При указании файла кодировка
распространяется только на этот файл. Пример:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Нестандартные аргументы компилятора
Нестандартные аргументы компилятора теперь можно указывать и для
комплекта. Для этого служит свойство compilerArg в файле
build.properties комплекта. Это свойство аналогично свойству
compilerArg в
конфигурации компоновщика, за исключением того, что оно влияет
лишь на отдельный модуль, а не на все модули. Конкретные
аргументы зависят от применяемого компилятора. Аргументы
компилятора JDT перечислены
здесь.
Приоритет опций компилятора
Опции компилятора можно задавать по-разному. В общем случае,
приоритет опций следующий:
- javacDefaultEncoding.<библиотека> имеет приоритет над
нестандартной опцией -encoding командной строки.
- В случае обычных опций, последующая опция переопределяет
предыдущую в командной строке компилятора. Опции передаются в JDT
в следующем порядке:
- Свойство compilerArg из конфигурации компоновщика. (Влияет на все комплекты).
- Свойство compilerArg из файла build.properties этого
модуля.
- Файл параметров компилятора, указанный с
javacProjectSettings.
- Созданный файл аргументов компилятора
(javaCompiler.<библиотека>.args), содержащий кодировки
файлов, javacWarnings, javacErrors и правила
доступа.
Работа с нестандартным компилятором
Комплект теперь может использовать нестандартный компилятор. Для
этого нужно задать свойство compilerAdapter. Указанный
адаптер компилятора должен существовать в среде ant. По умолчанию
используется адаптер компилятора JDT
org.eclipse.jdt.core.JDTCompilerAdapter. Одна из возможных
причин применения альтернативного компилятора - комплекты Aspect
J и Groovy. Для комплекта, указывающего нестандартный адаптер
компилятора, может потребоваться задать также некоторые из
следующих свойств:
- sourceFileExtensions: список расширений, которые
должны считаться исходными. (например, *.java, *.aj, *.groovy).
- compilerAdapter.useLog: указывает, следует ли
передавать компилятору аргумент "-log"
- compilerAdapter.useArgFile: указывает, следует ли
передавать созданный файл аргументов
javaCompiler.<библиотека>.args. (Содержит правила доступа,
кодировки файлов и уровни предупреждений и ошибок).