美文网首页
App多语言实现

App多语言实现

作者: ZenCabin | 来源:发表于2019-01-30 19:06 被阅读26次

关于切换系统Configuration设置源码分析

项目中遇到“切换app语言”的需求,要求在“简体中文”和“English”两种语言之间切换部分控件的资源语言类型即可。

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

TODO Android资源管理机制

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

默认情况下,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对象代表所有当前配置,而不仅仅是已经变更的配置。

需要注意:当我们修改系统语言设置后,系统会更新当前手机中所有正在运行的进程里的所有组件(分析在开篇的链接里有说明),所以这种情况下再次回到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;
    }
}

我们也可以在getResources()方法中刷新调用ConfigurationUtil.updateResources(getResources());,但是getResources()方法会被调用很多次,所以在这里更新Resources并不是很合适。

相关文章

网友评论

      本文标题:App多语言实现

      本文链接:https://www.haomeiwen.com/subject/uxgcsqtx.html