Intellij IDEA 插件开发指南（初级篇）

作者：IT小白 | 2024-06-06 11:30:37

踩

idea插件开发用途

作者 | 袁华健

handsome code, handsome coder.

前言

程序员最讨厌的就是做重复性工作，如果在日常工作中发现一些重复性的工作，我们可以通过一些市面上的插件去简化我们的工作。但是当市面上的插件无法满足我们的需求的时候，我们其实可以自己去尝试写一个插件解决自身和他人的困难。当别人夸你写的插件牛逼，心里岂不是美滋滋。

1、下载 IntelliJ IDEA

大多数的插件其实都是一个道理，依靠平台提供的 sdk 去做定制化的开发，如 chrome 插件。IntelliJ IDEA 的插件也是同理，我们也是依赖 IntelliJ 提供的 sdk 去进行一个插件的开发。首先我们需要的是下载 IntelliJ IDEA，下载安装就不多赘述，大家都会。下载地址：https://www.jetbrains.com/idea/

2、新建 project

点击 File -> Project -> 选择 gradle -> 勾选上 Java 和 IntelliJ Platform Plugin 选项。

点击 next 后，填写GroupoId、ArtifactId和Version

点击 next 后设置 gradle 工程的构建，建议直接默认配置。

点击 next，填写好名称后，点击 finish 后等待完成项目的初始化工作。

初始化后的目录其实也很简单，src 目录为插件源代码目录，plugin.xml记录了插件的一些配置以及 Action的注册。

3、认识 Plugin.xml

看一下 IDEA 默认生成的plugin.xml


<idea-plugin>
    <id>com.mars.plugin</id>
    <name>Plugin display name here</name>
    <vendor email="support@yourcompany.com" url="http://www.yourcompany.com">YourCompany</vendor>
 
    <description><![CDATA[
    Enter short description for your plugin here.<br>
    <em>most HTML tags may be used</em>
    ]]></description>
 
    <!-- please see http://www.jetbrains.org/intellij/sdk/docs/basics/getting_started/plugin_compatibility.html
         on how to target different products -->
    <!-- uncomment to enable plugin in all products
    <depends>com.intellij.modules.lang</depends>
    -->
 
    <extensions defaultExtensionNs="com.intellij">
        <!-- Add your extensions here -->
    </extensions>
 
    <actions>
        <!-- Add your actions here -->
    </actions>
</idea-plugin>

介绍 plugin.xml 几个主要构成的元素

<id> 这个id是在jetbrains插件库中定位到你插件的唯一id

<name> 插件的名称

<description> 插件的功能描述

<change-notes> 插件的版本变更记录

<idea-version> 插件最低可兼容的idea版本号

<extensions> 扩展点集合，子元素 <extension> 用于扩展其他插件功能或者idea平台的功能

<actions> 自定义动作的集合，子元素 <action> 用户定义一个动作

4、认识 action

在 idea 中每个功能都叫 action，一个菜单栏里组合了多个 action。我们如果想自定义实现一个功能，那么就需要实现 intellij IDEA 提供的派生类 AnAction 。当用户在点击一个 action 时，会回调 AnAction 的actionPerformed方法，所以我们需要在 actionPerformed方法中实现自己的逻辑。

Ok，那我想在 Help菜单栏中增加一个功能 show Hello World , 点击后弹框，并展示 say hello world ~ 该怎么做呢？

首先我们在src下创建自己的包 com.mars.plugin ，然后就是去创建我们的 action，利用 IDEA 提供的创建方式可以快速的创建一个 action。

点击 new -> plugin devkit -> action

填写好 action 的一些基本设置后点击 ok，idea 就自动把 HelloAction 给实现，并注册到 plugin.xml 文件中。

然后我们的 action 就算是初始化完了，但是什么也没做，我们给他添加上展示系统弹框的功能。


@Override
public void actionPerformed(AnActionEvent e) {
        Project project = e.getData(PlatformDataKeys.PROJECT);
        Messages.showMessageDialog(project, "say hello world ~", "Info", Messages.getInformationIcon());
}