引言
项目中遇到切换app语言
的需求,要求在“简体中文”和“English”两种语言之间切换部分控件的语言文案,不受系统语言切换的影响。
TODO Android资源管理机制
1.添加多语言资源文件
按照Android的资源管理方式,我们需要在res目录下建立两个values目录,其中values是默认的路径,values-en是英文资源的目录。
默认情况下,app启动会根据系统的设置加载对应的资源,系统切换了语言设置,app也会更新设置,所以这样不能完全满足我们的需求。
2.保持app语言设置,不受系统影响
我们不想要app随着系统语言的改变而改变,而是保持用户上一次的选择。默认安卓系统不会保留app的语言设置,我们需要本地记录一下用户的选择,在app重新启动的时候加载之前保存的语言资源。存储用户的选择比较容易,放到SharedPreference里即可。然后在app重新启动的时候,我们需要手动更新下app的Application、Activity、Fragment和Service收到的配置信息。
以Activity为例,我们在基类的attachBaseContext方法中更新保存有config信息的Context对象:
@Override
protected void attachBaseContext(Context newBase) {
super.attachBaseContext(ConfigurationUtil.attachBaseContext(newBase));
}
/**
* 覆写Activity的attachBaseContext方法,更新context语言设置
*
* @param context 上下文
* @return 更新后的context
*/
public static Context attachBaseContext(Context context) {
final Locale locale;
final Resources res = context.getResources();
final Configuration config = res.getConfiguration();
if (LuckyApplication.mAppLanguage == AppConstant.ENGLISH) {
locale = Locale.ENGLISH;
} else {
locale = Locale.SIMPLIFIED_CHINESE;
}
updateConfig(res, config, locale);
return context;
}
/**
* 更新资源配置
* 7.0之后官方建议context.createConfigurationContext(config);
*
* @param config Configuration对象
* @param locale Locale对象
*/
private static void updateConfig(Resources res, Configuration config, Locale locale) {
setLocale(config, locale);
res.updateConfiguration(config, res.getDisplayMetrics());
}
/**
* 修改configuration的locale信息
*
* @param config Configuration对象
* @param locale Locale对象
*/
private static void setLocale(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 处理配置变更,请在清单文件中编辑相应的 <activity> 元素,以包含 android:configChanges属性以及代表要处理的配置的值。
android:configChanges属性的文档中列出了该属性的可能值(最常用的值包括 "orientation" 和 "keyboardHidden",
分别用于避免因屏幕方向和可用键盘改变而导致重启)。
您可以在该属性中声明多个配置值,方法是用管道 `|` 字符分隔这些配置值。
<activity android:name=".MyActivity"
android:configChanges="orientation|keyboardHidden"
android:label="@string/app_name">
现在,当其中一个配置发生变化时,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设置。做法如下:
@Override
public void onConfigurationChanged(Configuration newConfig) {
ConfigurationUtil.updateResources(getResources());
super.onConfigurationChanged(newConfig);
}
/**
* 系统语言配置改变,会通知每一个app,当重新回到app时,会回调onConfigurationChanged,
* 但是此时,super内部的mResources变量为空,update方法调用不了,所以手动调用此方法
*
* @param res Resources对象
*/
public static void updateResources(Resources res) {
Configuration config = res.getConfiguration();
if (LuckyApplication.mAppLanguage == AppConstant.SIMPLIFIED_CHINESE && isEnglishLocale(config)) {
updateConfig(res, config, Locale.SIMPLIFIED_CHINESE);
} else if (LuckyApplication.mAppLanguage == AppConstant.ENGLISH && !isEnglishLocale(config)) {
updateConfig(res, config, Locale.ENGLISH);
}
}
/**
* 更新资源配置
* 7.0之后官方建议context.createConfigurationContext(config);
*
* @param config Configuration对象
* @param locale Locale对象
*/
private static void updateConfig(Resources res, Configuration config, Locale locale) {
setLocale(config, locale);
res.updateConfiguration(config, res.getDisplayMetrics());
}
/**
* 修改configuration的locale信息
*
* @param config Configuration对象
* @param locale Locale对象
*/
private static void setLocale(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 = new Intent(this, MainActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);
startActivity(intent);
/**
* 修改应用语言设置
*
* @param context 上下文
* @param lang 切换的语言
*/
public static void changeAppLanguage(Context context, int lang) {
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());
}