Android Studio 多语言助手插件：让多语言管理变得简单高效

// 根工程：创建 DSL 扩展并自动为子模块应用插件
if (project == project.getRootProject()) {
project.getExtensions().create("multilingual", MultilingualExtension.class, project);
// 自动为 Android 模块应用插件
project.getRootProject().getSubprojects().forEach(sub -> {
if (sub.getPlugins().hasPlugin("com.android.application") ||
sub.getPlugins().hasPlugin("com.android.library")) {
sub.getPlugins().apply(MultilingualModulePlugin.class);
}
});
}

这种设计让插件可以：

自动识别 Android 模块
为每个模块自动注册任务
支持多模块项目

3. 灵活的配置系统

插件支持多层次的配置方式，优先级清晰：

命令行参数（最高优先级）
Gradle 扩展配置
任务属性
默认值

这种设计让插件既可以在 UI 中使用，也可以在 CI/CD 流程中通过命令行调用。

4. 基于 Apache POI 的 Excel 处理

使用 Apache POI 5.2.3 进行 Excel 文件的读写，支持：

大文件的处理
复杂格式的保持
高效的读写性能

带来的好处

1. 大幅提升工作效率

传统方式：

导出：手动复制 XML 内容到 Excel（30 分钟）
翻译：在 Excel 中翻译（数小时，取决于语言数量）
导入：手动复制 Excel 内容回 XML（30 分钟）
总计：每个版本至少需要 1 小时以上的重复劳动

使用插件后：

导出：点击菜单，配置参数，一键导出（1 分钟）
翻译：在 Excel 中翻译（时间不变，但更专注）
导入：点击菜单，选择文件，一键生成（1 分钟）
总计：每个版本节省 1 小时以上

2. 显著降低出错率

避免复制粘贴错误：不再需要手动复制粘贴，减少人为错误
格式自动保证：生成的 XML 文件符合 Android 规范
Key 一致性检查：导入时会检查 key 的一致性
增量更新支持：可以只更新部分翻译，避免覆盖已有内容

3. 提升团队协作效率

统一的工作流程：团队成员使用相同的工具和流程
版本控制友好：Excel 文件可以纳入版本控制，方便跟踪翻译变更
翻译人员友好：翻译人员只需要在 Excel 中工作，不需要了解 Android 项目结构

4. 支持持续集成

插件支持通过 Gradle 命令行调用，可以集成到 CI/CD 流程中：

# 在 CI 中自动生成翻译文件
./gradlew :app:generateTranslations \
-PexcelFilePath=translations/latest.xlsx \
-PdefaultLanguage=zh-rCN

使用场景

场景二：已有项目的翻译更新

客户要求修改某些文本
更新 values/strings.xml 中的内容
导出到 Excel，只导出变更的部分
翻译人员更新 Excel
使用"指定语言比对导入"模式，只更新匹配的翻译

场景三：新增语言支持

导出现有所有语言的翻译到 Excel
在 Excel 中新增一列，添加新语言代码
翻译人员翻译新语言列
使用插件生成新语言的 strings.xml 文件

安装和使用

安装插件

打开 Android Studio
进入 File -> Settings -> Plugins（Windows/Linux）或 Preferences -> Plugins（macOS）
点击右上角的 ⚙️ 图标，选择 Install Plugin from Disk...
选择插件 ZIP 文件（项目根目录下的 studio-plugin-language-0.1.0.zip）
重启 Android Studio

使用步骤

导出到 Excel

点击菜单栏 Tools -> 多语言助手 -> 导出到excel
配置参数：
- 导出目录：Excel 文件保存位置（默认：buildSrc/language）
- 基准语言目录：用于生成 Key/默认列的目录（默认：values）
- 文件命名模式：支持时间戳变量（如：language-yyyyMMdd-HHmm.xlsx）
- 包含语言：可选，留空表示导出所有语言
点击 OK 执行导出

从 Excel 生成翻译文件

点击菜单栏 Tools -> 多语言助手 -> 生成xml文件
选择导入模式：
- 指定语言比对导入：根据基准语言文本匹配 key
- 首列 key 对比导入：根据 Excel 首列 key 匹配
配置参数：
- Excel 文件路径：选择要导入的 Excel 文件
- 基准语言目录：基准语言资源目录
- Key 处理方式：跳过新 key 或插入新 key
点击 OK 执行导入