将文件添加至构件的根目录

根文件是必须通过 Eclipse 安装来打包的文件,但根文件不是功能部件或插件。Eclipse 可执行文件、INI 文件以及许可文件就是根文件的一些常见示例。
根文件由包含适当根属性的功能部件添加至构件。

根文件属性

root
指定所构建的所有配置中将包含的文件或文件夹组成的列表,各个文件或文件夹之间用逗号分隔。
相对路径是相对于包含功能部件而言的。使用“file:”来指定文件,使用“absolute:”来指定绝对路径。
示例:
  • root=rootfiles:文件夹的相对路径,包含该文件夹的内容
  • root=file:license.html,licenses:“license.html”文件的一个相对路径,同时也是 “licenses”文件夹的相对路径
  • root=absolute:/eclipse/rootfiles:文件夹的绝对路径,包含该文件夹的内容
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*:包含“about.html”的绝对路径,同时又是包含 lib 文件夹下的所有 *.so* 文件的相对路径。

每个用逗号分隔的条目都成为一个 Ant 文件集。如果该条目是指一个文件夹,那么该文件夹是该文件集的“dir”参数,而“**”被用作“includes”参数。如果该条目是一个文件,那么该文件的包含目录将成为“dir”参数,并且将在“includes”参数中指定该文件。

对于所有相对文件,将在该目录中使用 ${baseDir} 属性。此 ${baseDir} 属性将是功能部件的根目录,生成的 build.xml 文件将位于该目录中。

root.<config>
对给定配置,指定要包含的文件或文件夹列表。此处指定的配置应该与构件的 configs 属性中的配置相对应。相对路径是相对于包含功能部件而言的。此处也应用了“root”属性中所使用的“file:”和“absolute:”前缀。
示例:
  • root.win32.win32.x86=rootfiles:文件夹的相对路径,该文件夹的内容包含在 win32.win32.x86 配置中
  • root.linux.gtk.x86=absolute:file:about.html:要包含在 linux.gtk.x86 配置中的文件的绝对路径。
root.folder.<subfolder>

root.<config>.folder.<subfolder>
与“root”和“root.<config>”属性相似,不同的是文件和文件夹不是被复制到 Eclipse 安装的根目录中,而是被复制到给定的子文件夹中。
相对路径是相对于包含功能部件而言的。此处也应用了“root”属性中所使用的“file:”和“absolute:”前缀。
示例:
  • root.folder.docs/html=html_files:功能部件的“html_files”文件夹中的内容被复制到 Eclipse 安装中的 docs/html 文件夹。
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux:这是一个绝对路径,/build/jres/linux 文件夹的内容被复制到 Eclipse 安装的 jre 文件夹中。
当在 .product 文件中指定了一个 JRE 用于导出时,PDE/UI 就会使用这些属性。PDE/构建当前不支持包含使用 .product 文件的 JRE,并且需要在功能部件中指定这些属性以将 JRE 包含在无头产品构件中。
root.permissions.<rights>

root.<config>.permissions.<rights>
指定要对其运行 ant chmod 任务的文件的列表。此属性的值将作为“includes”参数被传递给 ant chmod 任务。这意味着可以使用 ant 通配符模式。
示例:
  • root.permissions.755=eclipse:设置将具有可执行许可权的“eclipse”文件。
  • root.linux.gtk.x86.permissions.755=lib/**:设置 lib 目录下可执行的所有文件。

此属性的 <rights> 部分实际上将作为“perm”参数被传递给 ant chmod 任务。如果配置的最终归档格式为 antTar,那么 <rights> 格式也会作为“filemode”参数被传递给 ant tarfileset。对于 antZip 和 zipfileset,与此相似。虽然 ant chmod 任务支持诸如“og-rwx”的许可权(此许可权使得非所有者不能使用该文件),但是 tar 文件集和 zip 文件集仅支持三位八进制字符串。
root.link

root.<config>.link
成对列示需要用符号链接的文件和文件夹(用逗号分隔)。此对中第一个条目是目标,第二个条目是链接名称。
示例:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: In the macosx.carbon.ppc configuration create a softlink in the root named "eclipse" that points to the "Eclipse.app/Contents/MacOS/eclipse" file.

这会导致一项将执行“ln -sf”命令的 ant exec 任务。如果指定了值“targetA, nameA, targetB, nameB, targetC, nameC”,那么将在收集了 Eclipse 根文件的文件夹中执行一组“ln”命令:
		ln -sf targetA nameA
ln -sf targetB nameB
ln -sf targetC nameC

将根文件包含在产品构件中

当根据功能部件来使用 .product 文件时,只需在所包含的任何功能部件中指定上述 rootfile 属性就可以将根文件添加至该产品。

可以只是为了添加根文件而包含某个功能部件。如果此“rootfile”功能部件在它的 build.properties 文件中未指定“bin.includes”属性,那么它将不会包含在最终的构建结果中,但是所添加的根文件将包含在此结果中。

当 .product 文件基于插件而不是功能部件时,仍然可以将根文件添加至构件中。在产品构件中,PDE/构建将自动生成一个容器功能部件,此功能部件中包含 .product 文件中所指定的所有插件(请参阅 eclipse.generateFeature 任务)。可以采用以下两种方法将根文件添加至此产品构件: