eclipse更新站点（update site）的建立

 

我们在进行eclipse插件开发时，通常通过分发jar包的方式将插件文件包发送给使用的人安装。通常的安装eclipse插件方式是直接copy到对应的eclipse/plugins目录下（或dropins, link方式），这种方式虽然简单，但是在插件文件更新（版本升级）时通常还需要再次分发插件文件包，进行本地安装，非常不方便。

 

经过严格设计（这考虑到OSGi组件、服务的松耦合）的eclipse bundle可能是非常多的，这也意味着最终发布的插件产品可能是一堆eclipse插件jar包，鉴于插件jar包过多，一个或多个eclipse插件可以被分组至一个eclipse功能部件，这也被称为Feature。

 

功能部件（Feature）

有了Feature，用户就可以以Feature作为基本单元载入、管理、标记这些插件。在Eclipse PDE开发环境（Plugin Develop Environment）中，通过new Project的方式建立Feature，提供功能部件的id，名称以及后续引用的插件和片段。

 

 

 

功能部件工程建立完成后，就生成了对应的feature.xml，双击可以在编辑器中对其基本属性进行编辑，其中最重要的是Plug-ins页签，这里记录着功能部件中包含的各种类型plugins：

 

 

 

注意，这里所有插件的版本可以设置成0.0.0，这表示在导出feature时会自动将工作空间存在的最高版本插件导出，当然，也可以设置成固定版本号，这就对以后的升级插件版本提出一些挑战（要更改的版本号比较多）。此外，feature也需要设置版本号，这个版本号在以后说到Update　Site时非常重要。

 

此外，可以在Dependencies页签中添加部件所依赖的插件以及外部部件，并提供Compute用来计算当前插件的依赖项。至于部件中的一些Information，包括Description，Copyright Licence等等，这里就不一一介绍了。

 

更新站点

现在已经有了多个功能部件，并为这些功能部件提供了统一结构和商标标识，需要向用户分发这些功能部件。正如本文最前面所说，通过文件copy的方式并不具有吸引力（尤其是在当前网络发达的年代），eclipse提供了更好的方式，它可以管理分发，安装你的功能部件，并提供版本更新服务等。

 

eclipse更新站点是一个特别构造的网站，被设计成存储你的功能和插件并使用一个特殊的站点清单文件对它们进行描述，eclipse update manager可以读取该站点清单文件并自动载入和安装它找到的所有更新。

 

首先，我们需要创建更新站点项目，PDE环境中直接通过new Project向导找到Update Site Project来新建这种类型的项目。

 

 

 

新建工程完成后，将创建两个附加目录：/features和/plugins，保存包含功能部件和插件文件的jar包。当这些文件被上传至更新站点后，可以通过Update Manager访问，/web提供了用于展现站点外观的样式清单文件，index.html是站点的主页。

 

最重要的站点文件是site.xml，双击打开对应的编辑器，在Site Map页签中新建分类以及对应的功能部件，用来生成在线安装时对应的目录结构。在添加feature时还需要注意选择feature的版本，同一个update site中可以存在相同功能部件的不同版本。

 

 

 

编辑site.xml完成后，就可以进行构建操作，选择某个feature点击Build或进行所有feature的Build All操作，将生成对应的部件文件和插件文件包至附加目录：/features和/plugins。

Update Site站点发布

下面发布我们的插件，我们可以将站点发布到一个Web服务器中，这里选择了Apache http server上，这样就能使得所有联网的人都可以通过update site的方式下载并安装使用此插件。

 

首先从http://www.apache.org/下载Apache http server，具体安装请参阅其它文档，Windows下安装之后它会默认在“C:\Program Files\Apache Software Foundation\Apache2.2”目录（这里使用的版本是2.2），Windows的状态栏下会出现一个apache服务器管理图标，启动Apache服务。打开浏览器，地址栏输入http://127.0.0.1（默认是80端口）出现如下画面，证明成功安装，而且服务已经开启。

 

 

 

将上一节中生成的Update Site项目整体拷贝到/htdocs目录下，就会显示出该更新站点所有的feature集合。

 

 

eclipse中单击“Help -> Install New Software”:

 


 
 

 

单击Add后，输入Location:插件的更新地址(服务器ip:端口/updatesite工程名)，即可以打开插件安装的对话框：

 

 

 

安装完成后，如果需要更新插件，只需要单击“Help->Check for Update”，即可以更新当前eclipse中所有的插件，如果不想更新所有，可以在“Window->Preferences->Install/Update/ Available software sites”中将不需要更新的站点勾选去掉即可，在更新时，可以查看插件的所有版本，只有最新的插件才会用彩色显示，其他的显示为灰白色。

 

至此，一个完整的eclipse更新站点就建立完毕，开发人员和插件使用人员之间就建立一个可随时发布，随时更新的快捷平台。需要注意一点的就是Plugin，Feature的版本管理，在进行代码更改的同时，一定要记得对插件和功能部件的版本进行提升，更新站点的构建（Build）也是通过版本来进行处理的，以避免出现使用旧版本并未构建，或依赖的bundle版本未提升导致插件之间出现依赖过时的情况。