Android Studio 插件开发详解三:翻译插件实战

转载请标明出处:http://blog.csdn.net/zhaoyanjun6/article/details/78113868
本文出自【赵彦军的博客】

一:概述

如果不了解插件开发基础的同学可以先看,

Android Studio 插件开发详解一:入门练手
Android Studio 插件开发详解二:工具类

在上面的两篇文章,讲解了插件开发的基础,今天就来一个优点难度的项目,插件的名字叫 AndroidPluginTranslate , 顾名思义就是可以翻译文案的插件,废话不多说,先看最终效果图:

二、准备工作

1、环境变量配置及软件安装,这里省略,我在 Android Studio 插件开发详解一:入门练手 说的很清楚。

2、新建项目 AndroidPluginTranslate ,如下图所示:

三、编码

(1)关键知识

编码实际上核心的一个类叫做AnAction,可以直接选择NEW->Action,如下图:

然后填写一些相关信息

需要填写的属性如下:

  • ActionID:代表该Action的唯一的ID,一般的格式为:pluginName.ID
  • ClassName:类名
  • Name:就是最终插件在菜单上的名称
  • Description:对这个Action的描述信息

然后往下,选择这个Action即将存在的位置:

我们选择的是EditMenu,右侧选择为first,即EditMenu下的第一个,效果如图:

创建好 TranslateAction 后,它的代码很简单,如下:

import com.intellij.openapi.actionSystem.AnAction;
import com.intellij.openapi.actionSystem.AnActionEvent;

public class TranslateAction extends AnAction {

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

当我们点击菜单的时候,就回触发actionPerformed()方法。

此外我们刚才填写的信息,也在plugin.xml中完成了注册,大家可以进去看一眼,actions的标签如下:

<idea-plugin>

  <id>com.your.company.unique.plugin.id</id>
  <name>Plugin display name here</name>
  <version>1.0</version>
  <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>

  <actions>

      <action id="TranslateActionID" class="action.TranslateAction" text="Translate"
              description="TranslateAction TranslateAction">
        <add-to-group group-id="EditMenu" anchor="first"/>
        <keyboard-shortcut keymap="$default" first-keystroke="ctrl Q"/>
      </action>

  </actions>
<idea-plugin>

这里大家一定要注意,要对 <id><name><version><vendor><description> 这几个标签要认真填写,其中 <id> 是这个插件的 id ,一定不能和市场上的其他插件一样;<description> 是描述这个插件的功能,尽可能的写的详细,否则在上架插件市场的的时候,会审核不过,白白浪费时间。

那么这么看,我们在这个方法中只要完成三件事:

  • 获得当前选中的单词
  • 调用相关API得到单词的意思
  • 通过一个类似于PopupWindow来显示

(2)创建工具类

Android Studio 插件开发详解二:工具类 中介绍了三个工具类,分别是 http 工具类 HttpManager、json 解析工具类 JsonUtil 、日志打印工具类 Logger 。我们需要创建一个 util 包,然后把这三个类拷贝到我们的项目中。项目结构如下图所示:

有了这三个工具类就大大减轻了我们的开发任务。

(3) 获得当前选中的单词

public void actionPerformed(AnActionEvent e) {
    // TODO: insert action logic here
    final Editor mEditor = e.getData(PlatformDataKeys.EDITOR);
    if (null == mEditor) {
        return;
    }
    SelectionModel model = mEditor.getSelectionModel();
    final String selectedText = model.getSelectedText();
    if (TextUtils.isEmpty(selectedText)) {
        return;
    }
}

是不是觉得API很陌生,恩,我也觉得很陌生,关于API这里介绍其实没什么意义,本文主要目的是让大家对自定义插件有个类helloworld的认识,至于插件里面的代码涉及到的API等到大家需要编写插件的时候,再详细学习就好了,现在就不要浪费精力记忆这些东西了。

上面的代码就是获得选中的文本,通过一个Editor,然后拿到SelectionModel,再拿到selectedText,从字面上还是蛮好理解的。

(4)调用相关API得到单词的意思

调用的 API 我们选择有道云的翻译 API
有道智云:http://ai.youdao.com/
有道智云API文档:http://ai.youdao.com/docs/doc-trans-api.s#p02

家如果想要做单词翻译,可以看下,非常简单, 不过这个API 现在是收费了,新注册的用户会有 100 元的体验金。

接口的调用这里不细说,官方有很详细的说明,另外本例子会上传至 Github , 还不清楚可以去我的Github 查看。我们根据返回的 json 字符串生成了一个类 TranslateBean;然后通过 Gson 转化为TranslateBean对象。

好了,有了返回的数据以后,直接通过一个类似popupWindow展现即可。

(5)通过一个类似于PopupWindow来显示

涉及到的代码:

  /**
     * 显示一个Popwindow
     *
     * @param editor
     * @param result
     */
    private void showPopupBalloon(final Editor editor, final String result) {
        ApplicationManager.getApplication().invokeLater(new Runnable() {
            public void run() {
                LogUtil.thread();
                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);
            }
        });
    }

这个API,恩,我copy的源码,依然是不求记住,知道这有个类似的功能即可。

简单看一下,是通过创建一个JBPopupFactory,然后通过它创建一个HtmlTextBalloonBuilder,通过这个builder去设置各种参数,最后show。

ok,对于一个入门的例子,不要太强求对插件中这些API的掌握,还是那句话,等需要写了再去查,需要什么功能,哪怕到对应的插件中去copy源码都可以,当然也有文档:

有兴趣的可以整理各种类型的插件,比如弹出popupWindow,生成代码,生成文件类别的,然后对相关的API进行收集与整理。

四、插件部署

(1)、插件输出

Build –> Prepare Plugin Module… 生成插件。插件输出为 xxx.jar 包 或者 xxx.zip 包。

安装插件,这里就不讲了,在 Android Studio 插件开发详解一:入门练手 已经讲的很清楚了。

(2)插件演示

把插件安装在 Android Studio 后,重启 Android Studio ,就可以愉快的使用插件了

(3)插件上传到市场

插件上传到市场在这里就不讲了,详见 Android Studio 插件开发详解一:入门练手

五、总结

终于到了总结的环节,这么长的文章其实编写插件总结起来就几句话。

  • 下载Intellij IDEA,新建一个Intellij IDEA plugin的项目
  • 然后在里面new Action以及编写API
  • 点击prepare plugin生成jar,这个jar就可以用来安装了。

恩,就是这么简单,实践起来会比较麻烦一点,等成功以后,回过头来总结,发现步骤其实就那么几个步骤~~对于实际的Action相关的API,等你在编写相关插件的时候,参考别的类似插件,查看官方文档都可以。

最后所有的代码都将上传至:https://github.com/zyj1609wz/AndroidPluginTranslate

参考资料

学会编写Android Studio插件 别停留在用的程度了



个人微信号:zhaoyanjun125 , 欢迎关注

时间: 2024-09-13 11:14:28

Android Studio 插件开发详解三:翻译插件实战的相关文章

Android Studio 插件开发详解四:填坑

转载请标明出处:http://blog.csdn.net/zhaoyanjun6/article/details/78265540 本文出自[赵彦军的博客] 插件打包 坑一 id不能重复 坑二插件描述信息要完整 坑三插件支持的产品要说明 总结 在前面我介绍了插件开发的基本流程 [Android Studio 插件开发详解一:入门练手] [Android Studio 插件开发详解二:工具类] [Android Studio 插件开发详解三:翻译插件实战] 在经历的前面的3篇文章,我相信大家都可以

Android Studio 插件开发详解一:入门练手

