使用 p2 来构建产品

定义新属性:

p2.gathering = true

将导致对产品构建进行很少更改。尤其是,构建将生成正确安装并且完全支持 p2 的产品。

下面是相关属性的列表(包括旧属性和新属性):

p2.gathering设置为 true 以启用基于 p2 发布程序的构建。
p2.build.repo本地构建时 p2 存储库的 URI,缺省值为 file:${buildDirectory}/buildRepo。会从此处将结果镜像至最终归档位置。
generate.p2.metadata这是用于旧的元数据生成器集成的一种属性。它在 p2.gathering=true 时不起作用。
p2.metadata.repo
p2.artifact.repo
这些属性是 URI。缺省情况下用于产品构建,最终归档是已安装的产品,元数据和工件保留在 ${p2.build.repo} 中。如果定义了 p2.metadata.repo 和 p2.artifact.repo,那么将从构建存储库中镜像该产品的工件和元数据。
p2.metadata.repo.name
p2.artifact.repo.name
(可选)使用了 p2.metadata.repo 和 p2.artifact.repo 时,这些属性将用来为最终存储库命名。
p2.compress设置为 true 就会将最终存储库 XML 压缩为 JAR 文件。
p2.flavor产品的版本风格,用作产品的配置元数据的限定符。请参阅下面的内容。
p2.product.qualifier在替换产品版本中的“1.0.0.qualifier”时要使用的限定符。如果未设置此属性,那么限定符将基于 forceContextQualifier 或时间戳记。
p2.publish.artifacts当 p2.gathering=true 时不起作用(旧属性)
p2.root.name
p2.root.version
当 p2.gathering=true 时不起作用(旧属性)
p2.context.repos定义上下文存储库。请参阅复用元数据。
repoBaseLocation一个包含要使用 <p2.repo2runnable> 来变换的存储库的文件夹。另请参阅复用元数据。
transformedRepoLocation一个包含 <p2.repo2runnable> 的输出的文件夹。另请参阅复用元数据。
p2.category.site用来定义类别的 site.xml 文件的 URL。
p2.category.definition用来定义类别的 category.xml 文件的 URL。
p2.category.prefix定义一个前缀,以确保根据不使用唯一名称的站点/类别文件为类别 IU 生成唯一标识。
skipMirroring跳过从 ${p2.build.repo} 到 ${p2.metadata.repo} 的最终镜像。
skipDirector跳过对控制器的调用。将不会生成已安装的产品。如果定义了 p2.metadata.repo 和 p2.artifact.repo,那么这些存储库将包含产品元数据和工件,否则 ${p2.build.repo} 中将包含结果。
p2.director.log用来记录控制器调用结果的日志文件所在的位置。
p2.director.profile用于由控制器创建的 p2 概要文件的名称。通常,最好是将此概要文件命名为与产品相关的名称。缺省值为“profile”。
p2.director.extraArgs要传递到目录中的其他自变量。缺省值为“-profileProperties org.eclipse.update.install.features=true”。
镜像属性在构建产品或功能部件时,PDE/构建将镜像上下文存储库中要包括在构建中的依赖项。这些属性用于控制哪些依赖项将包括在此操作中。有关详细信息,请参阅 p2.mirror Ant 任务。
p2.mirror.raw缺省值:false。设置为 true 以复用源存储库中的工件描述符。
p2.mirror.slicing.filter缺省情况是不过滤。设置其他过滤器属性,IU 必须满足这些属性才能包括在内。
p2.mirror.slicing.followOnlyFilteredRequirements缺省值为 false。设置为 true 以反转过滤器并且只包括不匹配的 IU。
p2.mirror.slicing.followStrict缺省值为 false。设置为 true 时,将仅包括准确指定了其版本的依赖项。
p2.mirror.slicing.includeFeatures缺省值为 true。是否包含功能部件。
p2.mirror.slicing.includeNonGreedy缺省值为 false。是否包括不贪婪的依赖项。
p2.mirror.slicing.includeOptional缺省值为 true,表示是否包括可选依赖项。
p2.mirror.slicing.latestVersionOnly缺省值为 false,当需求是一个范围并且有多个版本可用时,是否只包括最新版本的依赖项。
p2.mirror.slicing.platformFilter缺省情况是不过滤,这是一个“os,ws,arch”三元组,设置为将与 IU LDAP 过滤器进行匹配的平台。将不会镜像与过滤器不匹配的 IU。

产品版本风格

作为产品构建的一部分,PDE/构建将自动生成缺省配置元数据,以设置启动级别和 config.ini 属性。此元数据通常称为“配置单元”(CU)。特别是,启动级别是使用所启动捆绑软件的 IU 的 CU 片段来设置。当根据 IU 来生成 CU 的名称时,将版本风格用作限定符。

例如,在“p2.flavor = tooling”的情况下,“toolingwin32.win32.x86org.eclipse.core.runtime”将是在 Windows 上配置 org.eclipse.core.runtime 捆绑软件的 CU 的名称。最好是根据产品标识来使用版本风格,以避免与其他元数据发生冲突,在产品对启动级别具有特殊需要的情况下更是如此。

另请参阅配置产品页面。

控制器调用

PDE/构建包含一个 runDirector 目标,在构建产品期间,调用此目标以执行安装。目前,这是控制器应用程序在新进程中的分支。在更高级的 releng 方案中,可以复用此任务来执行更多安装。此任务要求定义构建器的 Equinox 启动程序的位置。示例调用与以下内容类似:
	<property name="equinoxLauncherJar" value="/builder/eclipse/plugins/org.eclipse.equinox.launcher_1.0.200.v20090520.jar"/>
	<ant antfile="${eclipse.pdebuild.scripts}/genericTargets.xml" target="runDirector" inheritAll="true">
		<property name="ws" value="gtk"/>
		<property name="os" value="linux"/>
		<property name="arch" value="x86"/>
		<property name="p2.director.installPath" value="${installFolder}"/>
		<property name="p2.repo" value="${p2.build.repo}"/>
		<property name="p2.director.iu" value="my.rcp.product"/>
		<property name="p2.director.version" value="1.0.0"/>
	</ant>