在 Equinox 中是否可以将 OSGi 包标记为从其包含功能的 p2.inf 开始？

Question

我有一个 Eclipse 功能，其中包括几个捆绑包。我想告诉 p2 在安装该功能时将其中一个捆绑包标记为已启动。这可以像这样使用捆绑包自己的 META-INF/p2.inf，

instructions.configure = markStarted(started: true)

但我想在功能级别而不是捆绑级别执行此操作（相关捆绑是第三方，如果可能，我不希望以任何方式对其进行修改）。

一些研究让我找到了this document，这表明应该可以将配置指令移动到包含功能的 p2.inf 中。我已经尝试了所有显而易见的事情，例如，

units.0.id = <bundle symbolic name>
units.0.instructions.configure = \
  org.eclipse.equinox.p2.touchpoint.eclipse.markStarted(started: true)

但到目前为止，我尝试过的所有排列都没有任何效果：因为没有任何反应，捆绑包没有标记为已启动，也没有报告错误）。

任何指针都会非常受欢迎。与 Eclipse Equinox Galileo (3.5.2) 一起使用......与 Helios 相关的答案也将非常有用。

Answer 1

“单位.#”。 p2.inf 条目会创建一个新的Installable Unit，它们不会修改其他现有的 IU。

您基本上必须创建一个完整的Installable Unit fragment。该片段具有相关说明并附加到您的捆绑包的 IU。然后你需要从你的功能中添加一个需求到这个新的 IU。

PDE/Build 在构建产品时会自动执行此操作。您可以通过创建一个小 rcp 产品构建来查看生成的 p2.inf，该构建具有您的捆绑包的起始级别。
在产品构建中生成的 p2.inf 将是 buildDirectory/features/org.eclipse.pde.build.container.feature/product/p2.inf

这是我从一个构建中修改的示例，该构建设置了org.eclipse.equinox.common 的起始级别。 $version$ 将被 p2.inf 所属功能的版本替换。请注意“hostRequirements”，它指定了我们作为片段的捆绑包。

#create a requirement on the IU fragment we are creating
requires.2.namespace=org.eclipse.equinox.p2.iu
requires.2.name=configure.org.eclipse.equinox.common
requires.2.range=[$version$,$version$]
requires.2.greedy=true

#create a IU frament named configure.org.eclipse.equinox.common
units.0.id=configure.org.eclipse.equinox.common
units.0.version=$version$
units.0.provides.1.namespace=org.eclipse.equinox.p2.iu
units.0.provides.1.name=configure.org.eclipse.equinox.common
units.0.provides.1.version=$version$
units.0.instructions.install=installBundle(bundle:${artifact});
units.0.instructions.uninstall=uninstallBundle(bundle:${artifact});
units.0.instructions.unconfigure=setStartLevel(startLevel:-1);markStarted(started:false);
units.0.instructions.configure=setStartLevel(startLevel:2);markStarted(started:true);
units.0.hostRequirements.1.namespace=osgi.bundle
units.0.hostRequirements.1.name=org.eclipse.equinox.common
units.0.hostRequirements.1.range=[3.6.0.v20100503,3.6.0.v20100503]
units.0.hostRequirements.1.greedy=false
units.0.hostRequirements.2.namespace=org.eclipse.equinox.p2.eclipse.type
units.0.hostRequirements.2.name=bundle
units.0.hostRequirements.2.range=[1.0.0,2.0.0)
units.0.hostRequirements.2.greedy=false
units.0.requires.1.namespace=osgi.bundle
units.0.requires.1.name=org.eclipse.equinox.common
units.0.requires.1.range=[3.6.0.v20100503,3.6.0.v20100503]
units.0.requires.1.greedy=false

问题的答案：

1. 0、1、2

   这些数字有些随意，它们仅用于将一组属性（requires 或 units 或其他）与另一组属性分开。这里的requires 使用了“2”，只是因为我从 pde.build 生成的大型 p2.inf 中复制了它，而忘记像我做units.0 一样更改它。

2. 这一切有必要吗？

   是的。需要 type=bundle 上的第二个 hostRequirements。在 Helios 中，除了翻译片段外，一个 IU 只能附加一个片段。通常，可以使用默认 IU 来设置所有 osgi 捆绑包的默认启动级别。为了选择我们的自定义片段而不是默认片段，它必须具有更高的“特异性”，即满足的主机要求的数量。

   对于“安装”

   units.0.instructions.install=installBundle(bundle:${artifact}); units.0.instructions.uninstall=uninstallBundle(bundle:${artifact});

   instructions.install 和 instructions.uninstall 指的是 p2 过程的阶段。 installBundle 和 uninstallBundle 指的是 OSGi 意义上的安装/卸载。必须先将捆绑包安装到 OSGi 系统中，然后才能执行任何其他操作。这基本上涉及将其添加到 config.ini 或 org.eclipse.equinox.simpleconfigurator/bundles.info 文件中。

   大多数 p2 安装已经包含一个默认配置 IU，它将安装并设置捆绑包的默认启动级别 (4)。但是，目前每个包只能应用一个配置片段，因此当您像这样添加自己的配置片段时，默认值不再应用于您的包。

3. 主机要求。可安装的单元片段页面仅描述了片段是什么，没有关于如何创建片段的参考。在Customizing Metadata 页面上简要提到了它，但没有解释。

   文档，在 wiki 上的 p2 category 下有一堆东西。 touchpoint instructions 上的页面可能很有趣。 help.eclipse.org 有一些帮助，但总的来说，我认为这比有文档的内容要高级一些。