七叶笔记 » java编程 » 基于IntelliJ IDEA/Android Studio插件开发指南(推荐)

基于IntelliJ IDEA/Android Studio插件开发指南(推荐)

为防止盗链,本文首发于于果的博客园,转载请注明出处!原文链接:https://www.cnblogs.com/yuxiuyan/p/14682460.html

前言

目前在为安卓手机QQ做自动化的相关工作,包括UI自动化,逻辑层自动化等。使用到的uiautomator等框架,需要在Android Studio进行编码工作。 其中很多工作如果做到插件化的话,可以有效地节省时间成本,提升大家的自动化效率。 比如运行自动化的时候,需要用到我们自定义的shell命令。我们可以通过插件来实现一键运行。 在运行adb shell am instrument命令的时候,需要编译出test APK和target APK。手Q整体的git仓库很大,编译耗时很久。我们想着通过一些方法来优化这个耗时。其中一个步骤就是,把我们代码目录下的变更,同步到一个编译目录下。 这个小功能的最合适的形态,自然就是Android Studio上的一个插件。点击一个按钮,一键同步,那可真是在米奇妙妙屋吃妙脆角——妙到家了! Android Studio是基于Intellij IDEA开发的,所以开发Android Studio的插件,其实就是开发IDEA的插件。 根据官方推荐,使用IDEA IDE来开发IDEA插件。

插件开发的基本流程

1. 环境配置

1.1 安装PDK

正如Java开发需要安装Java DevKit,IDEA插件开发也需要安装Plugin DevKit。PDK的作用是为插件提供IDEA内建支持以及相关库函数。 打开Intellij IDEA --> Preferences --> Plugins,如果没有安装,可以在marketplace里面搜索,并安装。

1.2 配置插件开发SDK

配置开发 IntelliJ 平台插件的SDK也就是IntelliJ Platform Plugin SDK,基于 JDK 之上运行,类似于开发 Android 应用需要 Android SDK。 切换到 File --> Project Structure,选择左侧栏 Platform Settings 下的 SDKs,点击+按钮,先选择 Add JDK,指定 JDK 的路径;再选择Add IntelliJ Platform Plugin SDK,指定上面添加的JDK为插件需要的JDK。需要注意的是,从IDEA 2020.3开始,不能再使用Java1.8版本。因为IDEA 2020.3版本基于Java11构建,所以如果想要开发2020.3及以后版本的IDEA的插件,需要选择Java11版本。

2. 新建插件工程

File --> New --> Project,在弹出的窗口中选择Gradle,然后选择Java(这表明我们使用Java语言开发)和Intellij Platform Plugin,点击Next,然后设置项目的名称和位置,点击Finish完成创建。

3. Action

我们在IntelliJ自定义的插件可以添加到菜单项目(如右键菜单中)或者是放在工具栏中。当用户点击时触发一个动作事件,IntelliJ则会回调AnAction子类的actionPerformed函数。因此我们只需重写actionPerformed函数即可。我们可以认为Action是插件的触发入口。我们可以直接右键New --> Plugin DevKit --> Action新建action,这个action是AnAction的子类。

在接下来的弹出窗口中,我们可以创建一个Action。

Action ID:这个action的唯一标识 Class Name:action的类名 Name:action的名称 Description: action的描述信息 Groups:这个标签指定我们自定义的插件应该放入到哪个菜单下面。 在IntelliJ IDEA菜单栏中有很多菜单如File、Edit、View、Navigate、Code、……、Help等。他们的ID一般是菜单名+Menu的方式。比如,我们想将我们自定义的插件放到Help菜单中,作为Help菜单的子选项。那么在Groups中就指定HelpMenu。左侧的Anchor属性用于描述位置,主要有四个选项:first、last、before、after。他们的含义如下:

first:放在最前面 last:放在最后 before:放在relative-to-action属性指定的ID的前面 after:放在relative-to-action属性指定的ID的后面

