自己动手写一个Android Studio插件

rl92939 8年前
   <h2><strong>1.介绍</strong></h2>    <p>在使用Android Studio开发的时候,大部分人都会使用一些插件来提高开发效率,比如:</p>    <ul>     <li> <p>ButterKnife 自动生成注解代码</p> </li>     <li> <p>PermissionsDispatcher 更方便的进行Android 6.0权限处理</p> </li>    </ul>    <p>像这样的插件还有很多很多,但我们不能一直停留在用的程度,这样太不符合程序猿的风格了,今天就让我们自己动手来写一个插件,当以后自己有好的想法的时候,也能写一个出色的插件给大家使用。</p>    <p>想到以前写系统原生dialog的时候还要写一大串代码,简直太麻烦,今天就用这个做例子,写一个插件来实现一键生成dialog代码。</p>    <p>注:本文只是为了熟悉Android Studio插件开发,所以用一个比较简单的例子来演示。</p>    <h2><strong>2.环境搭建</strong></h2>    <p>首先需要安装IntelliJ IDEA </p>    <p>安装完成后,运行起来是这个样子的:</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/1ecfef0d1967e84f905e6f7460caa2f4.png"></p>    <p>IntelliJ IDEA</p>    <p>点击Create New Project新建一个Plugin项目,填写项目名称,选择位置就可以点击finish了。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/cb986893589c5cf2e548a9b593f6e5cb.png"></p>    <p>New Project</p>    <p>项目结构如下图所示:</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/3f67c059efa2867bd70e715c1c44dc58.png"></p>    <p>项目结构</p>    <p>src目录下建包,和平时使用Android Studio的方式是一样的。</p>    <p>到这里,环境就搭建成功了(^-^)V</p>    <h2><strong>3.编写插件</strong></h2>    <h2><strong>新建Action</strong></h2>    <p>在新建的包下建一个Action类</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/9db406585f5621bd1616a47acfb9fe5f.png"></p>    <p>New Action</p>    <p>然后填写一些信息</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/fd93032ee669c7287e94020c5bd2298e.png"></p>    <p>填写信息</p>    <ul>     <li>ActionID:Action唯一的ID,一般的格式为:pluginName.ID</li>     <li>ClassName:类名</li>     <li>Name:插件最终显示在菜单上的名称</li>     <li>Description:对这个Action的描述信息</li>    </ul>    <p>然后往下,选择插件在菜单中的位置,这里选择的是Code菜单下第一的位置,然后定义一个快捷键。</p>    <p>点击OK,就创建了一个Action类了,</p>    <pre>  <code class="language-delphi">public class CreateDialogAction extends BaseGenerateAction {        public CreateDialogAction() {          super(null);      }        public CreateDialogAction(CodeInsightActionHandler handler) {          super(handler);      }        @Override      public void actionPerformed(AnActionEvent e) {        }  }</code></pre>    <p>注意把继承的AnAction改成BaseGenerateAction,下文需要用到BaseGenerateAction类中的相关方法。</p>    <h2><strong>代码实现</strong></h2>    <p>主要实现在类中自动生成代码,首先获取相关的操作类,已在代码中加入注释说明。</p>    <pre>  <code class="language-delphi">public class CreateDialogAction extends BaseGenerateAction {        public CreateDialogAction() {          super(null);      }        public CreateDialogAction(CodeInsightActionHandler handler) {          super(handler);      }        @Override      public void actionPerformed(AnActionEvent e) {            // 获取编辑器中的文件          Project project = e.getData(PlatformDataKeys.PROJECT);          Editor editor = e.getData(PlatformDataKeys.EDITOR);          PsiFile file = PsiUtilBase.getPsiFileInEditor(editor, project);            // 获取当前类          PsiClass targetClass = getTargetClass(editor, file);          // 获取元素操作的工厂类          PsiElementFactory factory = JavaPsiFacade.getElementFactory(project);            // 生成代码          new LayoutCreator(project, targetClass, factory, file).execute();      }  }</code></pre>    <p>生成代码,需要继承WriteCommandAction.Simple类,在run方法中写生成代码的逻辑,将生成dialog的代码存入StringBuilder,然后调用targetClass类中的add方法生成代码,最后再导入需要的类。</p>    <pre>  <code class="language-delphi">public class LayoutCreator extends WriteCommandAction.Simple {        private Project project;      private PsiFile file;      private PsiClass targetClass;      private PsiElementFactory factory;        public LayoutCreator(Project project, PsiClass targetClass, PsiElementFactory factory, PsiFile... files) {          super(project, files);          this.project = project;          this.file = files[0];          this.targetClass = targetClass;          this.factory = factory;      }        @Override      protected void run() throws Throwable {          // 将弹出dialog的方法写在StringBuilder里          StringBuilder dialog = new StringBuilder();          dialog.append("public void showDialog(){");          dialog.append("android.support.v7.app.AlertDialog.Builder builder = new AlertDialog.Builder(this);");          dialog.append("builder.setTitle(\"Title\")\n");          dialog.append(".setMessage(\"Dialog content\")\n");          dialog.append(".setPositiveButton(\"OK\", new android.content.DialogInterface.OnClickListener() {\n" +                  "@Override\n" +                  "public void onClick(DialogInterface dialog, int which) {\n" +                  "\t\n" +                  "}" +                  "})\n");          dialog.append(".setNegativeButton(\"Cancel\", new DialogInterface.OnClickListener() {\n" +                  "@Override\n" +                  "public void onClick(DialogInterface dialog, int which) {\n" +                  "\t\n" +                  "}" +                  "})\n");          dialog.append(".show();");          dialog.append("}");            // 将代码添加到当前类里          targetClass.add(factory.createMethodFromText(dialog.toString(), targetClass));            // 导入需要的类          JavaCodeStyleManager styleManager = JavaCodeStyleManager.getInstance(project);          styleManager.optimizeImports(file);          styleManager.shortenClassReferences(targetClass);      }  }</code></pre>    <p>点击编译器右上角的绿色Run按钮,会重新启动一个新的IntelliJ IDEA的界面,在这里创建一个Android工程,点击Code,会看到Android Dialog选项,看下效果:</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/fb8184e853bc3f2fb4eab867a54cc941.gif"></p>    <p>Android Dialog</p>    <p>OK,到这里我们就成功的创建了一个插件,下面让我们来看看如何来部署插件。</p>    <h2><strong>4.部署插件</strong></h2>    <h2><strong>填写相关信息</strong></h2>    <p>打开项目中的plugin.xml文件,填写相关的信息,这些信息会展示在插件库中,如下图所示。</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/c2433a483cfff9f5f292201fcf25f77e.png"></p>    <p>plugin</p>    <p>点击Bulid菜单下的Prepare Plugin按钮会在项目的根目录生成jar插件,如下图所示:</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/6815bc57fbad796f5310da9383194e36.png"></p>    <p>生成插件</p>    <h2><strong>安装插件</strong></h2>    <p>打开Andorid Studio,选择File -> Settings -> Plugins -> Install plugin from disk,选择我们生成的jar然后重启即可,如下图所示,红框标记的部分就是我们刚才在plugin.xml文件中填写的信息:</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/536d150bfbdff705841e6fa185d46cbc.png"></p>    <p>安装插件</p>    <h2><strong>发布插件</strong></h2>    <p>还可以把插件发布到仓库,让其他人也能使用,进入 JetBrains 官网,注册账号,提交插件jar包,填写相关信息,等待审核就可以了。</p>    <h2><strong>5.遇到的问题</strong></h2>    <p>安装插件的时候出现下面的报错,是因为IDEA中jdk的版本是1.8,而我的Android Studio中jdk的版本是1.7导致的,版本统一就好了。</p>    <pre>  <code class="language-delphi">Android Dialog threw an uncaught PluginException.</code></pre>    <h2><strong>6.总结</strong></h2>    <p>总结一下之前的步骤:</p>    <ul>     <li> <p>下载Intellij IDEA,新建一个Intellij Platform Plugin的项目(注意jdk版本的问题,最新的IDEA需要jdk 1.8版本)</p> </li>     <li> <p>在项目中新建一个Action,把继承的AnAction改成BaseGenerateActio</p> </li>     <li> <p>编写API,这个可以参考其他插件的写法</p> </li>     <li> <p>点击Bulid菜单下的Prepare Plugin按钮生成jar,这个jar就可以直接用来安装了</p> </li>    </ul>    <p> </p>    <p>来自:http://www.jianshu.com/p/c2a3e673188b</p>    <p> </p>