AndroidX 多语言切换踩坑：attachBaseContext()失效

Android

2023-10-11 15:57:13

AndroidX 多语言切换故障：深入剖析及解决方案

多语言切换的重要性

在全球化的移动应用市场中，多语言支持至关重要，它可以让开发者触达更广泛的用户群体，满足不同文化的需求。然而，在升级到 AndroidX 后，多语言切换功能出现了故障，让开发者十分头疼。

问题根源：AndroidX 中的 ContextThemeWrapper

AndroidX 库的 appcompat:1.2.0 版本引入了一个问题，它在 attachBaseContext() 方法中添加了一个 ContextThemeWrapper。这个封装导致了多语言切换的失效。

多语言实现原理

多语言切换通常通过设置特定的区域设置 (Locale) 来实现。在 Android 中，attachBaseContext() 方法负责加载和设置应用程序的上下文，包括区域设置。

问题表现

当在 AndroidX 中使用 attachBaseContext() 切换区域设置时，多语言切换会失效。这是因为 AndroidX 封装的 ContextThemeWrapper 覆盖了开发者设置的区域设置，导致应用程序仍然使用默认区域设置。

解决方案：手动封装 Context

为了解决这个问题，需要手动对 Context 进行封装。步骤如下：

protected void attachBaseContext(Context newBase) {
    super.attachBaseContext(MyContextWrapper.wrap(newBase, LocaleManager.getLocale(this)));
}

public static class MyContextWrapper extends ContextWrapper {

    public static ContextWrapper wrap(Context base, Locale locale) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            return new MyContextWrapper(base, locale);
        } else {
            return new MyContextWrapperLegacy(base, locale);
        }
    }

    // Android N 以上构造函数
    private MyContextWrapper(Context base, Locale locale) {
        super(base.createConfigurationContext(new Configuration(base.getResources().getConfiguration()).setLocale(locale)));
    }

    // Android N 以下构造函数
    private static class MyContextWrapperLegacy extends ContextWrapper {
        private final Locale mLocale;

        private MyContextWrapperLegacy(Context base, Locale locale) {
            super(base);
            mLocale = locale;
        }

        @Override
        public Resources getResources() {
            Resources res = super.getResources();
            Configuration config = res.getConfiguration();
            config.setLocale(mLocale);
            res.updateConfiguration(config, res.getDisplayMetrics());
            return res;
        }
    }
}

实际应用

在 AndroidManifest.xml 文件中，将应用程序主题设置为 MyContextWrapper：

<application android:name=".MyApplication"
    android:theme="@style/MyTheme">
</application>

结论

通过手动封装 Context，我们成功绕过了 AndroidX 中的封装限制，解决了多语言切换失效的问题。此解决方案适用于 appcompat:1.2.0 版本，后续版本可能需要进一步调整。

常见问题解答

为什么 AndroidX 的 ContextThemeWrapper 会覆盖区域设置？
AndroidX 的 ContextThemeWrapper 旨在对上下文进行额外的主题化，从而在保持应用程序主题一致性的同时应用特定的主题。然而，在 appcompat:1.2.0 版本中，它覆盖了区域设置，导致了多语言切换失效。
为什么需要手动封装 Context？
手动封装 Context 是因为 AndroidX 对 attachBaseContext() 方法的封装导致了问题。通过手动封装，我们可以控制区域设置的设置，从而确保多语言切换正常工作。
此解决方案适用于哪些 AndroidX 版本？
此解决方案适用于 AndroidX appcompat:1.2.0 版本。后续版本可能需要进行调整，以适应 AndroidX 库的更新。
是否可以使用其他方法来解决这个问题？
除了手动封装 Context 之外，还有一些变通的方法，如使用 LocaleManager 或 MultiDexApplication 类，但这些方法可能存在局限性或复杂性。
这个解决方案是否适用于所有多语言场景？
此解决方案解决了 AndroidX 多语言切换故障的问题，但不适用于所有多语言场景。例如，它不适用于动态加载的资源或库，这些资源或库可能需要额外的处理来支持多语言。