按应用设定的语言偏好设置  

在许多情况下，多语言用户会将其系统语言设置为某一种语言（例如英语），但又想为特定应用选择其他语言（例如荷兰语、中文或印地语）。为了帮助应用为这些用户提供更好的体验，Android 13 针对支持多种语言的应用引入了以下功能：

系统设置，可让用户在一个位置为各个应用选择首选语言。

您的应用必须在应用的清单中声明 android:localeConfig 属性，以告知系统它支持多种语言。如需了解详情，请参阅有关创建资源文件并在应用的清单文件中声明资源的说明。

使应用可在运行时设置在界面中使用的其他语言的 API。

使用自定义应用内语言选择器的应用应当使用这些新 API，以确保无论用户通过何种方式选择其语言偏好设置，都能获得一致的用户体验。新的 API 还有助于减少样板代码量、支持拆分 APK，并且支持应用自动备份，以存储应用级的用户语言设置。

为了向后兼容以前的 Android 版本，AndroidX 中也提供了相应 API。我们建议使用 Appcompat 1.6.0-alpha04 或更高版本。

不支持多种语言的应用不受这些变更的影响。

下表根据不同的用例展示了推荐的实现方式。

Android 13 在手机设置中新增了一个集中设置选项，用于设置各应用语言偏好设定。为了确保在搭载 Android 13 的设备上，在系统设置中可以配置应用的语言，请创建一个 locales_config XML 文件，并使用 android:localeConfig 属性将其添加到应用的清单中。省略 android:localeConfig 清单条目表明用户不应该能够在他们的手机设置中独立于系统语言来设置您的应用语言。

若要将应用支持的语言添加到用户的手机设置中，请执行以下操作：

创建一个名为 res/xml/locales_config.xml 的文件，并指定您的应用的语言，如下所示：

在清单中，添加一行指向这个新文件的代码：

通过应用设置访问

设置 > 应用 >（选择一款应用）> 语言

在测试应用时，有一些已知问题需要注意。

对于具有或想要使用应用内语言选择器的应用，请使用这些新 API（而非自定义应用逻辑）来处理相关设置和获取用户对应用的首选语言设置。

为了向后兼容以前的 Android 版本，强烈建议使用 AndroidX 支持库来实现应用内语言选择器。不过，如有需要，您也可以直接实现框架 API。

使用 Appcompat 1.6.0-alpha04 或更高版本中的 setApplicationLocales() 方法。

例如，如需设置用户的首选语言，您需要让用户在语言选择器中选择语言区域，然后在系统中设置该值：

如需支持搭载 Android 12（API 级别 32）及更低版本的设备，请在应用的 AppLocalesMetadataHolderService 服务的清单条目中将 autoStoreLocales 值设置为 true 并将 android:enabled 设置为 false，以指示 AndroidX 处理语言区域存储空间，如以下代码段所示：