语言本地化

引言

项目中遇到切换app语言的需求,要求在“简体中文”和“English”两种语言之间切换部分控件的语言文案,不受系统语言切换的影响。

TODO切换系统Configuration设置源码分析

TODOAndroid资源管理机制

1.添加多语言资源文件

1907329-db600030e92be706.png

values加后缀区分不同的语言资源

按照Android的资源管理方式,我们需要在res目录下建立两个values目录,其中values是默认的路径,values-en是英文资源的目录。

默认情况下,app启动会根据系统的设置加载对应的资源,系统切换了语言设置,app也会更新设置,所以这样不能完全满足我们的需求。

2.保持app语言设置,不受系统影响

我们不想要app随着系统语言的改变而改变,而是保持用户上一次的选择。默认安卓系统不会保留app的语言设置,我们需要本地记录一下用户的选择,在app重新启动的时候加载之前保存的语言资源。存储用户的选择比较容易,放到SharedPreference里即可。然后在app重新启动的时候,我们需要手动更新下app的Application、Activity、Fragment和Service收到的配置信息。

以Activity为例,我们在基类的attachBaseContext方法中更新保存有config信息的Context对象:

@OverrideprotectedvoidattachBaseContext(Context newBase){super.attachBaseContext(ConfigurationUtil.attachBaseContext(newBase));}/** * 覆写Activity的attachBaseContext方法,更新context语言设置 * *@paramcontext 上下文 *@return更新后的context */publicstaticContextattachBaseContext(Context context){finalLocale locale;finalResources res = context.getResources();finalConfiguration config = res.getConfiguration();if(LuckyApplication.mAppLanguage == AppConstant.ENGLISH) {        locale = Locale.ENGLISH;    }else{        locale = Locale.SIMPLIFIED_CHINESE;    }    updateConfig(res, config, locale);returncontext;}/** * 更新资源配置 * 7.0之后官方建议context.createConfigurationContext(config); * *@paramconfig Configuration对象 *@paramlocale Locale对象 */privatestaticvoidupdateConfig(Resources res, Configuration config, Locale locale){    setLocale(config, locale);    res.updateConfiguration(config, res.getDisplayMetrics());}/** * 修改configuration的locale信息 * *@paramconfig Configuration对象 *@paramlocale Locale对象 */privatestaticvoidsetLocale(Configuration config, Locale locale){if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {        config.setLocale(locale);    }else{        config.locale = locale;    }}

ConfigurationUtil.attachBaseContext(newBase)方法中更新newBase对象,使其中保存的Locale为我们自定义,而非系统的。当Activity被attach到window时,调用到此方法,便会加载我们想要的资源。这时如果手动修改了系统语言设置,然后从任务历史中切回我们的app时,栈中的所有Activity会被系统依照展示次序依次销毁重建(栈顶被销毁重建,退出到前一个页面时,前一个页面会被销毁重建)。由于Activity被销毁重建,会重新执行了生命周期方法,Activity的attachBaseContext方法也就会被重新执行到,所以系统的语言修改后,我们仍然可以正确地加载到我们自己设置的语言资源,所以从表面上看并没有受到系统修改的影响。

通常官方也是建议我们重启所有Activity的,这么做会销毁旧的资源数据,重新加载新的,安全方便。

官方描述:

如果应用在特定配置变更期间无需更新资源,并且因性能限制您需要尽量避免重启,则可声明 Activity 将自行处理配置变更,这样可以阻止系统重启 Activity。 注:自行处理配置变更可能导致备用资源的使用更为困难,因为系统不会为您自动应用这些资源。 只能在您必须避免 Activity 因配置变更而重启这一万般无奈的情况下,才考虑采用自行处理配置变更这种方法,而且对于大多数应用并不建议使用此方法。 要声明由 Activity 处理配置变更,请在清单文件中编辑相应的 元素,以包含 android:configChanges属性以及代表要处理的配置的值。android:configChanges属性的文档中列出了该属性的可能值(最常用的值包括"orientation"和"keyboardHidden",分别用于避免因屏幕方向和可用键盘改变而导致重启)。您可以在该属性中声明多个配置值,方法是用管道`|`字符分隔这些配置值。现在,当其中一个配置发生变化时,MyActivity不会重启。相反,MyActivity会收到对 onConfigurationChanged的调用。向此方法传递 Configuration对象指定新设备配置。您可以通过读取 Configuration中的字段,确定新配置,然后通过更新界面中使用的资源进行适当的更改。调用此方法时,Activity 的 Resources对象会相应地进行更新,以根据新配置返回资源,这样,您就能够在系统不重启 Activity 的情况下轻松重置 UI 的元素。

