几需一行代码完成多语言切换

logo

背景

以前老是有开发者反馈我应用切换了语言,但是工具类获取的 string 却没有发生改变。其实这个问题很简单,你切换语言的 Context 只做用在了你的 Activity 上,并无对你的 Application 作一样的操做,知道了这点,那么解决问题就很简单了,为了省事,我给你们封装了 LanguageUtils,直接一行代码即可完成多语言的切换,相似微信的语言切换分分钟即可完成。java

使用

Gradle:android

implementation 'com.blankj:utilcode:latest_version'
复制代码

APIs

applySystemLanguage: 应用系统语言
applyLanguage      : 应用语言
复制代码

原理

若是咱们的应用不设置 android:configChanges="locale|layoutDirection",那么应用是跟随系统语言设置的变化而变化的,好比你应用适配了英语(values-en-rUS)和简体中文(values-zh-rCN),那么你去设置里切换成英语的话,返回到你应用中,你的 Activity 会从新建立一遍,把 Activity#Resource#Configuration#Locale 设置为当前系统语言,这样就达到了跟随系统语言设置的变化而变化,但 Application 并无重启,因此这就致使了一开说到的问题。git

要解决跟随系统变化这一点的话,只须要在 Activity#onCreate 的生命周期中把 Application#Resource#Configuration#Locale 设置为系统的 Locale 便可,那么系统的 Locale 怎么读取呢,知道以前屏幕适配方案的人应该也能想到这一方式:Resources.getSystem().getConfiguration().locale,这样,咱们的 Application 便也切换成了系统语言,注意更新 Locale 须要兼容下高版本,调用具体代码能够参照以下:github

private static void updateLanguage(Context context, Locale locale) {
    Resources resources = context.getResources();
    Configuration config = resources.getConfiguration();
    Locale contextLocale = config.locale;
    if (equals(contextLocale.getLanguage(), locale.getLanguage())
            && equals(contextLocale.getCountry(), locale.getCountry())) {
        return;
    }
    DisplayMetrics dm = resources.getDisplayMetrics();
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
        config.setLocale(locale);
        context.createConfigurationContext(config);
    } else {
        config.locale = locale;
    }
    resources.updateConfiguration(config, dm);
}
复制代码

那么若是是应用内切换语言呢?咱们能够仿照系统切换语言的方式,把咱们本身全部的 Activity 全关掉,而后启动首页的 Activity 便可,在打开的 Activity#onCreate 中把 ActivityApplicationLocale 都设置为咱们设置的语言便可,固然,这份设置是须要保存下来的,根据你的需求来肯定是要保存在服务端仍是本地。那么怎么关闭全部的 Activity 呢?咱们能够经过增长 Intent 的 flag 为 Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_CLEAR_TASK 便可,相关代码以下所示:bash

private static void applyLanguage(@NonNull final Locale locale, final String activityClassName, final boolean isFollowSystem) {
    if (isFollowSystem) {// 若是是跟随系统,那么 sp 就什么都不存
        SPUtils.getInstance().put(KEY_LOCALE, "");
    } else {// 不然把设置的语言保存下来,在 onCreate 中应用该语言
        String localLanguage = locale.getLanguage();
        String localCountry = locale.getCountry();
        SPUtils.getInstance().put(KEY_LOCALE, localLanguage + "$" + localCountry);
    }
    updateLanguage(Utils.getApp(), locale);// 更新 Application 的语言
    Intent intent = new Intent();
    String realActivityClassName// 若是传入的 activityClassName 为空,那么启动 launcher Activity。
            = TextUtils.isEmpty(activityClassName) ? getLauncherActivity() : activityClassName;
    intent.setComponent(new ComponentName(Utils.getApp(), realActivityClassName));
    intent.addFlags(
            Intent.FLAG_ACTIVITY_NEW_TASK
                    | Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_CLEAR_TASK
    );
    Utils.getApp().startActivity(intent);// 关闭其余 Activity 并启动 realActivityClassName 的 Activity
}

// 工具类调用此函数是在 ActivityLifecycleCallbacks#onActivityCreated 中
static void applyLanguage(@NonNull final Activity activity) {
    final String spLocale = SPUtils.getInstance().getString(KEY_LOCALE);// 获取保存的语言
    if (TextUtils.isEmpty(spLocale)) {// 为空说明是跟随系统走,那么更新系统语言便可
        Locale sysLocale = Resources.getSystem().getConfiguration().locale;
        updateLanguage(Utils.getApp(), sysLocale);
        updateLanguage(activity, sysLocale);
        return;
    }
    // 读取 sp 保存下来的语言并应用该语言
    String[] language_country = spLocale.split("\\$");
    if (language_country.length != 2) {
        Log.e("LanguageUtils", "The string of " + spLocale + " is not in the correct format.");
        return;
    }
    Locale settingLocale = new Locale(language_country[0], language_country[1]);
    updateLanguage(Utils.getApp(), settingLocale);
    updateLanguage(activity, settingLocale);
}
复制代码

基于以上分析:微信

  • 若是应用是跟随系统设置语言来切换的话,那么直接依赖个人工具类便可,它会自动帮你更新 Application 的语言。
  • 若是须要应用内切换语言的话,只需在你切换语言的地方调用 LanguageUtils.applyLanguage(Locale.你要设置的语言, "com.blankj.launcher.pkg.MainActivity/* 切换语言后你要跳转到的页面,若是为空,则启动应用的 launcher Activity */") 便可;
  • 若是须要应用内切换语言变为跟随系统设置语言,那么调用 LanguageUtils.applySystemLanguage(""/* 切换语言后你要跳转到的页面,若是为空,则启动应用的 launcher Activity */); 便可。

结语

功能其实很简单,但老是缺乏人能把它分析得透彻,从而作得很完美分享出来,但愿我此次的分享能让你看到这一点,从而提高你以后的技能。app

字节跳动大量招人中,欢迎向 blankj@qq.com 投递您的简历。函数

相关文章
相关标签/搜索