27
2017
09

从0开始,开发一款属于自己的Android Studio插件

前言

AS插件绝对是我们开发道路上的一把利器,这里首先推荐几款我常用的插件。

Json转Java类

快速生成findViewById代码

CodeGlance

这里写图片描述

开发前准备

工欲善其事,必先利其器。首先我们要先准备IDE,这里使用 Intellij,我下载的Community版。

安装完毕后,新建一个插件开发工程:

这里写图片描述

关于project SDK,要说一下。如果没有sdk,就点击New,选择软件附带的,但是这里可能会提示没有Java jdk,在自己本机上,随便找一个版本的jdk就行,我用的1.8。

新建好的工程目录如下:

这里写图片描述

我们接下来模仿ECTranslation写一个翻译插件,因为原理简单,使用方便,实现起来很容易。大家如果看明白原理,都可以自己动手做一个。

因为要用到有道翻译的API,所以我们要先在有道智云上注册开发者,注册完申请自然语言翻译服务,创建应用。

这里写图片描述

请求API的过程有道翻译已经给我们准备好了Demo

我直接贴出来Java的请求过程:

public class Demo {

    public static void main(String[] args) throws Exception {
        String appKey ="您的appKey";
        String query = "good";
        String salt = String.valueOf(System.currentTimeMillis());
        String from = "EN";
        String to = "zh-CHS";
        String sign = md5(appKey + query + salt+ "您的密钥");
        Map params = new HashMap();
        params.put("q", query);
        params.put("from", from);
        params.put("to", to);
        params.put("sign", sign);
        params.put("salt", salt);
        params.put("appKey", appKey);
        System.out.println(requestForHttp("https://openapi.youdao.com/api", params));
    }

    public static String requestForHttp(String url,Map requestParams) throws Exception{
        String result = null;
        CloseableHttpClient httpClient = HttpClients.createDefault();
        /**HttpPost*/
        HttpPost httpPost = new HttpPost(url);
        List params = new ArrayList();
        Iterator> it = requestParams.entrySet().iterator();
        while (it.hasNext()) {
            Entry en = it.next();
            String key = en.getKey();
            String value = en.getValue();
            if (value != null) {
                params.add(new BasicNameValuePair(key, value));
            }
        }
        httpPost.setEntity(new UrlEncodedFormEntity(params,"UTF-8"));
        /**HttpResponse*/
        CloseableHttpResponse httpResponse = httpClient.execute(httpPost);
        try{
            HttpEntity httpEntity = httpResponse.getEntity();
            result = EntityUtils.toString(httpEntity, "utf-8");
            EntityUtils.consume(httpEntity);
        }finally{
            try{
                if(httpResponse!=null){
                    httpResponse.close();
                }
            }catch(IOException e){
                e.printStackTrace();
            }
        }
        return result;
    }

    /** * 生成32位MD5摘要 * @param string * @return */
    public static String md5(String string) {
        if(string == null){
            return null;
        }
        char hexDigits[] = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
                'A', 'B', 'C', 'D', 'E', 'F'};

        try{
            byte[] btInput = string.getBytes("utf-8");
            /** 获得MD5摘要算法的 MessageDigest 对象 */
            MessageDigest mdInst = MessageDigest.getInstance("MD5");
            /** 使用指定的字节更新摘要 */
            mdInst.update(btInput);
            /** 获得密文 */
            byte[] md = mdInst.digest();
            /** 把密文转换成十六进制的字符串形式 */
            int j = md.length;
            char str[] = new char[j * 2];
            int k = 0;
            for (byte byte0 : md) {
                str[k++] = hexDigits[byte0 >>> 4 & 0xf];
                str[k++] = hexDigits[byte0 & 0xf];
            }
            return new String(str);
        }catch(NoSuchAlgorithmException | UnsupportedEncodingException e){
            return null;
        }
    }

    /** * 根据api地址和参数生成请求URL * @param url * @param params * @return */
    public static String getUrlWithQueryString(String url, Map params) {
        if (params == null) {
            return url;
        }

        StringBuilder builder = new StringBuilder(url);
        if (url.contains("?")) {
            builder.append("&");
        } else {
            builder.append("?");
        }

        int i = 0;
        for (String key : params.keySet()) {
            String value = params.get(key);
            if (value == null) { // 过滤空的key
                continue;
            }

            if (i != 0) {
                builder.append('&');
            }

            builder.append(key);
            builder.append('=');
            builder.append(encode(value));

            i++;
        }

        return builder.toString();
    }
    /** * 进行URL编码 * @param input * @return */
    public static String encode(String input) {
        if (input == null) {
            return "";
        }

        try {
            return URLEncoder.encode(input, "utf-8");
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }

        return input;
    }
}

原理

开发前,先讲下翻译的原理。整个翻译的过程很简单,获取鼠标选择的单词,调用翻译API,整理翻译结果并显示。

