编译器选项
PDE/构建支持使用若干选项来控制个别插件的编译器。有关与源级别和目标级别以及引导类路径的设置的信息,请参阅“设置编译环境”。
警告和错误
PDE/构建允许在 build.properties 文件中指定定制编译警告和错误。可使用 javacWarnings.<library> 和
javacErrors.<library> 选项对每个库设置这些属性(单个插件可包含多个 JAR 库)。使用批处理编译器页面(在“Java 开发用户指南”中)上的“-warn:...”一节中给出了这些属性的值。
示例: javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
项目首选项中的警告和错误
现在还可在 PDE/构建期间使用 JDT 项目首选项。PDE/构建本身无法读取首选项文件,但它能够将这些文件传递至理解它们的 JDT 编译器。
为使用此项,插件应在其 build.properties 文件中指定 javacProjectSettings
属性。该值应该为:
- javacProjectSettings=true:使用在缺省 .settings/org.eclipse.jdt.core.prefs
首选项文件中指定的项目设置。
- javacProjectSettings=path/to/jdt.prefs:使用指定的首选项文件。
某些项目可能希望在工作空间中使用不同警告和错误设置(相对于 releng 构建)。这允许使用更便利的方法来指定这些设置(相对于“javacWarnings.<library>”属性)。
文件编码
PDE/构建可接受针对每个库、文件夹或文件的定制文件编码。
- javacDefaultEncoding.<library> - 设置编译给定库时要使用的缺省编码。
- javacCustomEncodings.<library> - 编译给定库时要使用的路径和编码的逗号分隔列表。指定文件夹时,对该文件夹中包含的所有内容使用该编码。指定文件时,仅对该对象使用该编码。示例:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
定制编译器参数
现在可使用捆绑软件的 build.properties 文件中的 compilerArg 属性对每个捆绑软件指定定制编译器参数。此属性类似构建器配置中的
compilerArg 属性,但此属性仅影响单个插件而不是所有插件。此处的特定参数依赖于正在使用的编译器。JDT
编译器参数列示在此处。
编译器选项优先顺序
有一些不同方式可用来指定不同编译器选项。作为常用规则,选项优先顺序如下所示:
- javacDefaultEncoding.<library> 的优先顺序高于定制 -encoding 命令行选项。
- 对于常规选项,出现在编译器命令行上稍后位置的选项覆盖之前指定的选项。这些选项按以下顺序提供给 JDT:
- 构建器配置中的 compilerArg 属性。(影响所有捆绑软件)。
- 此插件的 build.properties 中的 compilerArg 属性。
- 使用 javacProjectSettings 指定的编译器首选项文件。
- 包含文件编码、javacWarnings、javacErrors
和访问规则的已生成编译器参数文件 (javaCompiler.<library>.args)。
使用定制编译器
现在捆绑软件可通过设置 compilerAdapter 属性来使用定制编译器。指定的编译器适配器必须在 ant 环境中可用。缺省情况下使用的 JDT
编译器适配器是 org.eclipse.jdt.core.JDTCompilerAdapter。指定备用编译器的一个特定原因是用于 Aspect J 或 Groovy
捆绑软件。指定定制编译器适配器的捆绑软件可能还需要指定以下某些属性:
- sourceFileExtensions:应视为源的扩展列表。(例如,*.java、*.aj 和 *.groovy)。
- compilerAdapter.useLog:是否将“-log”参数传递至编译器
- compilerAdapter.useArgFile:是否传递生成的 javaCompiler.<library>.args 参数文件。(包含访问规则、文件编码和警告/错误级别)。