Поддержка Unicode и интернационализации

Android использует библиотеку ICU и проект CLDR для обеспечения поддержки Unicode и других интернационализаций. Обсуждение на этой странице поддержки Unicode и интернационализации разделено на два раздела: Android 6.0 (уровень API 23) и ниже и Android 7.0 (уровень API 24) и выше.

Поддержка Unicode и интернационализации через Android 6.0 (уровень API 23)

Платформа Android использует ICU и CLDR для реализации различных классов для обработки как латинской, так и нелатинской орфографии, предоставляя такие классы, как Locale , Character и многие подклассы java.text . Приложение, которому требуются функции интернационализации, выходящие за рамки представленных классов, и предназначенное для версий платформы до Android 6.0 (уровень API 23), должно включать библиотеку ICU.

Управление версиями

Последующие выпуски платформы Android соответствуют более новым версиям ICU и соответствующим версиям CLDR и Unicode. В таблице 1 показано это соответствие в Android 6.0 (уровень API 23).

Таблица 1. Версии ICU и CLDR, используемые в Android 6.0 (уровень API 23).

Платформа Android обеспечивает более полную поддержку Unicode и интернационализацию приложений, предназначенных для Android 7.0 (уровень API 24) и выше. В следующем разделе этой страницы представлена ​​подробная информация об этой поддержке.

Поддержка Unicode и интернационализации в Android 7.0 (уровень API 24) и выше.

Для Android 7.0 (уровень API 24) и более поздних версий платформа Android предоставляет разработчикам приложений подмножество API-интерфейсов ICU4J, которые они могут использовать в пакете android.icu . ICU4J — это широко используемый набор Java-библиотек с открытым исходным кодом, обеспечивающий поддержку Unicode и интернационализации для программных приложений.

API-интерфейсы ICU4J используют данные локализации, имеющиеся на устройстве. В результате вы можете уменьшить объем вашего приложения, не компилируя библиотеки ICU4J в свое приложение. Вместо этого вы можете обратиться к ним в рамках. В этом случае вам может потребоваться предоставить несколько версий вашего APK , чтобы пользователи, использующие версии Android ниже Android 7.0 (уровень API 24), могли загрузить версию приложения, содержащую библиотеки ICU4J.

Этот раздел начинается с предоставления некоторой базовой информации о минимальных уровнях Android API, необходимых для поддержки этих библиотек. Затем объясняется, что вам нужно знать о реализации ICU4J для Android. Наконец, здесь рассказывается, как использовать API-интерфейсы ICU4J в платформе Android.

ICU4J на Android

Android предоставляет подмножество API-интерфейсов ICU4J через пакет android.icu , а не через com.ibm.icu . Некоторые API-интерфейсы ICU4J не предоставляются платформой Android по таким причинам, как API-интерфейсы, которые устарели или не объявлены стабильными. Поскольку команда ICU в будущем откажется от API, Android также пометит их как устаревшие, но продолжит включать их.

Вот несколько напоминаний:

• API-интерфейсы платформы Android ICU4J не включают в себя все API-интерфейсы ICU4J.
• API-интерфейсы в платформе Android не заменяют поддержку Android для локализации с помощью ресурсов .
• В некоторых случаях платформа Android поддерживает больше символов, чем библиотеки ICU. Это относится, например, к поддержке эмодзи классом android.text .

Перейдите на пакет android.icu с com.ibm.icu.

Если вы уже используете API-интерфейсы ICU4J в своем приложении и API-интерфейсы android.icu соответствуют вашим требованиям, то для перехода на API-интерфейсы платформы вам потребуется изменить импорт Java с com.ibm.icu на android.icu . Затем вы можете удалить свою копию файлов ICU4J из приложения.

Примечание . API-интерфейсы платформы ICU4J используют пространство имен android.icu вместо com.ibm.icu . Это сделано для того, чтобы избежать конфликтов пространств имен в приложениях, содержащих собственные библиотеки com.ibm.icu .

Миграция на API android.icu из других API Android SDK.

Некоторые классы в пакетах java и android имеют эквиваленты классов в ICU4J. Однако ICU4J часто обеспечивает более широкую поддержку стандартов и языков.

В таблице 2 приведены некоторые примеры этих эквивалентов, которые помогут вам начать:

Таблица 2. Классы ICU4J для Android и Java

ICU4C на Android

Android предоставляет подмножество API-интерфейсов ICU4C через библиотеку libicu.so , а не libicuuc.so или libicui18n.so . API доступны начиная с Android 12 (уровень API 31). Заголовки NDK доступны, начиная с версии NDK r22b. API C++ не предоставляется через Android NDK. Некоторые API C недоступны.

Управление версиями

Последующие выпуски платформы Android соответствуют более новым версиям ICU и соответствующим версиям CLDR и Unicode. В таблице 3 показано это соответствие, начиная с Android 7.0 (уровень API 24). Используйте API VersionInfo.ICU_VERSION (доступен, начиная с Android 7.0), чтобы получить информацию о версии ICU во время выполнения.

Таблица 3. Версии ICU и CLDR, используемые в версиях Android от Android 7.0 (уровень API 24) до Android 15 (уровень API 35).

Настройка формата времени 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());

Стабильность транслитератора

Лицензирование

ICU4J выпускается под лицензией ICU. Подробную информацию см. в руководстве пользователя ICU .