Unicode 和国际化支持

Android 利用 ICU 库 和 CLDR 项目 来提供 Unicode 和其他国际化支持。本页关于 Unicode 和国际化支持的讨论分为两部分：Android 6.0 (API 级别 23) 及更低版本，以及 Android 7.0 (API 级别 24) 及更高版本。

Android 6.0 (API 级别 23) 及更低版本的 Unicode 和国际化支持

Android 平台使用 ICU 和 CLDR 来实现用于处理拉丁语系和非拉丁语系文字的各种类，公开诸如 Locale、Character 和许多 java.text 子类的类。需要超出公开类的国际化功能，并且目标平台版本为 Android 6.0 (API 级别 23) 及更低版本的应用必须包含 ICU 库。

版本控制

Android 平台的后续版本对应于 ICU 的更新版本以及相应的 CLDR 和 Unicode 版本。表 1 显示了 Android 6.0 (API 级别 23) 及更低版本的此对应关系。

表 1. Android 6.0 (API 级别 23) 及更低版本中使用的 ICU 和 CLDR 版本。

面向 Android 7.0（API 级别 24）及更高版本的应用，Android 框架为 Unicode 和国际化提供了更全面的支持。本页面的下一部分将详细介绍该支持。

Android 7.0（API 级别 24）及更高版本中的 Unicode 和国际化支持

对于 Android 7.0（API 级别 24）及更高版本，Android 平台为应用开发者提供了一部分 ICU4J API，供其在 android.icu 包下使用。ICU4J 是一个开源的、广泛使用的 Java 库集，为软件应用程序提供 Unicode 和国际化支持。

ICU4J API 使用设备上存在的本地化数据。因此，您可以通过不将 ICU4J 库编译到您的应用中来减小应用的大小。相反，您可以调用框架中的这些库。如果您这样做，您可能需要提供 多个版本的 APK，以便运行低于 Android 7.0（API 级别 24）版本的 Android 用户可以下载包含 ICU4J 库的应用版本。

本节首先提供一些有关支持这些库所需的最低 Android API 级别的一些基本信息。然后解释您需要了解的有关 Android 特定 ICU4J 实现的信息。最后，它告诉您如何在 Android 框架中使用 ICU4J API。

Android 上的 ICU4J

Android 通过 android.icu 包而不是 com.ibm.icu 提供了一部分 ICU4J API。由于某些 API 已被弃用或未声明为稳定，因此 Android 框架未公开某些 ICU4J API。随着 ICU 团队在未来弃用 API，Android 也将其标记为已弃用，但仍会继续包含它们。

以下是一些提醒

• ICU4J Android 框架 API 不包含所有 ICU4J API。
• Android 框架中的 API 不会取代 Android 对 使用资源进行本地化 的支持。
• 在某些情况下，Android 框架支持的字符比 ICU 库多。例如，android.text 类对表情符号的支持就是这样。

从 com.ibm.icu 迁移到 android.icu 包

如果您已经在您的应用中使用 ICU4J API，并且 android.icu API 满足您的要求，那么迁移到框架 API 需要您将 Java 导入从 com.ibm.icu 更改为 android.icu。然后，您可以从应用中删除您自己的 ICU4J 文件副本。

注意：ICU4J 框架 API 使用 android.icu 命名空间而不是 com.ibm.icu。这样做是为了避免包含自身 com.ibm.icu 库的应用中的命名空间冲突。

从其他 Android SDK API 迁移到 android.icu API

java 和 android 包中的一些类与 ICU4J 中的类等效。但是，ICU4J 通常为标准和语言提供更广泛的支持。

表 2 显示了这些等效性的几个示例，以帮助您入门

表 2.Android 和 Java ICU4J 类

Android 上的 ICU4C

Android 通过 libicu.so 库而不是 libicuuc.so 或 libicui18n.so 公开了一部分 ICU4C API。这些 API 从 Android 12（API 级别 31）开始可用。NDK 标头从 NDK 版本 r22b 开始可用。没有通过 Android NDK 公开 C++ API。部分 C API 不可使用。

版本控制

Android 平台的后续版本对应于更新版本的 ICU，以及相应的 CLDR 和 Unicode 版本。表 3 显示了从 Android 7.0（API 级别 24）开始的对应关系。使用 VersionInfo.ICU_VERSION API（从 Android 7.0 开始可用）在运行时获取 ICU 版本信息。

表 3.从 Android 7.0（API 级别 24）到 Android 15（API 级别 35）的 Android 版本中使用的 ICU 和 CLDR 版本。

24 小时/12 小时时间格式设置

val skeleton: String = if (DateFormat.is24HourFormat(context)) "Hm" else "hm"
val formattedTime: String = android.icu.text.DateFormat.getInstanceForSkeleton(
        skeleton,
        Locale.getDefault()).format(Date()
)

String skeleton = DateFormat.is24HourFormat(context) ? "Hm" : "hm";
String formattedTime = android.icu.text.DateFormat.getInstanceForSkeleton(skeleton, Locale.getDefault()).format(new Date());

Transliterator 的稳定性

许可

ICU4J 在 ICU 许可下发布。有关详细信息，请参阅 ICU 用户指南。