Android 12及以下AppCompatDelegate设置应用语言后通知与页面异常

问题核心 #

调用AppCompatDelegate.setApplicationLocales(LocaleListCompat.forLanguageTags("fr"))切换语言后，Android 12及以下版本出现两个关键问题：

• 推送通知始终显示默认语言（如德语"de"），但Activity重建后语言显示正常
• 用自定义上下文创建通知可临时解决通知语言问题，但该上下文生成的PendingIntent打开Activity时，页面出现默认语言与目标语言混杂的情况，重写Activity.attachBaseContext()无法修复

原因拆解 #

1. 系统版本差异：Android 13+原生支持应用级语言偏好，系统会自动同步所有组件的语言配置；但Android 12及以下，AppCompat的语言切换仅覆盖Activity等直接关联组件，NotificationManager等系统服务使用的是未更新的系统默认上下文，导致通知语言不生效。
2. 自定义上下文不同步：临时自定义上下文仅解决了通知的语言问题，但未与全局应用上下文的语言配置同步，用其创建PendingIntent时，Activity启动流程中上下文语言不一致，引发内容混杂。
3. Manifest配置隐患：虽然官方指南提到低版本可省略android:localeConfig，但该配置是AppCompat识别应用支持语言列表的关键，缺失可能导致语言偏好的持久化和组件间传递失效。

解决方案 #

1. 全局统一上下文语言（核心修复） #

通过自定义Application类，确保所有组件（包括通知、PendingIntent）使用的上下文都应用当前语言偏好：

public class MyApplication extends Application {
    @Override
    protected void attachBaseContext(Context base) {
        // 从SharedPreferences读取已保存的语言标签
        String savedLocale = getSharedPreferences("app_settings", MODE_PRIVATE)
                .getString("selected_locale", "de");
        LocaleListCompat targetLocales = LocaleListCompat.forLanguageTags(savedLocale);
        // 创建更新后的上下文
        Context updatedContext = AppCompatDelegate.createConfigurationContext(base, targetLocales);
        super.attachBaseContext(updatedContext);
    }
}

创建通知时直接使用全局Application上下文，无需自定义临时上下文：

Context appContext = getApplicationContext();
NotificationManager notificationManager = 
        (NotificationManager) appContext.getSystemService(Context.NOTIFICATION_SERVICE);

Notification notification = new NotificationCompat.Builder(appContext, NOTIFICATION_CHANNEL_ID)
        .setContentTitle(appContext.getString(R.string.notification_title))
        .setContentText(appContext.getString(R.string.notification_content))
        .setSmallIcon(R.drawable.ic_notification)
        .setContentIntent(createPendingIntent(appContext))
        .build();

2. 修复PendingIntent启动Activity的语言混杂问题 #

在创建PendingIntent时携带当前语言标签，并在Activity的attachBaseContext()中强制同步语言配置：

// 创建携带语言信息的Intent
private PendingIntent createPendingIntent(Context context) {
    String savedLocale = context.getSharedPreferences("app_settings", MODE_PRIVATE)
            .getString("selected_locale", "de");
    Intent intent = new Intent(context, TargetActivity.class);
    intent.putExtra("CURRENT_LOCALE", savedLocale);
    intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_NEW_TASK);
    
    return PendingIntent.getActivity(
            context,
            0,
            intent,
            PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
    );
}

在目标Activity中同步语言：

@Override
protected void attachBaseContext(Context base) {
    String targetLocale = getIntent().getStringExtra("CURRENT_LOCALE");
    if (targetLocale == null) {
        // 兜底从全局配置读取
        targetLocale = getSharedPreferences("app_settings", MODE_PRIVATE)
                .getString("selected_locale", "de");
    }
    LocaleListCompat locales = LocaleListCompat.forLanguageTags(targetLocale);
    Context updatedContext = AppCompatDelegate.createConfigurationContext(base, locales);
    super.attachBaseContext(updatedContext);
}

3. 修正Manifest配置 #

显式配置locale_config，帮助AppCompat准确管理语言偏好：

1. 在res/xml目录下创建locale_config.xml：

<?xml version="1.0" encoding="utf-8"?>
<locale-config xmlns:android="http://schemas.android.com/apk/res/android">
    <locale android:name="de"/>
    <locale android:name="fr"/>
    <!-- 添加应用支持的所有语言 -->
</locale-config>

2. 在Manifest的<application>标签中添加：

<meta-data
    android:name="android.app.locale_config"
    android:resource="@xml/locale_config"/>

同时确保AppLocalesMetadataHolderService配置正确：

<service
    android:name="androidx.appcompat.app.AppLocalesMetadataHolderService"
    android:enabled="false"
    android:exported="false">
    <meta-data
        android:name="android.app.locale_config"
        android:resource="@xml/locale_config"/>
</service>

验证步骤 #

1. 切换语言后重启应用，确认通知显示目标语言
2. 点击通知打开Activity，检查页面内容语言统一
3. 多次切换语言，验证所有场景下语言显示一致

内容的提问来源于stack exchange，提问作者Aaron