Unterstützung für Unicode und Internationalisierung

Android nutzt die ICU Bibliothek und das CLDR-Projekt, um Unicode und andere Internationalisierungsfunktionen bereitzustellen. Die Informationen auf dieser Seite zur Unterstützung von Unicode und Internationalisierung sind in zwei Abschnitte unterteilt: Android 6.0 (API-Level 23) und niedriger sowie Android 7.0 (API-Level 24) und höher.

Unterstützung für Unicode und Internationalisierung bis Android 6.0 (API-Level 23)

Die Android-Plattform verwendet ICU und CLDR, um verschiedene Klassen für die Verarbeitung von lateinischen und nicht lateinischen Orthografien zu implementieren. Dabei werden Klassen wie Locale, Character und viele Unterklassen von java.text verfügbar gemacht. Eine App, die über die verfügbaren Klassen hinaus Internationalisierungsfunktionen erfordert und auf Versionen der Plattform bis Android 6.0 (API-Level 23) ausgerichtet ist, muss die ICU-Bibliothek enthalten.

Versionsverwaltung

Nachfolgende Versionen der Android-Plattform entsprechen neueren Versionen von ICU und den entsprechenden CLDR- und Unicode-Versionen. Tabelle 1 zeigt diese Entsprechung bis Android 6.0 (API-Level 23).

Tabelle 1. ICU- und CLDR-Versionen, die bis Android 6.0 (API-Level 23) verwendet werden.

Das Android-Framework bietet umfassendere Unterstützung für Unicode und Internationalisierung für Apps, die auf Android 7.0 (API-Level 24) und höher ausgerichtet sind. Im nächsten Abschnitt dieser Seite finden Sie weitere Informationen zu dieser Unterstützung.

Unterstützung für Unicode und Internationalisierung in Android 7.0 (API-Level 24) und höher

Unter Android 7.0 (API-Level 24) und höher stellt die Android-Plattform eine Teilmenge der ICU4J-APIs für App-Entwickler zur Verfügung, die unter dem Paket android.icu verwendet werden können. ICU4J ist eine Open-Source-Sammlung von Java-Bibliotheken, die Unicode und Internationalisierungsfunktionen für Softwareanwendungen bietet.

Die ICU4J-APIs verwenden Lokalisierungsdaten, die auf dem Gerät vorhanden sind. So können Sie die Größe Ihrer App reduzieren, indem Sie die ICU4J-Bibliotheken nicht in Ihre App kompilieren. Stattdessen können Sie sie im Framework aufrufen. In diesem Fall sollten Sie mehrere Versionen Ihrer APK bereitstellen, damit Nutzer mit Android-Versionen unter Android 7.0 (API-Level 24) eine Version der App herunterladen können, die die ICU4J-Bibliotheken enthält.

In diesem Abschnitt finden Sie zuerst einige grundlegende Informationen zu den erforderlichen Android-Mindest-API-Levels zur Unterstützung dieser Bibliotheken. Anschließend wird erläutert, was Sie über die Android-spezifische Implementierung von ICU4J wissen müssen. Zum Schluss erfahren Sie, wie Sie die ICU4J-APIs im Android-Framework verwenden.

ICU4J unter Android

Android stellt eine Teilmenge der ICU4J-APIs über das android.icu Paket und nicht über com.ibm.icu zur Verfügung. Einige ICU4J-APIs werden aus Gründen wie der Einstellung der APIs oder der fehlenden Deklaration als stabil nicht vom Android-Framework verfügbar gemacht. Wenn das ICU-Team APIs in Zukunft einstellt, werden sie auch in Android als eingestellt markiert, aber weiterhin enthalten.

Einige Hinweise:

• Die ICU4J-Android-Framework-APIs enthalten nicht alle ICU4J-APIs.
• Die APIs im Android-Framework ersetzen nicht die Android-Unterstützung für die Lokalisierung mit Ressourcen.
• In einigen Fällen unterstützt das Android-Framework mehr Zeichen als die ICU-Bibliotheken. Das gilt beispielsweise für die Unterstützung von Emojis in der Klasse android.text.

Von com.ibm.icu zu android.icu migrieren

Wenn Sie die ICU4J-APIs bereits in Ihrer App verwenden und die android.icu APIs Ihren Anforderungen entsprechen, müssen Sie bei der Migration zu den Framework-APIs Ihre Java-Importe von com.ibm.icu zu android.icu ändern. Anschließend können Sie Ihre eigene Kopie der ICU4J-Dateien aus der App entfernen.

Hinweis: Die ICU4J-Framework-APIs verwenden den android.icu Namespace anstelle von com.ibm.icu. So werden Namespace Konflikte in Apps vermieden, die eigene com.ibm.icu Bibliotheken enthalten.

Von anderen Android SDK-APIs zu android.icu-APIs migrieren

Einige Klassen in den java und android Paketen haben Entsprechungen zu denen in ICU4J. ICU4J bietet jedoch oft eine umfassendere Unterstützung für Standards und Sprachen.

Tabelle 2 enthält einige Beispiele für diese Entsprechungen, die Ihnen den Einstieg erleichtern:

Tabelle 2.Android und Java-ICU4J-Klassen

ICU4C unter Android

Android stellt eine Teilmenge der ICU4C-APIs über die libicu.so Bibliothek und nicht über libicuuc.so oder libicui18n.so zur Verfügung. Die APIs sind ab Android 12 (API-Level 31) verfügbar. Die NDK-Header sind ab der NDK-Version r22b verfügbar. Über das Android NDK wird keine C++-API verfügbar gemacht. Einige der C-APIs sind nicht verfügbar.

Versionsverwaltung

Nachfolgende Versionen der Android-Plattform entsprechen neueren Versionen von ICU und den entsprechenden CLDR- und Unicode-Versionen. Tabelle 3 zeigt diese Entsprechung ab Android 7.0 (API-Level 24). Verwenden Sie die VersionInfo.ICU_VERSION API (verfügbar seit Android 7.0), um die ICU Versionsinformationen zur Laufzeit abzurufen.

Tabelle 3. ICU- und CLDR-Versionen, die in Android-Versionen von Android 7.0 (API-Level 24) bis Android 15 (API-Level 35) verwendet werden.

Einstellung für das 24-Stunden-/12-Stunden-Zeitformat

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

Stabilität von Transliterator

Lizenzierung

ICU4J wird unter der ICU-Lizenz veröffentlicht. Weitere Informationen finden Sie im ICU -Nutzerhandbuch.