Obsługa kodowania Unicode i internacjonalizacji

Android korzysta z biblioteki ICC i projektu CLDR do obsługi kodowania Unicode oraz innych internacjonalizacji. Opis obsługi standardu Unicode i internacjonalizacji jest podzielony na 2 sekcje: Android 6.0 (poziom interfejsu API 23) i starszy oraz Android 7.0 (poziom interfejsu API 24) i nowsze.

Obsługa standardu Unicode i internacjonalizacji do Androida 6.0 (poziom API 23)

Platforma Androida korzysta z ICU i CLDR do wdrożenia różnych klas do obsługi ortografii łacińskich i innych niż łacińskie oraz ujawniania klas takich jak Locale, Character i wielu podklas klasy java.text. Aplikacja, która wymaga funkcji internacjonalizacji wykraczających poza klasy ujawnione 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ą nowszych wersjach ICU oraz odpowiadających im wersji 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 internacjonalizacji w aplikacjach kierowanych na Androida 7.0 (poziom interfejsu API 24) i nowszego. W następnej sekcji znajdziesz szczegółowe informacje na temat tej pomocy.

Obsługa standardu Unicode i internacjonalizacji w Androidzie 7.0 (poziom API 24) i nowszych

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 stosowany zestaw bibliotek Java typu open source, który zapewnia obsługę kodowania Unicode i internacjonalizacji aplikacji.

Interfejsy API ICU4J wykorzystują dane lokalizacji znajdujące się na urządzeniu. W związku z tym możesz zmniejszyć rozmiar aplikacji, nie kompilując bibliotek ICU4J w aplikacji. Zamiast tego możesz je wywoływać w platformie. W takim przypadku warto udostępnić wiele wersji pliku APK, aby użytkownicy korzystający z Androida w wersji starszej 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. Dowiesz się też, jak korzystać z interfejsów API ICU4J w platformie Androida.

ICU4J na Androidzie

Android udostępnia podzbiór interfejsów API ICU4J 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. W miarę jak zespół OIOM-ów będzie w przyszłości wycofywać interfejsy API, Android również oznaczy je jako wycofane, ale nadal będzie je uwzględniać.

Oto kilka przypomnień:

• Interfejsy API platformy ICU4J Androida nie obejmują wszystkich interfejsów ICU4J API.
• 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ź na pakiet android.icu z com.ibm.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ąć swoją kopię plików ICU4J z aplikacji.

Uwaga: interfejsy API platformy ICU4J używają przestrzeni nazw android.icu zamiast com.ibm.icu. Pozwala to uniknąć konfliktów przestrzeni nazw w aplikacjach zawierających 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 ICU4J. ICU4J często zapewnia jednak 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 API ICU4C za pomocą biblioteki libicu.so, a nie libicuuc.so lub libicui18n.so. Interfejsy API są dostępne od Androida 12 (poziom API 31). Nagłówki NDK są dostępne od wersji NDK r22b. Żaden interfejs API C++ nie jest udostępniany w pakiecie Android NDK. Niektóre interfejsy API w języku C są niedostępne.

Obsługa wersji

Kolejne wersje platformy Android odpowiadają nowszych wersjach ICU oraz odpowiadających im wersji CLDR i Unicode. Tę korespondencję znajdziesz w tabeli 3, począwszy od Androida od wersji 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 na urządzeniach z Androidem od 7.0 (poziom interfejsu API 24) do 15 (poziom interfejsu API 35).

Ustawienie formatu godziny 24h/12h

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

Urządzenie ICU4J jest wydawane na podstawie licencji OIOM-u. Szczegółowe informacje znajdziesz w przewodniku użytkownika po ICC.