Obsługa kodowania Unicode i internacjonalizacji

Android korzysta z biblioteki ICU i  projektu lokalizowania na potrzeby międzynarodowe 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 do obsługi ortografii łacińskiej i niełacińskiej, 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 przedstawia tę zgodność do Androida 6.0 (poziom interfejsu 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 pomocy.

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) lub nowszego platforma Androida udostępnia podzbiór interfejsów ICU4J dla deweloperów aplikacji do wykorzystania w pakiecie android.icu. ICU4J to powszechnie używany zbiór 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 na Androida. 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 za pomocą pakietu android.icu, a nie com.ibm.icu. Niektóre interfejsy ICU4J nie są udostępniane przez platformę Androida, ponieważ są wycofane lub nie są deklarowane jako stabilne. 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 w platformie Android 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 emoji przez klasę android.text.

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

Jeśli w swojej aplikacji używasz już interfejsów ICU4J i interfejsy android.icu spełniają Twoje wymagania, migracja do interfejsów frameworku 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 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 przykłady takich ekwiwalencji:

Tabela 2. Klasy ICU4J i Java na Androida

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 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ę zgodność od Androida 7.0 (poziom interfejsu API 24). Aby uzyskać informacje o wersji ICU w czasie wykonywania, 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 ICU.