此文章部分转自:http://fxzcollege6.iteye.com/blog/2013055
关于plugin.xml文件我还总结过一篇文章:http://www.cnblogs.com/DreamDrive/articles/4586150.html
关于plugin.xml文件编辑视图如下:
在一个eclipse plugin的开发中plugin.xml是必须的,那么我们需要关注哪些点
我们用eclipse中的plug-in manifest edtor打开,我们可以看到在editor区域中看到几个tab页,下面分别介绍:
Overview
这里是这个插件工程的一些基本信息介绍,比如插件的名字,版本,id,编译执行环境等。我们需要关注的是右下角的Testing,这里提供了我们在开发中运行插件的两种方式普通和debug模式。
当然说到运行,我们还有其他的方式:
- 在package或navigator视图下选择工程右键>Run As>Run Configuration
- 直接在toolbar区域选择Run As/Debug As进行运行时的配置
这里说一个在开发中遇到的问题,在开发的开始阶段老是遇到java.lang.OutOfMemoryError: PermGen space,开始以为eclipse.ini中VM的配置参数过低,但在进行了相应的修改后启动仍然内存溢出,最后是在configurations中的Argument中显示配置VM参数解决,比如
在VM arguments中设置
-Xms128m -Xmx256m -XX:PermSize=128m -XX:MaxPermSize=128m
难道是打开的plugin运行时启动的eclipse会吃掉主的内存,导致分配的太少而溢出?
既然说到run configuration,那么可能还有几个需要关注
- Main tab下的一些配置
- Plug-ins下lanch with中的插件可能默认会全部选中,其实我们可以先Deselect All,然后选中我们需要运行的plugin,再Add Required plug-ins
Dependecies
这里是这个插件工程需要依赖的各种插件,这里包括依赖eclipse本身的各种组件。比如运行时org.eclipse.core.runtime,比如你需要在你插件工程中打开java文件,那么需要org.eclipse.jdt.core、org.eclipse.ui.workbench.texteditor等,同时你也可以增加第三方依赖插件。通过Add按钮,在弹出窗中输入相应的插件添加
Runtime
我们可以看到两个地方需要关注:
- Exported Packages:这个是你这个插件中向外暴露的包,你可以添加需要向外暴露的结构,那么应用你这插件的其他工程就可以访问你相应的接口
- Classpath:当前插件工程运行依赖的第三方jar包,一般我们把第三方依赖的包放在工程根目录下的lib文件夹内
Extensions/Extensions Points
扩展和扩展点,前者是指引入其他插件的扩展点,后者是当前工程暴露出的扩展点。
- 比如你的插件工程中有视图,那么你需要引入org.eclipse.ui.views在这个扩展点下,你可以定义相关的视图。这里引入也会在plugin.xml中体现:point="org.eclipse.ui.views"
- 如果这个扩展点下可以有多个view视图,也可以有category标签会将相应的视图归类,比较直观的是在eclipse的window>show view>...中体现
至于扩展点,网上例子较多,在实际项目中没有使用,不便多说
Build
这是编译插件时需要包含的资源,在Binary Build的时候勾上需要的资源吧,记得在开始的时候老是忘记lib包,导致编译错误或使用就报错
MANIFEST.MF和build.properties
这里其实对前几个tab页中内容自动生成,比如包含Require-Bundle、Bundle-ClassPath、Export-Package等
plugin.xml
这部分内容是比较重要的,比如描述了各种actionSets,extension point
扩展点point="org.eclipse.ui.views"
- 比如声明一个视图
<extension id="com.plugin.sample.sampleView" point="org.eclipse.ui.views"> <category name="Sample" id="com.plugin.eclipse.sample"> </category> <view category="com.plugin.eclipse.sample" class="com.plugin.eclipse.sample.views.SampleView" icon="icons/sample.png" id="com.plugin.eclipse.samle.views.sampleView" name="SampleView"> </view> </extension>
- 比如某个菜单只作用于java类
扩展点:point="org.eclipse.ui.popupMenus
xml代码
<extension point="org.eclipse.ui.popupMenus"> <objectContribution id="com.plugin.eclipse.sample.popupMenu" objectClass="org.eclipse.core.resources.IFile" adaptable="true" nameFilter="*.java"> <menu label="Sample" path="additions" id="com.plugin.eclipse.sample.menu" icon="icons/sample.png"> <separator name="group"> </separator> </menu> <action class="com.plugin.eclipse.sample.SampleAction" enablesFor="+" icon="icons/sample.png" id="com.plugin.eclipse.sample.sampleAction" label="SampleAction" menubarPath="com.plugin.eclipse.sample.menu/group"> </action> </objectContribution> </extension>
扩展点point="org.eclipse.ui.actionSets
<?xml version="1.0" encoding="UTF-8"?> <?eclipse version="3.0"?> <plugin> <extension point="org.eclipse.ui.actionSets"> <actionSet label="Fletcher的工具集" visible="true" id="fletcher.plugins.actionSet"> <menu label="fletcher'menu(&M)" id="fletcherMenu"> <separator name="fletcherGroup"> </separator> </menu> <action label="fletcher(&S)" icon="icons/sample.gif" class="fletcher.plugins.SampleAction" tooltip="Hello,Eclipse world" menubarPath="fletcherMenu/fletcherGroup" toolbarPath="fletcherGroup" id="fletcher.plugins.SampleAction"> </action> </actionSet> </extension> </plugin>
<!--point="org.eclipse.ui.actionSets":用于设置插件的扩展点,其中"actionSets"对应着Eclipse中的菜单、菜单项和工具栏中按钮的扩增点.-->
<!-- <actionSet>:用于设置一个action组,对应着新增的菜单和按钮.其中的label属性用于设置显示时的名称.Visible属性用于设置对应的菜单或者按钮是否显示.Id属性是作为唯一标识符使用的,注意在一个plugin.xml文件中,要确保其唯一性.-->
<!-- <menu>:作为<actionSet>的子项,该项用于设置在Eclipse环境的菜单栏中添加一个新的主菜单,例如在上面的程序中对应的菜单名称为"样本菜单(&M)".其中的<separator>是一个结束符,用于实现菜单中命令的分组.-->
<!-- <action>:作为<actionSet>的子项,该项用于设置在对应的菜单项和工具栏中的按钮.其中,label属性用于设置对应菜单项显示的名称,当对应着工具栏中的按钮的图标
无法找到时,在按钮位置同样显示这里设置的名称.icon属性用于图标的路径.class属性用于设置单击按钮或者选择菜单中的命令后对应执行的类,注意要将完整的包名写上.
Tooltip属性用于设置悬停时的提示性信息.menbarPath属性表示将该action对应的菜单项放置在<menu>所设置的菜单中.toolbarPath表示将该action同时作为一个
工具栏中的按钮.id属性用于设置唯一性标识.一般和class保持一致即可.-->