使用Equinox P2 实现RCP程序更新

Eclipse的软件管理很方便，尤其是在E3.4以及以后的版本中使用了Equinox P2框架以后，本文将如何使用Equinox P2框架实现RCP 程序的软件安装、更新、管理等进行介绍。

使用旧的UpdateManagerUI 实现更新RCP程序(E3.4以前)请见：

http://www.ibm.com/developerworks/cn/opensource/os-ecl-rcpum/

Equinox P2方式进行Eclipse插件安装介绍请见：

http://www.ibm.com/developerworks/cn/opensource/os-eclipse-equinox-p2/index.html

Equinox P2 进行Update另见：

http://www.vogella.de/articles/EclipseP2Update/article.html#firstfeature_category

http://wiki.eclipse.org/Equinox/p2/Adding_Self-Update_to_an_RCP_Application

http://www.ralfebert.de/blog/eclipsercp/p2_updates_tutorial/

Equinox P2

Placid Systems写道

插件更新设备在 Eclipse V3.4 中已经完全重写，它现在使用 Equinox p2 框架代替了原来的更新管理器。Equinox p2 是一个新的、非常高级的配置系统，用于安装、搜索和管理 Eclipse 安装，并且比以前的更新管理器更容易使用。

使用Equinox P2框架实现RCP 更新，首先需要获得P2相关的插件。Eclipse SDK版本都会包这些插件，如果您的版本中没有，那么请到eclipse.org上自行下载，或者使用Eclipse的Installer New Software功能在线更新。

主要用到的插件为org.eclispe.equinox.p2.ui以及其依赖的其他插件。

Feature

Feature用来组织插件，更新时需要使用Feature。RCP程序都会包含一个基础Feature——org.eclipse.rcp,它包含了 RCP程序需要的基础插件，内容为见eclipse目录下 features/org.eclipse.rcp_3.5.0.v20090519-9SA0FwxFv6x089WEf-TWh11。

先创建一个用于更新的RCP程序，org.eclipse.update.example。具体过程略。运行效果为：



下面来创建一个Feature Project。

File——New——Project——Plug-in Development——Feature Project，Feature工程一般命名为XXXX.featue，主要目的是为了与Plug-in工程区别开，但是Feature的ID却不一定以 feature结尾。



Feature Initialize Plug-in设置，这里设置为org.eclipse.update.example和org.eclipse.ui.forms。



配置Product

先给org.eclipse.update.example添加一个product configuration，添加完毕以后，进行product配置。在product中有很多依赖插件，没有这些插件，RCP程序将无法启动。默认情况 下product是基于plug-in的，在这里需要修改为基于feature。修改位置：



这时候以feature为依赖项的product就配置好了。但是运行提示失败，因为还没有给它添加以来的feature，在product的 Dependencies中添加我们刚刚创建feature“org.eclipse.update.example”。具体原因和步骤可以参考“ Equinox P2方式进行Eclipse插件”。

现在我们让插件依赖于feature，所以在对应的feature中必须定义包含的插件，不然RCP会因为找不到依赖项而无法启动。

配置Feature

feature的配置包括以下几个方面：

1，包含插件：这些插件就是上面prodcut的依赖项

2，包含feature：如果使用了eclipse定义的基本feature，那么使用它们会减少工作量。主要是向feature中添加plug-in的 工作量

3，Update site：更新源URL，可以是一个网址，也可以使本地文件，这里使用本地文件测试。

首先在feature.xml的Included Feature中添加 org.eclispe.rcp，org.eclipse.equinox.p2.user.ui，org.eclipse.help，这样它们所包含的 插件就无需再添加到包含插件中了。接着在feature.xml的Plug-in中添加org.eclipse.update.example。更新源 URL的设置比较简单，在feature.xml的Overview中，进行设置。注意URL的格式，这里使用本地文件E:/updates。

4, Dependencies：Feature自己也有依赖项。这里添加org.eclipse.ui, org.eclipse.core.runtime. org.eclipse.equinox.p2.ui.



如果配置正确，这时候再启动org.eclipse.update.example（使用product），就会发现多出一些菜单项和首选项了。



更新相关首选项：



这时候更新功能是不能用的，需要继续配置。

注意这时候Export Product时一定要记得选中Generate Metadata Repository选项，否则Update功能不能使用。大家可以发现选中与不选中时，产生的config.ini文件是不一样的。

配置Equinox P2

P2提供了自定义Update UI的功能，你可以通过扩展 org.eclipse.equinox.internal.provisional.p2.ui.policy.Policy来实现UI的定制。

比如UpdatePolicy：

Java代码



package org.eclipse.update.example.policy;

import org.eclipse.equinox.internal.provisional.p2.ui.policy.IUViewQueryContext;

import org.eclipse.equinox.internal.provisional.p2.ui.policy.Policy;

/**

* @author salever

*

*/

public class UpdatePolicy extends Policy{

public UpdatePolicy() {

// Disable the ability to manipulate repositories.

setRepositoryManipulator(null);

// View everything in the repository.

IUViewQueryContext context =

new IUViewQueryContext(IUViewQueryContext.AVAILABLE_VIEW_FLAT);

context.setVisibleAvailableIUProperty(null);

setQueryContext(context);

}

}

然后在Activtor中使用这个policy.

Java代码



public void start(BundleContext context) throws Exception {

plugin = this;

registration = context.registerService(Policy.class.getName(),

new UpdatePolicy(), null);

}

/*

* (non-Javadoc)

* @see org.eclipse.ui.plugin.AbstractUIPlugin#stop(org.osgi.framework.BundleContext)

*/

public void stop(BundleContext context) throws Exception {

context.ungetService(registration.getReference());

registration = null;

}

同时你还可以使用扩展点org.eclipse.ui.about.installationPages来定义软件安装页面。

配置Update Site



New——Plug-in Development——Update Site Project，然后添加Category和要更新的Feature。



点击上面的Build按钮，在工程目录下会生成更新源文件，将这些文件复制到update site目录中。

稍后会给出实例源码。

注意Eclipse3.5 下使用Equinox p2方式更新Feature时有2种情况，一种是针对新安装的插件的更新，另一种是针对打包时就有的插件的更新，两种方式下更新源文件的制作方式不同。

1，新安装的插件的更新：给插件对应的Feature建立category.xml，然后使用这个XML导出metadata repository，就可以作为更新源，也可以使用上面的Update Site Project方法。

2，打包时就有的feature则麻烦一些，必须使用每次打包时生成的repository文件夹下的内容作为更新源，单独导出feature是无效的。

demo_ws.rar (66 KB)
下载次数: 388