多语言字符串翻译工具

多语言字符串翻译工具

一 使用场景及工具路径

多语言字符串翻译工具的作用是将应用源码中的字符串资源文件自动翻译为需要的各语言并自动生成在各语言文件夹下。

以某应用 value 文件夹下的 strings.xml 为例，使用此翻译工具，可以将此文件中的各个字符串翻译为需要的语言，在当前工具目录自动生成各个语言文件夹(如values-ar、values-bn、values-it-rIT等)，并在各语言文件夹下生成翻译好的 strings.xml 文件。

二 使用方法

在命令终端进入工具所在目录，并输入指令 python3 translate_tool.py + 文件路径（相对路径或者绝对路径都可以）

以 BinderTest 举例，它的 string 资源文件的绝对路径为 /home/server/AndroidStudioProjects/BinderTest/app/src/main/res/values
/strings.xml，那么就在终端输入：

python3 translate_tool.py ../BinderTest/app/src/main/res/values/strings.xml

也可以将 strings.xml 拷贝到工具当前路径，那么就在终端输入：

python3 translate_tool.py strings.xml

翻译过程中会在终端显示每个翻译的字符串的名称以及翻译成对应语言的内容，最终会显示 Translate done! 表示翻译完成，翻译好的字符串文件会在工具当前目录的各语言文件夹下自动生成。

如需要增加翻译的语言，则需要修改工具目录中的 lang_map.json 文件，参照格式，左边为语言代码，右边为应用中语言对应的文件夹名。例如要增加日语，则修改如下：

 {
 ...
   "ms-MY": "values-ms-rMY",
   "tl-PH": "values-tl-rPH",
   "in-ID": "values-in-rID",
-  "bn": "values-bn"
+  "bn": "values-bn",
+  "ja": "values-ja"
 }

三 注意事项

3.1 如果在翻译过程中终端报错停止，一般都是由于翻译的字符串中带特殊符号导致

例： <string name="battery_low_percent_format_hybrid"><xliff:g id="percentage">%1$s</xliff:g> remaining, about <xliff:g id="time">%2$s</xliff:g> left based on your usage</string>，删除此行或者删除其中的 xliff:g 标签即 <string name="battery_low_percent_format_hybrid">%1$s remaining, about %2$s left based on your usage</string> ，再运行即可。

3.2 如果在翻译过程中显示翻译的字符串都为 NONE，则可能是由于谷歌翻译的 url 更改导致，此时需要在代码中更新谷歌翻译的 url

1）在浏览器打开谷歌翻译网址，https://translate.google.cn/ ，按 F12 打开开发者模式，在检测语言处输入 hello ，此时点击开发者模式中的 Network 标签，找到 Name 列表里最下面以 batchexecute 开头的选项点击，选择右方 Payload 标签，检查 From Data 中是否含有 hello 字符串，如含有，则准确无误，若不含有，则继续点击其他 batchexecute 开头的选项，找到含有 hello 字符串的即可。

2）将该 Headers 标签拉到最上方，找到 Request URL 的值，将这个值完整复制到 google_translate.py 中的 url 赋值处，具体为：

# request url
url = "https://translate.google.com.hk/_/TranslateWebserverUi/data/batchexecute?rpcids=rPsWke&source-path=%2F&f.sid=9119586283608393146&bl=boq_translate-webserver_20240924.08_p0&hl=zh-CN&soc-app=1&soc-platform=1&soc-device=1&_reqid=1634866&rt=c"

2）在代码编辑器打开工具目录中的 google_translate.py 文件，找到 form_data 赋值处

form_data = {
“f.req”: r"“”[[[“MkEWBc”,“[[”{}“,“en”,”{}“,true],[null]]”,null,“generic”]]]“”".format(
text, target_language)
}

如正常则保持原form_data 即可，如异常则将网页 Payload标签下的填写到此处，注意数组中需要翻译的字符串以及目标语言这两处改为{}

4）保存，再重新运行翻译工具即可