根文件是必须通过 Eclipse 安装来打包的文件,但根文件不是功能部件或插件。Eclipse 可执行文件、INI 文件以及许可文件就是根文件的一些常见示例。
根文件由包含适当根属性的功能部件添加至构件。
root |
指定所构建的所有配置中将包含的文件或文件夹组成的列表,各个文件或文件夹之间用逗号分隔。 相对路径是相对于包含功能部件而言的。使用“file:”来指定文件,使用“absolute:”来指定绝对路径。 示例:
每个用逗号分隔的条目都成为一个 Ant 文件集。如果该条目是指一个文件夹,那么该文件夹是该文件集的“dir”参数,而“**”被用作“includes”参数。如果该条目是一个文件,那么该文件的包含目录将成为“dir”参数,并且将在“includes”参数中指定该文件。 对于所有相对文件,将在该目录中使用 ${baseDir} 属性。此 ${baseDir} 属性将是功能部件的根目录,生成的 build.xml 文件将位于该目录中。 |
root.<config> |
对给定配置,指定要包含的文件或文件夹列表。此处指定的配置应该与构件的 configs 属性中的配置相对应。相对路径是相对于包含功能部件而言的。此处也应用了“root”属性中所使用的“file:”和“absolute:”前缀。 示例:
|
root.folder.<subfolder> root.<config>.folder.<subfolder> |
与“root”和“root.<config>”属性相似,不同的是文件和文件夹不是被复制到 Eclipse 安装的根目录中,而是被复制到给定的子文件夹中。
相对路径是相对于包含功能部件而言的。此处也应用了“root”属性中所使用的“file:”和“absolute:”前缀。 示例:
|
root.permissions.<rights> root.<config>.permissions.<rights> |
指定要对其运行 ant chmod 任务的文件的列表。此属性的值将作为“includes”参数被传递给 ant chmod 任务。这意味着可以使用 ant 通配符模式。 示例:
此属性的 <rights> 部分实际上将作为“perm”参数被传递给 ant chmod 任务。如果配置的最终归档格式为 antTar,那么 <rights> 格式也会作为“filemode”参数被传递给 ant tarfileset。对于 antZip 和 zipfileset,与此相似。虽然 ant chmod 任务支持诸如“og-rwx”的许可权(此许可权使得非所有者不能使用该文件),但是 tar 文件集和 zip 文件集仅支持三位八进制字符串。 |
root.link root.<config>.link |
成对列示需要用符号链接的文件和文件夹(用逗号分隔)。此对中第一个条目是目标,第二个条目是链接名称。 示例:
这会导致一项将执行“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 任务)。可以采用以下两种方法将根文件添加至此产品构件:
${buildDirectory}/features/org.foo.rootfile.feature/rootfiles/*
/build.properties : root = rootfiles
${buildDirectory}/build.properties: featureList = org.foo.rootfile.feature
${buildDirectory}/build.properties: generatedBuildProperties = ${buildDirectory}/root.properties
${buildDirectory/root.properties: root = absolute:${buildDirectory}/rootfiles
${buildDirectory}/rootfiles/*