前言

好久没有为社区做贡献了,甚是惭愧。前不久组里先后发了《jenkins 集成 monkey》,《火线教你如何开发 Jenkins 插件》等实际动手的文章,想整理一下从创建到发布自己的 AS 插件整个详细的过程记录发布出来,希望给有需求的同行借鉴和使用。

自定义 AS 插件的需求来自于我们的静态代码扫描工具在公司推进过程中,开发同事提出希望能在研发流程中集成火线到他们的 IDE 中,方便直接本地扫描。公司大部分 Android 产品的研发团队已经强制使用 Android Studio,所以才着手开发了这个插件,闲话少说,开始介绍。

文中图片比较多,为了方便读者更直观的了解,一步一步按照步骤来操作即可。

环境准备

创建工程

创建插件项目,千万不要选错项目类型,File -> New Project,参考下图:

此处有两点需要注意:

项目介绍

创建项目完成后,目录大概是这样的:

plugin.xml是整个项目的核心配置文件,一些 Action、Extension 组件需要在这里先进行注册和声明,和 AndroidManifest.xml 注册组件类似。
以火线插件项目为例:

< id >: 插件的 ID,唯一性标识,上传到官方仓库如果如果有重复的 ID 是不能提交成功的,建议以工程 package 路径为 ID。

< name >: 显示在插件仓库列表中的名称。

< version >:插件版本。如果和之前版本号相同则不允许提交,所以每次提交仓库记得修改版本号,历史版本显示在官网插件详情页中。

< description >:插件的描述信息,会显示在插件详细说明中。

< change- notes >:更新日志,建议每个版本更新的内容都在这里描述。

< vendor >:宣传网址、联系邮件,公司信息写在这里。

< idea-version since-build="141.0" >:IDE 的 branch number,这里不用修改。

Action ID:Action 的 ID,项目中可能会有多个 ID,不能相互重复,否则 plugin.xml 中会报错。
Class Name:Action 类名
Name:菜单项中显示的文字,常见的比如 run,go 等字样
Description:描述文字
Groups: Action 的类型,比如我选择的 ToolsMenu,则 action 会出现在工具栏 “Tools” 下拉列表中,以此类推如 “Edit”、“File”、“Run” 等等。Anchor 是指 action 在菜单中的位置。

创建完成 Action 后可以直接运行,这里需要提一下 run 的 edit configuration 设置,可以参考我的截图,创建一个类型为 plugin 的运行任务,这里我起名字为 run,如下图所示。

创建成功后点击 IDE 右上角的绿色三角形箭头,启动后会看到这样的效果:

成功创建 action 后,项目会自动在 plugin.xml 的节点增加刚刚填写的属性,如上图第一个箭头所指。

启动插件工程后,在工具栏 “Tools” 中就可以找到 “ShowMeTheMoney” 这个 action 了。此时点击没有反应,因为 action 还没有任何逻辑实现。如果想要 action 去执行工作,需要在刚刚新建的 action 类中的 actionPerformed() 方法中实现代码逻辑。在方法中加入如下代码:

Messages.showDialog("Hello,火线!", "Selected Element:", new String[]{"OK"}, -1, null);

再次点击运行后,点击 Tools -> ShowMeTheMoney,得到提示:

至此,我们完成了从创建 Action 到产生效果的全部过程。

右键菜单运行 action

火线插件有一种场景,就是选中 project 或单个文件点击右键菜单 FireLine -> Run 来执行项目扫描,如何实现这个场景?大家应该注意到此时 Run 事件是在 FireLine 菜单项下了。
很简单,打开 plugin.xml 在 Actions 节点中添加如下代码:

在 id 为 “com.qtest.MainMenu”,文本为 “Sample” 的 group 中增加名为 “ShowMeTheMoney” 的 Action,运行一下就出现下图的效果:

点击 “ShowMeTheMoney” 运行效果如同 Tools 中一样,此时 Tools 列表中依然存在这个 Action 选项。如果我想给 action 加个红心 icon,可以在 Action 节点中增加 icon 属性,比如 icon="/resources/icons/Heart_16px.png",运行后的效果如下:

打包&上传仓库

完成后会在当前工程目录下产生一个 jar(或 zip)文件,就是可安装的 AS 插件。安装方式是 File -> settings -> plugin -> Install plugin from disk,选中刚刚生成的.jar 文件安装后,重启 Android Studio 即可。

注意 1:第一次上传插件要有英文描述,否则会不能通过审核。
注意 2:AS 插件想要在官方仓库被找到,切记要在 plugin.xml 中把节点的注释去掉,否则默认只能在 Intellij IDEA 的仓库中找到,我就遇到这个坑。


↙↙↙阅读原文可查看相关链接,并与作者交流