这里使用的是有道翻译的API,新版有道智云的自然语言翻译API已经不免费了,不过用户注册以后会送100块的体验金,其收费标准如下:

这里写图片描述

如果是我们自己个人使用,100块也足够我们折腾了。

接下来进入正式的开发过程。

插件开发

首先新建一个Action文件:

这里写图片描述

然后填入Action ID、Class Name、快捷键:

这里写图片描述
上图中我们把新加的翻译按钮放在Edit命令下,命令的名字叫translation,快捷键是Alt+E

确定以后,看一眼plugin.xml里多了这样一段代码:


  <actions>
    <action id="zttranslation" class="ZTTranslation" text="Translation" description="translate word">
      <add-to-group group-id="EditMenu" anchor="first"/>
      <keyboard-shortcut keymap="$default" first-keystroke="alt E"/>
    </action>
  </actions>

这是我们新建的翻译Action对应的配置文件。

看一眼新建的ZTTranslation类:

public class ZTTranslation extends AnAction {

    @Override
    public void actionPerformed(AnActionEvent e) {
        // TODO: insert action logic here
    }

}

接下来我们要获取鼠标选择的单词并弹框显示:

public class ZTTranslation extends AnAction {

    @Override
    public void actionPerformed(AnActionEvent e) {
        final Editor mEditor = e.getData(PlatformDataKeys.EDITOR);
        if (null == mEditor) {
            return;
        }
        SelectionModel model = mEditor.getSelectionModel();
        final String selectionTxt = model.getSelectedText();
        if (TextUtils.isEmpty(selectionTxt)) {
            return;
        }
         Messages.showMessageDialog(selectionTxt,"TestWord",Messages.getInformationIcon());
    }

}

运行一下看看效果。

运行以后会重新打开一个新窗口,随便新建一个工程,看下Edit命令下:

这里写图片描述

我们新建的Translation在第一行,下面测试下,选择单词:

这里写图片描述

一切正常,接下来我们继续往下接入翻译。

 @Override
    public void actionPerformed(AnActionEvent e) {
        final Editor mEditor = e.getData(PlatformDataKeys.EDITOR);
        if (null == mEditor) {
            return;
        }
        SelectionModel model = mEditor.getSelectionModel();
        final String selectionTxt = model.getSelectedText();
        if (TextUtils.isEmpty(selectionTxt)) {
            return;
        }
        //调用有道翻译Demo
        String result = HttpUtils.findTranslation(selectionTxt);
        StringBuilder sb = buildResult(result);
        String translation;
        if (sb.length() == 0) {
            translation = "暂无此翻译!";
        } else {
            translation = sb.toString();
        }
        showTranslationPopup(mEditor, translation);
    }

HttpUtils.findTranslation(selectionTxt)就是上面我贴出来的有道官网上的请求Demo,然后将返回的字符串按照设计的思路重新排版一下,翻译请求的返回结果示例如下:

{
  "errorCode":"0",
  "query":"good", //查询正确时,一定存在
  "translation": [ //查询正确时一定存在
      "好"
  ],
  "basic":{ // 有道词典-基本词典,查词时才有
      "phonetic":"gʊd"
      "uk-phonetic":"gʊd" //英式发音
      "us-phonetic":"ɡʊd" //美式发音
      "explains":[
          "好处",
          "好的"
          "好"
      ]
  },
  "web":[ // 有道词典-网络释义,该结果不一定存在
      {
          "key":"good",
          "value":["良好","善","美好"]
      },
      {...}
  ]
  ],
  "dict":{
      "url":"yddict://m.youdao.com/dict?le=eng&q=good"
  },
  "webdict":{
      "url":"http://m.youdao.com/dict?le=eng&q=good"
  },
  "l":"EN2zh-CHS"
}

我这里只取了“explains”的翻译结果,然后弹出一个popup显示:

 private void showTranslationPopup(final Editor editor, final String result) {
        ApplicationManager.getApplication().invokeLater(new Runnable() {
            @Override
            public void run() {
                JBPopupFactory factory = JBPopupFactory.getInstance();
                factory.createHtmlTextBalloonBuilder(result, null, new JBColor(new Color(186, 238, 186), new Color
                        (73, 117, 73)), null).setFadeoutTime(5000).createBalloon().show(factory
                        .guessBestPopupLocation(editor), Balloon.Position.below);
            }
        });
    }

然后再运行看看,英译汉:

这里写图片描述

汉译英:

这里写图片描述

这里只是一个练习的例子,所以没考虑更多细节,不过以后看源码应付下生僻单词还是很给力的,哈哈。

最后就是到处插件jar包,运行到我们的Android Studio上去。

这里写图片描述

这里写图片描述

插件zip包就导出到工程路径下了,然后我们赶紧打开AS安装插件试试。

这里写图片描述

安装完成以后重启AS就可以了。

这里写图片描述

上一篇:Android百度地图点聚合开发 下一篇:Android自定义View-自定义属性