Android 多语言

ゝ一世哀愁。 2022-05-24 03:41 302阅读 0赞

![pexels-photo-268438][]

前段时间，刚换工作，因公司业务的关系，接触了 Android 多语言。

以前，从没考虑过国际化，所以对这块也是一知半解，借此机会就做一下整理。

### 多语言 ###

Android 的多语言实现，大部分工作都交给了 framwork 层的资源进程调度框架，对于应用层的开发来说非常简单，得益于 Android 独特的资源文件管理方式，代码可以不和资源关联，通过 R 文件提供的索引来间接引用某一资源，所有只要在特定文件夹内提供对应的资源供系统调用就行啦。  
简单来说，我们通常在 `res-values` 的`strings.xml` 或者 `arrays.xml`文件中提供字符串资源，这里是提供默认资源的地方。如果需要添加台湾繁体，则需要新建 `values-zh-rTW` 的文件夹，以及提供台湾繁体的字符串资源文件`strings.xml`。

![多语言][006tKfTcgy1fr1wbflj61j309c06bdfy.jpg]

`values` 文件夹的名称规则是 `values-语言-地区` ，更多名称见下面的附录。

注意：不同语言的字符串资源的名称要一样，即索引要相同。

//默认的中文资源
    <resources>
        <string name="app_language">语言</string>
    </resources>
    
    //台湾繁体资源
    <resources>
        <string name="app_language">語言</string>
    </resources>

如果在需要的资源目录下找不到对应的资源 ID，就会到默认文件夹内寻找，如果还找不到，就会报错。

### 全局查找替换 ###

如果整个项目代码非常规范，所有的字符串资源都放在了`strings.xml` 或者`arrays.xml`中，那多语言就非常省心了。

但往往事与愿违，这个项目在我之前，已经经手四五个人了，编码风格迥异，代码规范就是没有规范，更加谈不上什么架构模式了、性能优化啦，所有东西都很随意，哎，都是泪~

说回正题，因此项目的字符串资源一部分在 `strings.xml` 中，更多的是散落在项目的各个角落，因此，第一步就是要将字符串资源统一整合到 `strings.xml` 或者 `arrays.xml`中。

刚开始还想着偷懒，写个脚本，寻找所有 xml 文件中的 `android:text="xxxx"` 然后替换，但项目中不仅仅是系统控件，还有一些自定义控件，命名空间和名称都不相同，如果是仅仅通过中文字符串匹配，那么一些注释怎样排除呢？同时代码中也有很多字符串，也有很多注释…….考虑到这么多复杂场景，如果哪位大牛能把这个脚本写出来，造福所有 Android 开发者，那就好啦~  
算了，还是自己手动一个个替换吧~  
打开全局搜索面板，输入 中文字符串的正则匹配

