整体构建机制是由包含 build.properties 文件的构建器配置驱动的。
| topLevelElementId | 所构建的功能部件的标识。 此属性是 Eclipse 3.4 中的新增属性,并且取决于 Eclipse 3.4 中 allElements.xml 文件的使用。使用较旧样式 customTargets.xml 和/或 allElements.xml 文件的构建配置不应使用此属性。 |
| buildDirectory |
执行构建时要使用的目录。 |
| configs |
要构建的配置列表。配置是用 & 符分隔的列表,此列表的每一部分都是逗号分隔的操作系统、窗口系统和体系结构列表。如果未指定配置,那么将构建独立于平台的配置。示例:configs = win32, win32, x86 & linux, gtk, ppc |
| baseLocation |
目标 Eclipse 安装版本的位置。在缺省模板中,此属性的值是
${base}/eclipse。(请参阅下面的 base 属性)。此目录应该包含 plugins/ 和 features/ 子目录,它们分别包含二进制插件和功能部件。 |
| baseos |
由 baseLocation 指定的 Eclipse 的操作系统 |
| basews |
由 baseLocation 指定的 Eclipse 的窗口系统 |
| basearch |
由 baseLocation 指定的 Eclipse 的体系结构 |
| pluginPath |
用平台路径分隔符分隔的位置列表,用于查找其他插件和功能部件。 |
| skipBase |
如果设置了此属性,那么将自动下载基本 Eclipse 以用作目标 |
| base |
基本 Eclipse 的下载目标位置。此位置应该是
baseLocation 的上层目录,因此,baseLocation = ${base}/eclipse。 |
| eclipseURL |
Eclipse 下载站点的 URL |
| eclipseBuildId |
要下载的 Eclipse 的构建标识 |
| eclipseBaseURL |
要下载的 ZIP 文件的实际 URL。在缺省模板中,值为:eclipseBaseURL = ${eclipseURL}/eclipse-platform-${eclipseBuildId}-win32.zip
|
| filteredDependencyCheck |
对构建期间考虑的插件和功能部件进行限制,使其只包括可以从所构建的功能部件/插件中访问的那些插件和功能部件。 |
| resolution.devMode |
设置为 true 时,对所构建的插件集执行的验证并不严格。例如,将允许解析单一捆绑软件的多个版本。 |
| runPackager |
如果需要运行打包程序,请设置此属性。如果构建结果需要包含来自 baseLocation 的二进制功能部件和插件,请设置此属性。 |
| product |
产品配置文件。如果正在构建产品,请设置此属性。此属性控制构建结果的标记。 |
| archiveNamePrefix |
最终归档文件的名称前缀。当逐个配置地设置归档名称时,在 allElements.xml 中将使用此属性。缺省情况下,值将是
${buildId}。 |
| archivePrefix |
归档根文件夹的名称,对于 Eclipse 构建来说,这是“eclipse”。 |
| buildType | 构建类型。通常,这是 I、N 和 M 之类的内容。 |
| buildLabel | 构建标签。在缺省模板中,值为 ${buildType}.${buildId}。 |
| collectingFolder |
收集构建输出时使用的目标文件夹。在缺省模板中,值为
${archivePrefix}。 |
| groupConfigurations |
确定是否要将所有配置合并到一个归档文件中。 |
| archivesFormat |
所构建的不同配置的归档格式。这是配置及其归档格式的
& 符分隔列表。格式由连字符(-)分隔。示例:archivesFormat = win32, win32, x86 - antzip & linux, gtk, ppc - tar |
| outputUpdateJars |
如果设置了此属性,那么将以 JAR 格式为更新站点生成插件和功能部件。 |
| zipArgs |
当归档格式为 ZIP 时要发送给 ZIP 可执行文件的参数。 |
| tarArgs |
当归档格式为 TAR 时要发送给 TAR 可执行文件的参数。 |
| generateJnlp |
如果设置为 true,那么将生成 JAR 归档的 JNLP 清单。 |
| jnlp.codebase |
站点 URL。此属性值应该是一个 URL,该 URL 将用作输出中所有相对 URL 的根。 |
| jnlp.j2se |
运行所导出的 JNLP 应用程序时所需的 J2SE 版本。 |
| jnlp.locale |
生成 JNLP 文件时应该使用的语言环境。 |
| jnlp.generateOfflineAllowed |
如果设置为 true,那么将在生成的文件中生成 <offlineAllowed/>。 |
| jnlp.configs |
根据所构建的配置,对生成的 JNLP 文件的内容进行过滤。需要列示那些配置。 |
| signJars |
如果设置为 true,那么将对功能部件和插件的 JAR 进行签名。 |
| sign.alias |
传递给 Ant signJar 任务的别名。 |
| sign.keystore |
传递给 Ant signJar 任务的密钥库。 |
| sign.storepass |
传递给 Ant signJar 任务的密钥库密码。 |
| sign.keypass |
传递给 Ant signJar 任务的 Keypass。 |
| forceContextQualifier |
在替换插件版本和功能部件版本中的限定符时,将使用此属性的值。如果设置了此值,那么将使用此值来替代映射文件或时间戳记中的标记。 |
| generateFeatureVersionSuffix |
如果设置为 true,那么将生成功能部件版本后缀。 |
| generateVersionsLists |
如果设置为 true,那么将生成属性文件以列示所构建的功能部件和插件的最终版本号。这将在构建器目录中创建 finalFeaturesVersions.properties 和 finalPluginsVersions.properties 文件。 |
| skipMaps |
如果设置了此属性,那么不要尝试从 CVS 中访存映射文件。 |
| mapsRepo |
要访存的映射文件所在的 CVS 存储库。示例::pserver:anonymous@example.com/path/to/repo |
| mapsRoot |
CVS 存储库中指向映射文件所在目录的路径。 |
| mapsCheckoutTag |
用于检出映射文件的 CVS 标记。 |
| tagMaps |
如果设置为 true,那么将在访存映射文件后对其进行标记。 |
| mapsTagTag |
在访存映射文件后对其进行标记时,将使用此标记。 |
| skipFetch |
如果设置为 true,那么将跳过整个访存阶段。 |
| fetchTag |
在从 CVS 中访存功能部件和插件时要使用的标记。此属性覆盖映射文件中的值。 |
| logExtension |
生成的日志文件的扩展名。仅当使用缺省 JDT 编译器时,此属性才适用。缺省值为“.log”。 |
| javacDebugInfo |
确定是否将调试信息包括在输出 JAR 文件中。此属性将传递给
Ant javac 任务。如果未设置此属性,那么缺省值为 on。 |
| javacFailOnError |
确定在发生编译错误时是否使构建失败。此属性将传递给
Ant javac 任务。如果未设置此属性,那么缺省值为 true。 |
| javacVerbose |
确定是否启用编译器的详细方式。此属性将传递给
Ant javac 任务。如果未设置此属性,那么缺省值为 false。 |
| compilerArg |
设置要直接传递给编译器的特定参数。 |
| javacSource |
当插件未指定任何设置时要使用的 Java 源代码兼容性级别。如果未设置此属性,那么缺省值为 1.3。 |
| javacTarget |
当插件未指定任何设置时要使用的目标 .class 兼容性级别。如果未设置此属性,那么缺省值为 1.2。 |
| flattenDependencies |
对跨越功能部件边界的捆绑软件依赖项执行排序。(另请参阅编译顺序和并行化) |
| parallelCompilation |
如果设置为 true,那么将启用并行编译。(需要 flattenDependencies=true) |
| parallelThreadCount |
要使用的最大线程数。对应于 Ant 并行任务的 threadCount。 |
| parallelThreadsPerProcessor |
每个可用处理器要使用的最大线程数。对应于 Ant 并行任务的 threadsPerProcessor。 |
| bootclasspath |
当插件本身未指定任何设置时要使用的引导类路径。此属性是用平台路径分隔符分隔的
JAR 文件列表。如果未设置此属性,那么将使用与 ${java.home}/jre/lib/*.jar 匹配的文件集。 |
| <执行环境> |
设置每个可用来执行构建的 JRE 的属性。这些属性将与各个捆绑软件所指定的执行环境进行匹配。这些值应该指定使用该环境时编译操作所针对的 JAR 文件。请参阅控制编译环境。 |
| generateAPIDescription |
允许自动生成捆绑软件的 API 描述文件。 |
| generateSourceReferences | 允许在捆绑软件清单中生成 Eclipse-SourceReferences 头。 |