eclipse-plugineclipse-plugin入门


备注

本节概述了eclipse-plugin是什么,以及开发人员为什么要使用它。

它还应该提到eclipse-plugin中的任何大型主题,并链接到相关主题。由于eclipse-plugin的文档是新的,您可能需要创建这些相关主题的初始版本。

你好,世界

要为Eclipse创建Hello World插件,请单击: 文件新建其他...

Eclipse插件选择新项目

选择Plug-in Project并单击Next>

Eclipse插件选择插件项目

New Plug-in Project向导将指导您完成创建新插件的选项。

输入项目名称(如HelloWorld),然后单击Next>

Eclipse插件新插件

在“ 内容”页面上,您可以设置插件的ID版本名称供应商

默认情况下,版本将为1.0.0.qualifier 。您可以保持原样,但最好将其更改为有意义的内容。 eclipse wiki推荐使用类似vYYYYMMDD (年,月)的语法。

Eclipse插件内容

在“ 模板”页面上,您可以选择从任何模板创建插件,方法是选择它并单击“ 下一步>” 。或者,您可以通过选择自定义插件向导来组合这些模板,或者通过取消选择使用其中一个模板创建插件前面的复选框来创建没有模板的新插件。

Eclipse插件模板选择

对于Hello,World Command模板,还有其他设置:包名称,Handler类名称和消息框的文本。

Eclipse插件Hello World设置

在创建插件,您可以通过运行右键单击运行方式 ➜Eclipse的应用程序 plugin.xml中

这将启动一个新的Eclipse实例(具有自己的工作空间),它将加载您的插件。

Eclipse插件Run As Eclipse Application

这个Hello World插件将为Eclipse GUI做出3个贡献:

1.示例菜单(带示例命令):

Eclipse插件菜单项

plugin.xml中:

<extension
      point="org.eclipse.ui.menus">
   <menuContribution
         locationURI="menu:org.eclipse.ui.main.menu?after=additions">
      <menu
            label="Sample Menu"
            mnemonic="M"
            id="HelloWorld.menus.sampleMenu">
         <command
               commandId="HelloWorld.commands.sampleCommand"
               mnemonic="S"
               id="HelloWorld.menus.sampleCommand">
         </command>
      </menu>
   </menuContribution>
</extension>
 

2.工具栏图标:

Eclipse插件ToolBar Icon

plugin.xml中:

<extension
      point="org.eclipse.ui.menus">
   <menuContribution
         locationURI="toolbar:org.eclipse.ui.main.toolbar?after=additions">
      <toolbar
            id="HelloWorld.toolbars.sampleToolbar">
         <command
               commandId="HelloWorld.commands.sampleCommand"
               icon="icons/sample.gif"
               tooltip="Say hello world"
               id="HelloWorld.toolbars.sampleCommand">
         </command>
      </toolbar>
   </menuContribution>
</extension>
 

3.一键快捷键(Ctrl + 6)

plugin.xml中:

<extension
      point="org.eclipse.ui.bindings">
   <key
         commandId="HelloWorld.commands.sampleCommand"
         contextId="org.eclipse.ui.contexts.window"
         sequence="M1+6"
         schemeId="org.eclipse.ui.defaultAcceleratorConfiguration">
   </key>
</extension>
 

激活其中任何一个时,将执行Handler类:

plugin.xml中:

<extension
      point="org.eclipse.ui.commands">
   <category
         name="Sample Category"
         id="HelloWorld.commands.category">
   </category>
   <command
         name="Sample Command"
         categoryId="HelloWorld.commands.category"
         id="HelloWorld.commands.sampleCommand">
   </command>
</extension>
<extension
      point="org.eclipse.ui.handlers">
   <handler
         commandId="HelloWorld.commands.sampleCommand"
         class="helloworld.handlers.SampleHandler">
   </handler>
</extension>
 

SampleHandler.java:

package helloworld.handlers;

import org.eclipse.core.commands.AbstractHandler;
import org.eclipse.core.commands.ExecutionEvent;
import org.eclipse.core.commands.ExecutionException;
import org.eclipse.ui.IWorkbenchWindow;
import org.eclipse.ui.handlers.HandlerUtil;
import org.eclipse.jface.dialogs.MessageDialog;

/**
 * Our sample handler extends AbstractHandler, an IHandler base class.
 * @see org.eclipse.core.commands.IHandler
 * @see org.eclipse.core.commands.AbstractHandler
 */
public class SampleHandler extends AbstractHandler {

    @Override
    public Object execute(ExecutionEvent event) throws ExecutionException {
        IWorkbenchWindow window = HandlerUtil.getActiveWorkbenchWindowChecked(event);
        MessageDialog.openInformation(
                window.getShell(),
                "HelloWorld",
                "Hello, Eclipse world");
        return null;
    }
}
 

执行Handler类时,MessageBox将显示:

Eclipse插件消息框

这就是Hello World的所有插件。

如果要创建具有更多功能的插件,可以选择最适合您需要的模板,或者通过Custom插件向导创建插件以组合这些模板:

Eclipse插件模板选择

安装或设置

假设您已安装Eclipse IDE for Java Developers ,请启动Eclipse,单击“ 帮助 ” - >“ 安装新软件...

在此处输入图像描述

在“ 使用: ”中选择“ - 所有可用站点 - ”,然后导航到“ Eclipse插件开发工具 ”。选中“ Eclipse Plug-in Development Environment ”,勾选前面的复选框。

在此处输入图像描述

单击“ 下一步 ”让Eclipse检查所需的任何依赖项。再次单击“ 下一步 ”开始安装。

完成后,重新启动Eclipse。