^((?!(\*|//)).)+[\u4e00-\u9fa5]

还可以根据需要进行过滤等操作。

![全局搜索中文字符串][006tKfTcgy1fr1wbc59lgj30ph0k677o.jpg]

如果找到字符串，那么 AS 提供了非常方便的替换字符串的操作。  
将光标移动到字符串位置，按下智能提示的快捷键（我的因按键冲突改过快捷键），选择`Extract string resource` 就能自动帮你完成操作了。这里盗了一个图，来看看效果。

![extract\_resource][extract_resource]

### 翻译 ###

如果将所有字符串资源都规范的整合到`strings.xml` 中，那么有很多插件，能帮我们一键完成翻译的工作。

比如：[AndroidLocalizationer][] 、[BaiduTranslationInternationalizatio][]  
这个插件虽好，但也存在不少问题，首先是字符串中出现一些特殊字符，那么翻译出来就会大段大段错位，还是得手动一个个修改回去，非常麻烦。

因为是将简体中文翻译成繁体，所有有一个非常方便的方法，就是直接将`strings.xml` 中的内容扔进谷歌翻译，什么特殊字符啥的都不用担心，当然，这种方式仅限于简体转繁体。

![google 翻译][google]

当然，机器翻译都有一个问题，就是翻译都比较生硬。区域的不同导致同一个东西的叫法也有差异，比如内地人说「软件」，但台湾人习惯说「软体」。所以简繁体翻译并没有想象的那么简单，这里提供一个比较智能的简体与繁体转换的网站 [简/繁体转换][Link 1] ，效果比谷歌好很多。  
相对于「简/繁体转换」，「中/英文转换」存在的问题就更多了，不仅仅是翻译正确与否的问题，字符串长度的变化还会引起页面排版的变化。  
因此，相对好的做法就是先用机器翻译，然后人工核对翻译，最后运行起来看看排版效果，如果不行就再做调整。

### 多语言切换 ###

这里的语言切换类似微信，是应用内的语言切换，和系统语言无关。

参照 [Android 开发者官网][Android] 上的描述，Configuration 包含了设备的所有的配置信息，这些配置信息会影响应用获取的资源。例如 string 资源，就是根据 Configuration 的 locale 属性来判断该取哪种语言的 string 资源，默认是 value 文件夹下的。

主要代码如下：

Resources resources = context.getResources();
            Configuration config = resources.getConfiguration();//获得设置对象
            DisplayMetrics dm = resources.getDisplayMetrics();//获得屏幕参数：主要是分辨率，像素等。
            config.locale = Locale.ENGLISH;//设置为英文
            resources.updateConfiguration(config, dm);

在设置完语言后，并不会马上生效，必须重新启动页面。大多数都是做法是直接退出整个 APP，然后重新启动，这种做法有点粗暴，体检不好，微信的做法是重启回到主页面。

Intent intent = new Intent();
            intent.setAction("android.intent.action.VIEW");
            intent.setData(Uri.parse("app://trade"));
            intent.setPackage(getPackageName());    //隐式启动时，最好指定包名
            intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK | //清空当前栈
                            Intent.FLAG_ACTIVITY_NEW_TASK | //启动新栈
                            Intent.FLAG_ACTIVITY_CLEAR_TOP); // 清除当前页面
            startActivity(intent);

项目因为组件化，这里采用隐式启动，但是这里有一个坑，因为保不齐，手机里面会有其符合要求的 Activity ，因此最好指定包名。

如果应用更改了语言，退出后再进来，还是会跟随系统，所有可以将语言类型用 SP 存起来，在刚刚进来时初始化语言。

我遇到一个问题是，在 application 中初始化语言不生效？？？ 只好又拿到 欢迎页去初始化了。  
还有就是更换语言后，在 webview 页面退出来后会失效，因此只能在 `onPoause()` 时重新设置语言。

### 附录 ###

#### 多国语言文件夹命名对应表 ####

<table> 
 <thead> 
  <tr> 
   <th>国家</th> 
   <th>Folder Name</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>中文（中国）</td> 
   <td>values-zh-rCN</td> 
  </tr> 
  <tr> 
   <td>中文（台湾）</td> 
   <td>values-zh-rTW</td> 
  </tr> 
  <tr> 
   <td>中文（香港）</td> 
   <td>values-zh-rHK</td> 
  </tr> 
  <tr> 
   <td>英语（美国）</td> 
   <td>values-en-rUS</td> 
  </tr> 
  <tr> 
   <td>英语（英国）</td> 
   <td>values-en-rGB</td> 
  </tr> 
  <tr> 
   <td>英文（澳大利亚）</td> 
   <td>values-en-rAU</td> 
  </tr> 
  <tr> 
   <td>英文（加拿大）</td> 
   <td>values-en-rCA</td> 
  </tr> 
  <tr> 
   <td>英文（爱尔兰）</td> 
   <td>values-en-rIE</td> 
  </tr> 
  <tr> 
   <td>英文（印度）</td> 
   <td>values-en-rIN</td> 
  </tr> 
  <tr> 
   <td>英文（新西兰）</td> 
   <td>values-en-rNZ</td> 
  </tr> 
  <tr> 
   <td>英文（新加坡）</td> 
   <td>values-en-rSG</td> 
  </tr> 
  <tr> 
   <td>英文（南非）</td> 
   <td>values-en-rZA</td> 
  </tr> 
  <tr> 
   <td>阿拉伯文（埃及）</td> 
   <td>values-ar-rEG</td> 
  </tr> 
  <tr> 
   <td>阿拉伯文（以色列）</td> 
   <td>values-ar-rIL</td> 
  </tr> 
  <tr> 
   <td>保加利亚文</td> 
   <td>values-bg-rBG</td> 
  </tr> 
  <tr> 
   <td>加泰罗尼亚文</td> 
   <td>values-ca-rES</td> 
  </tr> 
  <tr> 
   <td>捷克文</td> 
   <td>values-cs-rCZ</td> 
  </tr> 
  <tr> 
   <td>丹麦文</td> 
   <td>values-da-rDK</td> 
  </tr> 
  <tr> 
   <td>德文（奥地利）</td> 
   <td>values-de-rAT</td> 
  </tr> 
  <tr> 
   <td>德文（瑞士）</td> 
   <td>values-de-rCH</td> 
  </tr> 
  <tr> 
   <td>德文（德国）</td> 
   <td>values-de-rDE</td> 
  </tr> 
  <tr> 
   <td>德文（列支敦士登）</td> 
   <td>values-de-rLI</td> 
  </tr> 
  <tr> 
   <td>希腊文</td> 
   <td>values-el-rGR</td> 
  </tr> 
  <tr> 
   <td>西班牙文（西班牙）</td> 
   <td>values-es-rES</td> 
  </tr> 
  <tr> 
   <td>西班牙文（美国）</td> 
   <td>values-es-rUS</td> 
  </tr> 
  <tr> 
   <td>芬兰文（芬兰）</td> 
   <td>values-fi-rFI</td> 
  </tr> 
  <tr> 
   <td>法文（比利时）</td> 
   <td>values-fr-rBE</td> 
  </tr> 
  <tr> 
   <td>法文（加拿大）</td> 
   <td>values-fr-rCA</td> 
  </tr> 
  <tr> 
   <td>法文（瑞士）</td> 
   <td>values-fr-rCH</td> 
  </tr> 
  <tr> 
   <td>法文（法国）</td> 
   <td>values-fr-rFR</td> 
  </tr> 
  <tr> 
   <td>希伯来文</td> 
   <td>values-iw-rIL</td> 
  </tr> 
  <tr> 
   <td>印地文</td> 
   <td>values-hi-rIN</td> 
  </tr> 
  <tr> 
   <td>克罗里亚文</td> 
   <td>values-hr-rHR</td> 
  </tr> 
  <tr> 
   <td>匈牙利文</td> 
   <td>values-hu-rHU</td> 
  </tr> 
  <tr> 
   <td>印度尼西亚文</td> 
   <td>values-in-rID</td> 
  </tr> 
  <tr> 
   <td>意大利文（瑞士）</td> 
   <td>values-it-rCH</td> 
  </tr> 
  <tr> 
   <td>意大利文（意大利）</td> 
   <td>values-it-rIT</td> 
  </tr> 
  <tr> 
   <td>日文</td> 
   <td>values-ja-rJP</td> 
  </tr> 
  <tr> 
   <td>韩文</td> 
   <td>values-ko-rKR</td> 
  </tr> 
  <tr> 
   <td>立陶宛文</td> 
   <td>valueslt-rLT</td> 
  </tr> 
  <tr> 
   <td>拉脱维亚文</td> 
   <td>values-lv-rLV</td> 
  </tr> 
  <tr> 
   <td>挪威博克马尔文</td> 
   <td>values-nb-rNO</td> 
  </tr> 
  <tr> 
   <td>荷兰文(比利时)</td> 
   <td>values-nl-BE</td> 
  </tr> 
  <tr> 
   <td>荷兰文（荷兰）</td> 
   <td>values-nl-rNL</td> 
  </tr> 
  <tr> 
   <td>波兰文</td> 
   <td>values-pl-rPL</td> 
  </tr> 
  <tr> 
   <td>葡萄牙文（巴西）</td> 
   <td>values-pt-rBR</td> 
  </tr> 
  <tr> 
   <td>葡萄牙文（葡萄牙）</td> 
   <td>values-pt-rPT</td> 
  </tr> 
  <tr> 
   <td>罗马尼亚文</td> 
   <td>values-ro-rRO</td> 
  </tr> 
  <tr> 
   <td>俄文</td> 
   <td>values-ru-rRU</td> 
  </tr> 
  <tr> 
   <td>斯洛伐克文</td> 
   <td>values-sk-rSK</td> 
  </tr> 
  <tr> 
   <td>斯洛文尼亚文</td> 
   <td>values-sl-rSI</td> 
  </tr> 
  <tr> 
   <td>塞尔维亚文</td> 
   <td>values-sr-rRS</td> 
  </tr> 
  <tr> 
   <td>瑞典文</td> 
   <td>values-sv-rSE</td> 
  </tr> 
  <tr> 
   <td>泰文</td> 
   <td>values-th-rTH</td> 
  </tr> 
  <tr> 
   <td>塔加洛语</td> 
   <td>values-tl-rPH</td> 
  </tr> 
  <tr> 
   <td>土耳其文</td> 
   <td>values–r-rTR</td> 
  </tr> 
  <tr> 
   <td>乌克兰文</td> 
   <td>values-uk-rUA</td> 
  </tr> 
  <tr> 
   <td>越南文</td> 
   <td>values-vi-rVN</td> 
  </tr> 
 </tbody> 
</table>

### 参考 ###

[Android实现多语言so easy][Android_so easy]

[Android-国际化(多语言)切换详解及实例][Android-]

[Android（国际化）多语言的实现和切换][Android 1]

[Android App 多语言切换][Android App]

[pexels-photo-268438]: https://ws3.sinaimg.cn/large/006tKfTcgy1fr1wb9r3p8j30hs0but9x.jpg
[006tKfTcgy1fr1wbflj61j309c06bdfy.jpg]: https://ws3.sinaimg.cn/large/006tKfTcgy1fr1wbflj61j309c06bdfy.jpg
[006tKfTcgy1fr1wbc59lgj30ph0k677o.jpg]: https://ws2.sinaimg.cn/large/006tKfTcgy1fr1wbc59lgj30ph0k677o.jpg
[extract_resource]: https://ws4.sinaimg.cn/large/006tKfTcgy1fr1wbgqc9uj30hw0df3z5.jpg
[AndroidLocalizationer]: https://github.com/westlinkin/AndroidLocalizationer
[BaiduTranslationInternationalizatio]: https://github.com/13671447200/BaiduTranslationInternationalization
[google]: https://ws4.sinaimg.cn/large/006tKfTcgy1fr1wbev7ovj310u0hcgqy.jpg
[Link 1]: https://brushes8.com/zhong-wen-jian-ti-fan-ti-zhuan-huan
[Android]: http://developer.android.com/reference/android/content/res/Configuration.html
[Android_so easy]: http://www.cnblogs.com/angel88/p/7967853.html
[Android-]: http://www.jcodecraeer.com/a/anzhuokaifa/2017/1017/8600.html
[Android 1]: https://blog.csdn.net/myth13141314/article/details/62037194
[Android App]: https://jaeger.itscoder.com/android/2016/05/14/switch-language-on-android-app.html