控制构建输出格式
本节描述如何控制功能部件或产品的构建输出。
控制输出格式
archivesFormat 属性允许您指定每一个配置的构建输出格式(ZIP、TAR 和文件夹)。此属性的格式为
<configuration> - <format>,其中 configuration
是 configs 属性中指定的值,format 是下列其中一项。
- folder - 将把输出存储在 ${buildDirectory}/tmp/${archivePrefix}
中的某个文件夹中。在这种情况下,不使用 allElements.xml 中指定的目标。目前存在一些限制,即使用文件夹作为输出格式时,每次只能构建一个配置。
- zip - 将把输入存储在 ZIP 文件中。这个 ZIP 文件将由运行构建的机器上的
zip.exe 创建。如果有不是由 JAR 创建的插件,并且该插件包含需要特定许可权的文件(通常是在基于 UNIX 的系统上),此功能就特别有用。属性 zipargs 允许将其他选项传递给 zip 命令。
- antZip - 将把输入存储在 ZIP 文件中。这个 ZIP 文件将由 Ant 的 ZIP 实现创建。当未指定任何值时,这是缺省值。
- tar - 将把输出存储在 gzip 创建的 tar 文件中。将使用 tar 和 gzip 的操作系统实现。属性 tarargs 允许将其他选项传递给 tar 命令。
注意,更改输出格式并不会导致更改所创建的文件的名称。要更改所创建的文件的名称,必须在 allElements.xml 文件中进行更改。
生成 JNLP 清单
为了能够在构建时生成 JNLP 清单,请将 generateJnlp 设置为 true,并将
jnlp.codebase 设置为将要提供 jnlp 文件的位置值(请参阅 jnlp 标记中的 codebase 属性)和
jnlp.j2se。注意,这不会为更新站点打包插件和功能部件,请参阅“为更新站点或 jnlp 站点准备输出”。目前存在一些限制,即仅当生成文件夹格式的输出时,才能创建 jnlp 清单。
为更新站点或 jnlp 站点准备输出
如果要将插件和功能部件放在更新站点或 Java Web 启动站点上,则需要正确地对其进行打包。要完成此任务,只需将
outputUpdateJars 属性设置为 true。注意,这不会生成 Eclipse 更新站点的
site.xml,并且不会生成 jnlp 文件(请参阅“生成 jnlp 文件”)。
对一个构件中的多个配置进行分组
为了生成包含不同配置的插件和功能部件的输出,请将 groupConfigurations 设置为
true。这将创建一个归档,该归档包含所有与 configs
属性中列示的配置相匹配的插件和功能部件。使用此功能时,请不要忘记在 allElements.xml 文件中添加名为
<feature.id>.group.group.group 的目标。目前存在一些限制,即使用此选项将导致忽略 archivesFormat
中指定的值,并且缺省情况下将使用 antZip。
对 JAR 进行签名
为了在构建期间对 JAR 进行签名,请将 signJars 属性设置为 true,并设置
sign.alias、sign.keystore 和 sign.storepass 属性值。