Android 应用多语言 LocaleList 重复异常解析与修复

在 android 应用中，当使用 `androidx.appcompat` 库管理应用内语言环境时，特定版本可能会因 `localelist` 构造函数接收到重复的语言环境而抛出 `illegalargumentexception: list[1] is a repetition` 异常。此问题通常在应用尝试设置的语言环境与系统语言环境存在重叠时触发，尤其是在 `bottomsheetdialog` 等组件显示时。解决方案是升级 `androidx.appcompat` 库至 `1.6.0-alpha02` 或更高版本。

理解 LocaleList 重复异常

java.lang.IllegalArgumentException: list[1] is a repetition 异常通常发生在 android.os.LocaleList 的构造函数中。LocaleList 用于表示用户偏好的语言环境列表，它要求列表中的每个语言环境都是唯一的。当尝试创建一个包含重复语言环境的 LocaleList 时，系统会抛出此异常。

在 Android 应用开发中，特别是在使用 androidx.appcompat 库来支持应用内语言切换（即应用程序特有的语言环境配置）时，此异常可能间歇性地出现。从堆栈跟踪可以看出，该异常发生在 androidx.appcompat.app.LocaleOverlayHelper.combineLocales 方法内部，随后通过 AppCompatDelegateImpl 传递，最终在 BottomSheetDialog 的初始化过程中被触发。这意味着当 AppCompatDelegate 尝试计算和应用应用程序的语言环境配置时，由于某种原因生成了一个包含重复项的语言环境列表。

异常的根本原因

经过分析，此问题是 androidx.appcompat 库中一个已知缺陷所致。具体来说，androidx.appcompat:appcompat 版本低于 1.6.0-alpha02 时，存在一个逻辑错误。当应用程序尝试设置一个语言环境，并且该语言环境恰好也是系统支持的语言环境之一时，LocaleOverlayHelper.combineLocales 方法在合并应用程序和系统语言环境列表时，可能会错误地生成一个包含重复语言环境的列表。

例如，如果您的应用支持英语、西班牙语和保加利亚语，并且用户的系统语言也包含其中一种（例如英语），那么在特定条件下，combineLocales 可能会在构建最终的 LocaleList 时将“英语”添加两次，从而触发 IllegalArgumentException。由于此问题与系统语言环境和应用设置的语言环境之间的交互有关，因此它可能难以复现，且仅在特定设备或用户配置下才会出现。

解决方案：升级 androidx.appcompat 库

解决此问题的最直接和有效的方法是升级 androidx.appcompat 库的版本。Google 已经识别并修复了此问题，修复版本从 1.6.0-alpha02 开始生效。建议升级到 1.6.0-alpha04 或任何后续的稳定版本，例如 1.6.0 稳定版或更高。

降重鸟

要想效果好，就用降重鸟。AI改写智能降低AIGC率和重复率。

113

查看详情

操作步骤：

1. 打开您的 Android 项目的 build.gradle 文件（通常是 app/build.gradle）。
2. 找到 dependencies 块。
3. 将 androidx.appcompat:appcompat 的版本更新到 1.6.0-alpha02 或更高版本。

示例代码（app/build.gradle）：

dependencies {
    // ... 其他依赖

    // 将此行更新为最新版本
    // 旧版本可能类似：implementation 'androidx.appcompat:appcompat:1.6.0-alpha01'
    implementation 'androidx.appcompat:appcompat:1.6.0-alpha04' // 建议更新到此版本或最新的稳定版
    // 或者使用最新的稳定版，例如：
    // implementation 'androidx.appcompat:appcompat:1.6.1'

    // ... 其他依赖
}

更新版本后，同步您的 Gradle 项目，并重新构建应用。这将确保您的应用使用的是修复了此问题的 appcompat 版本。

注意事项与最佳实践

• 及时更新依赖： 此案例强调了保持项目依赖库更新的重要性。库的更新不仅带来新功能，更重要的是修复了已知错误和安全漏洞，从而提高应用的稳定性和安全性。
• 查阅官方 Issue Tracker： 当遇到难以理解的崩溃或异常时，查阅相关库的官方 Issue Tracker（如 Google Issue Tracker）是一个非常有用的方法。许多问题都是社区或开发者已经遇到并报告过的，通常可以找到解决方案或进展。
• 理解 AppCompatDelegate 的作用： AppCompatDelegate 是 androidx.appcompat 库的核心组件之一，它负责为应用提供向后兼容的 UI 功能，包括主题、颜色、夜间模式以及本例中的应用内语言环境管理。了解其工作原理有助于诊断与兼容性相关的问题。
• 多语言测试： 对于支持多语言的应用，务必在不同的系统语言环境下进行充分测试，以确保语言切换和显示逻辑的正确性，并提前发现潜在的语言环境相关问题。

总结

IllegalArgumentException: list[1] is a repetition 异常是 androidx.appcompat 库早期版本在处理应用内语言环境时的一个特定缺陷。通过将 androidx.appcompat 库升级到 1.6.0-alpha02 或更高版本，可以有效解决此问题，提升应用在多语言环境下的稳定性和用户体验。开发者应养成定期检查并更新依赖库的习惯，并利用官方资源来诊断和解决开发中遇到的问题。

以上就是Android 应用多语言 LocaleList 重复异常解析与修复的详细内容，更多请关注php中文网其它相关文章！