如果我们不希望在系统语言发生变化时重启Activity,需要在Manifest.xml文件中配置:android:configChanges="locale"即可。

这样做之后我们会在重新回到Activity的时候,进入回调方法public void onConfigurationChanged(Configuration newConfig) {...中去执行。其参数newConfig对象代表所有当前配置,而不仅仅是已经变更的配置。

3.运行时系统设置变更

需要注意:当我们修改系统语言设置后,系统会更新当前手机中所有正在运行的进程里的所有组件(分析在开篇的链接里有说明),所以这种情况下再次回到Activity,如果我们刷新UI,UI会使用系统的设置加载相应的资源文件。比如,

假设我们app设置为了简体中文(我们在Application中保存相应的flag,来判断系统的语言设置是否和app的设置一致或者发生了变化),如果系统由简体中文修改为了English,如果我们不做上述处理,刷新UI会加载英文资源。

这并不是我们想要的效果,所以我们需要在onConfigurationChanged回调中,再次更新Context中的Resources设置。做法如下:

@OverridepublicvoidonConfigurationChanged(Configuration newConfig){    ConfigurationUtil.updateResources(getResources());super.onConfigurationChanged(newConfig);}/** * 系统语言配置改变,会通知每一个app,当重新回到app时,会回调onConfigurationChanged, * 但是此时,super内部的mResources变量为空,update方法调用不了,所以手动调用此方法 * *@paramres Resources对象 */publicstaticvoidupdateResources(Resources res){    Configuration config = res.getConfiguration();if(LuckyApplication.mAppLanguage == AppConstant.SIMPLIFIED_CHINESE && isEnglishLocale(config)) {        updateConfig(res, config, Locale.SIMPLIFIED_CHINESE);    }elseif(LuckyApplication.mAppLanguage == AppConstant.ENGLISH && !isEnglishLocale(config)) {        updateConfig(res, config, Locale.ENGLISH);    }}/** * 更新资源配置 * 7.0之后官方建议context.createConfigurationContext(config); * *@paramconfig Configuration对象 *@paramlocale Locale对象 */privatestaticvoidupdateConfig(Resources res, Configuration config, Locale locale){    setLocale(config, locale);    res.updateConfiguration(config, res.getDisplayMetrics());}/** * 修改configuration的locale信息 * *@paramconfig Configuration对象 *@paramlocale Locale对象 */privatestaticvoidsetLocale(Configuration config, Locale locale){if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {        config.setLocale(locale);    }else{        config.locale = locale;    }}

上述方案并非完美结局问题,onConfigurationChanged方法调用之前getResource()有可能就会被调用多次,时序问题,加载出依据系统的语言设置的资源文件。(。>︿<)_θ,所以会有4的兜底方案。

4. 异常状况和兜底方案

TODO 切换语言并回到app,然后新建fragment并add,会有资源加载错误情况

我们在Activity的onConfigurationChanged方法更新过资源,貌似这里没有起作用。有种暴力的方式:

我们在getResources()方法中调用ConfigurationUtil.updateResources(getResources());,但是getResources()方法会被多次调用,每次调用会判断一次,并不是特别理想,不过可以及时刷新,再未找到更好的方法前也算是一种兜底的方案。

5.最后补充一点:

在切换的Activity中,我们最好重启一下所有的app,执行下方方法后,重新打开singleTask的MainActivity...

changeAppLanguage(this, flag);Intent intent =newIntent(this, MainActivity.class);intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);startActivity(intent);/** * 修改应用语言设置 * *@paramcontext 上下文 *@paramlang    切换的语言 */publicstaticvoidchangeAppLanguage(Context context,intlang){    Context appContext = context.getApplicationContext();    Resources resources = appContext.getResources();    Configuration config = resources.getConfiguration();if(lang == AppConstant.ENGLISH) {        setLocale(config, Locale.ENGLISH);    }else{        setLocale(config, Locale.SIMPLIFIED_CHINESE);    }    appContext.getApplicationContext().getResources().updateConfiguration(config, resources.getDisplayMetrics());}

链接:https://www.jianshu.com/p/e919cc40c0b0

转载于:https://www.jianshu.com/p/d2e4c6468a08

猜你喜欢

转载自blog.csdn.net/weixin_33973609/article/details/91244169
今日推荐