如何添加仅首次启动的WelcomeActivity，实现用户选择并切换全应用语言

嘿，我来帮你搞定这个需求！咱们分两个核心部分来实现：控制WelcomeActivity仅首次显示，以及让所有Activity同步切换语言。

一、让WelcomeActivity只在首次启动出现 #

我们可以用SharedPreferences来存储一个"是否首次启动"的标记，在应用的入口逻辑里做判断：

1. 先在应用的入口Activity（比如可以做个SplashActivity，或者直接在WelcomeActivity的onCreate里处理）添加判断逻辑：

// 获取SharedPreferences实例，用来存储启动标记
val appPrefs = getSharedPreferences("AppSettings", MODE_PRIVATE)
val isFirstLaunch = appPrefs.getBoolean("is_first_launch", true)

if (!isFirstLaunch) {
    // 不是首次启动，直接跳转到主页面
    startActivity(Intent(this, MainActivity::class.java))
    finish()
    return
}

2. 当用户在WelcomeActivity选完语言后，更新这个标记，确保下次启动不再进入Welcome页面：

// 用户选择语言后，保存"非首次启动"标记
appPrefs.edit().putBoolean("is_first_launch", false).apply()

二、实现全局语言同步切换 #

要让所有Activity的语言跟着用户选择走，需要保存用户的语言设置，并且在每个Activity启动时应用这个配置，或者切换后重启应用生效。

1. 保存用户选择的语言 #

在WelcomeActivity的按钮点击事件里，把选中的语言代码（比如"en"代表英语，"ar"代表阿拉伯语）存到SharedPreferences：

// 英语按钮点击事件
btnEnglish.setOnClickListener {
    saveSelectedLanguage("en")
    restartAppToApplyLanguage()
}

// 阿拉伯语按钮点击事件
btnArabic.setOnClickListener {
    saveSelectedLanguage("ar")
    restartAppToApplyLanguage()
}

// 工具方法：保存选中的语言
private fun saveSelectedLanguage(langCode: String) {
    getSharedPreferences("AppSettings", MODE_PRIVATE)
        .edit()
        .putString("selected_language", langCode)
        .apply()
}

2. 写一个全局语言配置工具类 #

这个工具类负责根据保存的语言代码，设置应用的Locale，兼容不同Android版本：

object LanguageConfig {
    fun applyCurrentLanguage(context: Context) {
        val appPrefs = context.getSharedPreferences("AppSettings", MODE_PRIVATE)
        val selectedLang = appPrefs.getString("selected_language", "en") ?: "en"
        
        val targetLocale = Locale(selectedLang)
        Locale.setDefault(targetLocale)
        
        val resources = context.resources
        val config = resources.configuration
        
        // 适配不同Android版本的语言设置方式
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            config.setLocale(targetLocale)
            context.createConfigurationContext(config)
        } else {
            config.locale = targetLocale
            resources.updateConfiguration(config, resources.displayMetrics)
        }
    }
}

3. 让所有Activity自动应用语言 #

最好的方式是创建一个BaseActivity，让所有业务Activity都继承它，在BaseActivity的onCreate里调用语言配置方法：

open class BaseActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        // 先应用语言配置，再执行父类onCreate
        LanguageConfig.applyCurrentLanguage(this)
        super.onCreate(savedInstanceState)
    }
}

4. 切换语言后重启应用 #

用户选完语言后，需要重启应用让语言设置全局生效，这里可以通过清空Activity栈并跳转到入口Activity实现：

private fun restartAppToApplyLanguage() {
    val restartIntent = Intent(this, SplashActivity::class.java)
    // 清空现有Activity栈，确保重启后是全新的状态
    restartIntent.flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK
    startActivity(restartIntent)
    finish()
}

三、额外注意点 #

• 记得把对应语言的字符串资源放在正确的目录：英语资源放values-en/strings.xml，阿拉伯语放values-ar/strings.xml，系统会自动匹配加载。
• 如果你的应用支持横竖屏切换，要在BaseActivity的onConfigurationChanged方法里重新调用语言配置方法，避免屏幕旋转后语言重置。

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