Keyboard Shortcuts:可以为这个action指定快捷键

创建完之后,我们也可以在src/resources/META-INF/plugin.xml中,看到我们之前写入的action信息,如果想要修改,可以在这个配置文件中直接修改。

4. 配置描述

src/resources/META-INF/plugin.xml是整个插件的配置文件,里面定义了插件的名称,描述信息,支持的IDEA版本号,作者信息,action的相关信息等。

5. 调试、打包

调试

等到配置完成后,在IDEA右侧的Gradle一栏中,有Intellij的集合。点击里面的runIde,可以打开一个沙盒,里面运行包含着该插件的IDEA实例。也可以右键选择debug模式运行。

打包

点击上图的buildPlugin,就可以在build/distributions/目录下面生成插件zip包,这个包就是我们需要的最终产物。在IDEA设置Preferences --> Plugins,点击installed旁边的设置按钮,选择Install Plugin from Disk,然后选择这个zip,就可以安装到IDEA中了。

插件的组件

GUI

ToolWindow

工具视窗(ToolWindow)的功能主要是进行信息的显示,同时用户还可以直接在toolwindow中进行操作调用工具,比如IDE下方默认的terminal、Git等。作为IDE侧边栏中较大的一部分,toolwindow与用户的交互在整个ui中非常重要。

实现toolwindow主要分为两步,第一步创建类实现ToolWindowFactory接口,编写需求的toolWindowFactory实例,第二步在plugin.xml中注册该ToolWindow。

当用户单击工具窗口按钮时,将调用工厂类的方法createToolWindowContent(),并初始化工具窗口的UI。此过程可确保未使用的工具窗口不会在启动时间或内存使用上造成任何开销:如果用户不与插件的工具窗口进行交互,则不会加载或执行任何插件代码。

在plugin.xml中注册toolwindow。

Dialog

会话框(Dialog)可以与用户交互,获取用户自定义输入的内容,也可以作为提示弹窗,告诉用户信息。会话框的实现需要定义一个继承了IDEA的DialogWrapper抽象类的子类,这个子类就是自定义的会话框实现,所有的样式定义、功能触发都是放到这个子类里的,比如以下实现:

业务实践

获取文件差异

方案一:自建Diff工具

为了获得代码目录与编译目录的文件差异,必然要使用到Diff工具,这其中涉及到很多自定义的规则,比如差异文件是否要忽略等。优点是可以完全自定义灵活的识别差异的规则。缺点是耗时较久,毕竟要编写一套Diff系统。时间比较紧,所以这个方案pass了。

方案二:使用JGit

JGit是Java编写的一套Git工具,通过Java代码就可以调用到Git的所有指令,可以完美解决获得文件差异的需求。但是经过实际测试发现,在调用git.status.call()方法时 ,由于它需要初始化Git,包括建立diff,filetree等操作,对于大仓库,一次运行就要十几秒,不能接受,故放弃。

方案三:利用内存Git

经过方案二,我们发现git是符合我们要求的,但是因为JGit要初始化,所以耗时较久。但是我们在运行IDEA的时候,在终端使用git status非常快,是毫秒级,那我们完全可以利用内存中的git,直接执行git status命令,在返回结果中去匹配文件差异。 通过让Java执行git命令,可以达到毫秒级相应。

Java执行shell命令并返回执行结果

参考

https://blog.csdn.net/huachao1001/article/details/53856916

https://blog.csdn.net/huachao1001/article/details/53883500

https://plugins.jetbrains.com/docs/intellij/welcome.html?from=jetbrains.org

到此这篇关于基于IntelliJ IDEA/Android Studio插件开发指南(推荐)的文章就介绍到这了,更多相关IDEA Android Studio插件开发内容请搜索七叶笔记以前的文章或继续浏览下面的相关文章希望大家以后多多支持七叶笔记!

相关文章