转载请标明出处:http://blog.csdn.net/zhaoyanjun6/article/details/78112003 本文出自[赵彦军的博客] 一:概述 相信大家在使用Android Studio的时候,或多或少的会使用一些插件,适当的配合插件可以帮助我们提升一定的开发效率,更加快乐.例如: https://github.com/zzz40500/GsonFormat 可以帮助我们从Gson转化为实体类 https://github.com/avast/android-butter

Android Studio 版本号详解

Android Studio 版本号详解 转载请标明出处:http://blog.csdn.net/zhaoyanjun6/article/details/69951965 本文出自[赵彦军的博客] android { compileSdkVersion 25 //是指本地开发环境编译是时的 Android 版本 buildToolsVersion "25.0.2" //你构建工具的版本,其中包括了打包工具aapt.dx等等 defaultConfig { applicationId

百度语音识别(Baidu Voice) Android studio版本详解_Android

百度语音识别(Baidu Voice) Android studio版本       已同步更新至个人blog:http://dxjia.cn/2016/02/29/baidu-voice-helper/       最近在一个练手小项目里要用到语音识别,搜索了一下,比较容易集成的就算Baidu voice跟讯飞语音了,baidu提供了直接可以使用的显示控件,而讯飞需要自己实现,另外baidu提供每天5W次的调用频率,对于我来说足够使用啦.所以就选择使用Baidu Voice(控件会有baidu

百度语音识别(Baidu Voice) Android studio版本详解

百度语音识别(Baidu Voice) Android studio版本 已同步更新至个人blog:http://dxjia.cn/2016/02/29/baidu-voice-helper/ 最近在一个练手小项目里要用到语音识别,搜索了一下,比较容易集成的就算Baidu voice跟讯飞语音了,baidu提供了直接可以使用的显示控件,而讯飞需要自己实现,另外baidu提供每天5W次的调用频率,对于我来说足够使用啦.所以就选择使用Baidu Voice(控件会有baidu logo和关键字,所以

Android AOP 注解详解及简单使用实例(三)

Android  注解 相关文章: Android AOP注解Annotation详解(一) Android AOP之注解处理解释器详解(二) Android AOP 注解详解及简单使用实例(三) 一.简介 在Android 里面 注解主要用来干这么几件事: 和编译器一起给你一些提示警告信息. 配合一些ide 可以更加方便快捷 安全有效的编写Java代码.谷歌出的support-annotations这个库 就是主要干这个的. 和反射一起 提供一些类似于spring 可配置的功能,方便简洁. 二

Android Animation动画详解(二): 组合动画特效

前言     上一篇博客Android Animation动画详解(一): 补间动画 我已经为大家介绍了Android补间动画的四种形式,相信读过该博客的兄弟们一起都了解了.如果你还不了解,那点链接过去研读一番,然后再过来跟着我一起学习如何把简单的动画效果组合在一起,做出比较酷炫的动画特效吧. 一. 动画的续播     如题,大家想想,如果一个页面上包含了许多动画,这些动画要求按顺序播放,即一个动画播放完成后,继续播放另一个动画,使得这些动画具有连贯性.那该如何实现呢? 有开发经验或者是逻辑思维

Android Studio(二):快捷键设置、插件安装

Android Studio相关博客: Android Studio(一):介绍.安装.配置 Android Studio(二):快捷键设置.插件安装 Android Studio(三):设置Android Studio编码 Android Studio(四):Android Studio集成Genymotion Android Studio(五):修改Android Studio项目包名 Android Studio(六):Android Studio添加注释模板 Android Studio

Android Socket通信详解_Android

一.Socket通信简介  Android与服务器的通信方式主要有两种,一是Http通信,一是Socket通信.两者的最大差异在于,http连接使用的是"请求-响应方式",即在请求时建立连接通道,当客户端向服务器发送请求后,服务器端才能向客户端返回数据.而Socket通信则是在双方建立起连接后就可以直接进行数据的传输,在连接时可实现信息的主动推送,而不需要每次由客户端想服务器发送请求. 那么,什么是socket?Socket又称套接字,在程序内部提供了与外界通信的端口,即端口通信.通过