Obsługa kodowania Unicode i internacjonalizacji

Android korzysta z biblioteki ICU i  projektu CLDR, aby zapewnić obsługę Unicode i innych funkcji internacjonalizacji. Omówienie obsługi Unicode i internacjonalizacji na tej stronie zostało podzielone na 2 sekcje: Android 6.0 (poziom interfejsu API 23) i starsze wersje oraz Android 7.0 (poziom interfejsu API 24) i nowsze wersje.

Obsługa Unicode i internacjonalizacji w Androidzie 6.0 (poziom interfejsu API 23)

Platforma Android korzysta z ICU i CLDR do implementowania różnych klas obsługujących ortografie oparte na alfabecie łacińskim i innych alfabetach. Udostępnia klasy takie jak Locale, Character i wiele podklas java.text. Aplikacja, która wymaga funkcji internacjonalizacji wykraczających poza udostępnione klasy i jest kierowana na wersje platformy starsze niż Android 6.0 (API na poziomie 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ę zależność w przypadku Androida 6.0 (poziom interfejsu API 23).

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

Platforma Androida zapewnia bardziej kompleksową obsługę Unicode i internacjonalizacji w przypadku aplikacji kierowanych na Androida 7.0 (poziom interfejsu API 24) i nowsze wersje. W następnej sekcji tej strony znajdziesz szczegółowe informacje o tej pomocy.

Obsługa Unicode i internacjonalizacji 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 deweloperom aplikacji podzbiór interfejsów API ICU4J do używania w pakiecie android.icu. ICU4J to zestaw bibliotek Java typu open source, które są powszechnie używane i zapewniają obsługę Unicode i internacjonalizacji w aplikacjach.

Interfejsy ICU4J API korzystają z danych lokalizacyjnych dostępnych na urządzeniu. Dzięki temu możesz zmniejszyć rozmiar aplikacji, ponieważ nie musisz kompilować w niej bibliotek ICU4J. Zamiast tego możesz wywoływać je w ramach platformy. Jeśli to zrobisz, możesz udostępnić kilka wersji pliku APK, aby użytkownicy korzystający z wersji Androida starszych niż Android 7.0 (poziom 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 na Androidzie. Na koniec dowiesz się, jak używać interfejsów ICU4J API w platformie Android.

ICU4J na Androidzie

Android udostępnia podzbiór interfejsów API ICU4J w pakiecie android.icu, a nie com.ibm.icu. Niektóre interfejsy API ICU4J nie są udostępniane przez platformę Android z różnych powodów, np. ze względu na to, że są wycofane lub nie zostały uznane za stabilne. Gdy zespół ICU wycofa w przyszłości interfejsy API, Android również oznaczy je jako przestarzałe, ale nadal będzie je uwzględniać.

Oto kilka przypomnień:

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

Przejście z pakietu com.ibm.icu na pakiet android.icu

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

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

Przejście z innych interfejsów Android SDK API na interfejsy android.icu API

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

W tabeli 2 znajdziesz przykłady tych odpowiedników, które pomogą Ci zacząć:

Tabela 2. Klasy ICU4J na Androidzie i w Javie

ICU4C na Androidzie

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

Obsługa wersji

Kolejne wersje platformy Android odpowiadają nowszym wersjom ICU oraz odpowiednim wersjom CLDR i Unicode. Tabela 3 przedstawia tę korespondencję od Androida 7.0 (poziom interfejsu API 24). Użyj interfejsu API VersionInfo.ICU_VERSION (dostępnego od Androida 7.0), aby uzyskać informacje o wersji ICU w czasie działania.

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

Ustawienie formatu czasu 24-godzinnego lub 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

Biblioteka ICU4J jest udostępniana na licencji ICU. Więcej informacji znajdziesz w przewodniku użytkownika ICU.