App多语言实现

引言

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

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

TODO Android资源管理机制

1.添加多语言资源文件

《App多语言实现》 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());
}
    原文作者:ZenCabin
    原文地址: https://www.jianshu.com/p/e919cc40c0b0
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