Android深入PluginAndroid

开发Android studio 插件:项目国际化与Excel文

2021-09-10  本文已影响0人  lucasDev

开发一个将Android项目的国际化资源与Excel表格互导的插件


功能说明

当一个项目从非国际化(只有单言语类型)转向国际化(多语言支持)亦或项目过于庞大Module数量众多每期迭代都需要从各个Module抽取和填补翻译时就会有了个很烦恼的事情,这么多的语言资源靠手动整理那得到猴年马月,等整理完也练就了一双麒麟臂了。(以上纯属抱怨可忽略)😄

言归正传,如同以上机械式工作作为一名程序猿当然是交给程序去处理喽,所以需要写一个能够遍历读取识别并提取项目中的语言资源文件,并将资源导出成Excel文件以方便交给其他工具人(手动狗头)进行翻译的脚本,翻译完成后还需要将Excel文件转换成项目中的资源格式并原路存储进去。为了更加方便的在各个项目中使用当然还是把上面写的脚本套上Intellij plugin的皮囊一起食用更佳。

支持功能:

Tip:当前插件v1.0.1版本未经过大量测试,所以使用前务必先提交项目代码,以防不必要的损失。

安装使用方式

  1. 安装插件

在线搜索 "LangResExport"


image.png

插件jar包下载地址:https://github.com/LucasDevelop/LangTransExcel/blob/master/LangTransExcel-V1.0.1.zip
使用本地安装,随后重启IDE。

image.png
  1. 启动插件

打开Android stuido 菜单栏Tools->Android Lang Transform Exce

选择模式


image.png

点击OK后开始扫描项目中的资源。


image.png

导出:导出项目中国际化翻译资源到Excel表格
等待扫描结束后开始配置参数,参数会根据扫描项目的结果自动列出一存在的module和语言类型。可自行选择需要导出的module和语言类型。


image.png

配置完成点击OK,等待导出结果。


image.png

导入:将Excel表格中的资源导入到项目中
等待扫描结束后开始配置参数

image.png

<font color='red'>Tip:默认语言语种指的是values/strings.xml中语言类型</font>

点击OK等待导入完成即可。

  1. 查看导出的Excel文件

如果配置时选择的是文件夹那么生成Excel 文件为【国际化翻译.xls】固定名称。剩下的就是翻译的事情了。

插件开发流程

  1. 安装Intellij idea

下载地址:https://www.jetbrains.com/idea/ 安装最新的版本即可

  1. 新建一个Plugin项目

选择Gradle项目以方便依赖三方lib,并且勾选java/Intellij Platfrom Plugin, kotlin是否勾选看个人开发语言习惯。然后下一步。

image.png

填写项目名称以及地址

image.png
  1. 配置插件信息
image.png
  1. 创建java文件夹
image.png
  1. 配置Gradle

如果插件要可安装在最近android studio版本请务必配置红框内容,否则会导致无法安装在Android studio上。
intellij {
version = '2020.1' // 因为Android Studio 4.1是基于IDEA 2020.1 Community版本开发的,所以这里调试也指定为此版本
plugins = ['android']
}
patchPluginXml {
changeNotes = """
V1.0.0:实现基本双向导入功能.

<em></em>"""
sinceBuild = '191' // 插件适用的IDEA版本范围,此范围基本涵盖了Android Studio最近两三年的版本
untilBuild = '212.*'
}

image.png
  1. 创建插件入口,也就是为啥插件会在Tools->Android Lang Transform Excel上
image.png image.png
  1. 创建弹窗。
image.png

创建完弹窗后可看到以下界面,最右侧可选择控件并拖动到中间的布局中。

image.png
  1. 运行插件,查看效果
image.png

等待编译结束后会自动新开一个Idea程序窗口,在新开的窗口创建一个新项目或者选择一个项目进入。在新开的Idea窗口中找到我们的插件并打开。

image.png

最后效果如下:

image.png
  1. 打包插件并安装在android studio上

打开右侧Gradle任务栏,运行buildPlugin

image.png

等待编译结束后在build中找到我们的插件包

image.png

在Android studio中选择本地安装我们的插件,然后重启Android studio即可。
当然,我们也可以把插件发布到官网仓库然后供其他人安装使用,具体方式大家各自查找吧,这里不讲解了。

image.png

国际化资源与Excel互导脚本开发

主要是基于poi和dom4j的API进行文件操作,API 对应的Gradle依赖如下
implementation group: 'org.apache.poi', name: 'poi', version: '3.9'
// https://mvnrepository.com/artifact/org.dom4j/dom4j
implementation group: 'org.dom4j', name: 'dom4j', version: '2.1.1'
implementation group: 'jaxen', name: 'jaxen', version: '1.2.0'

image.png

具体文件查找Excel读取/写入实现代码已上传至gayhub,在下就不在这里指指点点了。相信各位大佬对于这种级别的API还是能把握住的。

插件和脚本源码地址:https://github.com/LucasDevelop/LangTransExcel

上一篇下一篇

猜你喜欢

热点阅读