App多语言实现

引言

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

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

TODO Android资源管理机制

1.添加多语言资源文件

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对象:

@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());
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,293评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,604评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,958评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,729评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,719评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,630评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,000评论 3 397
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,665评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,909评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,646评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,726评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,400评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,986评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,959评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,996评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,481评论 2 342

推荐阅读更多精彩内容