Obsługa kodowania Unicode i internacjonalizacji

Android korzysta z biblioteki ICU i projektu CLDR, aby zapewniać obsługę Unicode i innych funkcji związanych z międzynarodowością. Informacje na tej stronie dotyczące obsługi Unicode i międzynarodowości są podzielone na 2 sekcje: Android 6.0 (poziom interfejsu API 23) i starsze oraz Android 7.0 (poziom interfejsu API 24) i nowsze.

Obsługa Unicode i międzynarodowości do Androida 6.0 (poziom interfejsu API 23)

Platforma Androida korzysta z bibliotek ICU i CLDR do implementowania różnych klas, które obsługują ortografię zarówno łacińską, jak i niełacińską, udostępniając klasy takie jak Locale, Character i wiele podklas java.text. Aplikacja, która wymaga funkcji związanych z międzynarodowością wykraczających poza udostępnione klasy i jest kierowana na wersje platformy do Androida 6.0 (poziom interfejsu API 23), musi zawierać bibliotekę ICU.

Obsługa wersji

Kolejne wersje platformy Android odpowiadają nowszym wersjom ICU oraz odpowiednim wersjom CLDR i Unicode. Tabela 1 pokazuje tę korespondencję w Androidzie 6.0 (poziom API 23).

Tabela 1. Wersje ICU i CLDR używane do Androida 6.0 (poziom interfejsu API 23).

Platforma Androida zapewnia bardziej kompleksową obsługę Unicode i międzynarodowościowości w przypadku aplikacji kierowanych na Androida 7.0 (poziom interfejsu API 24) i nowszych. W następnej sekcji tej strony znajdziesz szczegółowe informacje o tej usłudze.

Obsługa Unicode i międzynarodowościowości w Androidzie 7.0 (poziom interfejsu API 24) i nowszych wersjach

W przypadku Androida 7.0 (poziom interfejsu API 24) i nowszych platforma Androida udostępnia podzbiór interfejsów API ICU4J deweloperom aplikacji w pakiecie android.icu. ICU4J to powszechnie używany zestaw bibliotek Java, które zapewniają obsługę Unicode i międzynarodową aplikacji oprogramowania.

Interfejsy ICU4J API korzystają z danych lokalizacji obecnych na urządzeniu. Dzięki temu możesz zmniejszyć rozmiar swojej aplikacji, nie kompilując w niej bibliotek ICU4J. Zamiast tego możesz wywoływać je w ramach frameworka. W takim przypadku warto udostępnić kilka wersji pliku APK, aby użytkownicy korzystający z wersji Androida starszych niż 7.0 (poziom interfejsu API 24) mogli pobrać wersję aplikacji zawierającą biblioteki ICU4J.

W tej sekcji znajdziesz podstawowe informacje o minimalnych poziomach interfejsu Android API wymaganych do obsługi tych bibliotek. Następnie wyjaśnia, co musisz wiedzieć o implementacji ICU4J w Androidzie. W tym artykule znajdziesz też informacje o tym, jak używać interfejsów ICU4J API w ramach Androida.

ICU4J na Androidzie

Android udostępnia podzbiór interfejsów ICU4J API za pomocą pakietu android.icu, a nie com.ibm.icu. Niektóre interfejsy API ICU4J nie są udostępniane przez platformę Androida z powodów takich jak wycofanie interfejsów API lub niezadeklarowanie ich stabilności. Gdy zespół ICU w przyszłości wycofa interfejsy API, Android również je oznaczy jako przestarzałe, ale nadal będzie je uwzględniać.

Oto kilka przypomnięć:

• Interfejsy API platformy ICU4J na Androida nie obejmują wszystkich interfejsów ICU4J.
• Interfejsy API na platformie Androida nie zastępują obsługi lokalizacji za pomocą zasobów w Androidzie.
• W niektórych przypadkach platforma Androida obsługuje więcej znaków niż biblioteki ICU. Dotyczy to na przykład obsługi emotikonów w klasie android.text.

Przejdź z pakietu com.ibm.icu na pakiet android.icu

Jeśli w swojej aplikacji używasz już interfejsów API ICU4J, a interfejsy API android.icu spełniają Twoje wymagania, migracja do interfejsów API platformy wymaga zmiany importów Javy z com.ibm.icu na android.icu. Następnie możesz usunąć własną kopię plików ICU4J z aplikacji.

Uwaga: interfejsy API w ramach ICU4J używają przestrzeni nazw android.icu zamiast com.ibm.icu. Ma to na celu uniknięcie konfliktów nazw przestrzeni w aplikacjach, które zawierają własne biblioteki com.ibm.icu.

Migracja do interfejsów API android.icu z innych interfejsów API pakietu Android SDK

Niektóre klasy w pakietach java i android mają odpowiedniki w pakiecie ICU4J. Jednak ICU4J często zapewnia szerszą obsługę standardów i języków.

Tabela 2 zawiera kilka przykładów tych odpowiedników:

Tabela 2.Klasy ICU4J na Androidzie i Java

ICU4C na Androidzie

Android udostępnia podzbiór interfejsów ICU4C API za pomocą biblioteki libicu.so, a nie libicuuc.so ani libicui18n.so. Interfejsy API są dostępne od Androida 12 (poziom interfejsu API 31). Nagłówki NDK są dostępne od wersji NDK r22b. Interfejs C++ nie jest udostępniany przez NDK Androida. Niektóre interfejsy API w języku C są niedostępne.

Obsługa wersji

Kolejne wersje platformy Android odpowiadają nowszych wersji ICU oraz odpowiadających im wersji CLDR i Unicode. Tabela 3 przedstawia tę zgodność od Androida 7.0 (poziom interfejsu API 24). Aby uzyskać informacje o wersji ICU w czasie działania, użyj interfejsu API VersionInfo.ICU_VERSION (dostępnego od Androida 7.0).

Tabela 3. Wersje ICU i CLDR używane w wersjach Androida od 7.0 (poziom interfejsu API 24) do 15 (poziom interfejsu API 35).

Ustawienie formatu czasu 24-godzinnego/12-godzinnego

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());

Stabilność transliteratora

Licencjonowanie

ICU4J jest udostępniany na licencji ICU. Szczegółowe informacje znajdziesz w przewodniku użytkownika po ICC.