Supporto Unicode e internazionalizzazione

Android utilizza la libreria ICU e il progetto CLDR per il supporto di Unicode e altre funzionalità di internazionalizzazione. La spiegazione relativa al supporto di Unicode e dell'internazionalizzazione in questa pagina è suddivisa in due sezioni: Android 6.0 (livello API 23) e versioni precedenti e Android 7.0 (livello API 24) e versioni successive.

Supporto di Unicode e dell'internazionalizzazione tramite Android 6.0 (livello API 23)

La piattaforma Android utilizza ICU e CLDR per implementare varie classi per la gestione dei caratteri latini e non latini, esponendo classi come Locale, Character e molte sottoclassi di java.text. Un'app che richiede funzionalità di internazionalizzazione oltre alle classi esposte e che ha come target versioni della piattaforma fino ad Android 6.0 (livello API 23) deve includere la libreria ICU.

Versioni

Le versioni successive della piattaforma Android corrispondono a versioni più recenti di ICU e alle versioni CLDR e Unicode corrispondenti. La Tabella 1 riporta la corrispondenza fino ad Android 6.0 (livello API 23).

Tabella 1. Versioni ICU e CLDR utilizzate fino ad Android 6.0 (livello API 23).

Il framework Android offre un supporto più completo per Unicode e l'internazionalizzazione per le app che hanno come target Android 7.0 (livello API 24) e versioni successive. La sezione seguente di questa pagina fornisce dettagli sul supporto.

Supporto di Unicode e dell'internazionalizzazione in Android 7.0 (livello API 24) e versioni successive

Per Android 7.0 (livello API 24) e versioni successive, la piattaforma Android espone un sottoinsieme delle API ICU4J che gli sviluppatori di app possono utilizzare nel pacchetto android.icu. ICU4J è un insieme di librerie Java open source ampiamente utilizzate che forniscono supporto di Unicode e dell'internazionalizzazione per le applicazioni software.

Le API ICU4J utilizzano i dati di localizzazione presenti sul dispositivo. Di conseguenza, puoi ridurre le risorse occupate dalla tua app non compilando le librerie ICU4J. In alternativa, puoi richiamarle nel framework. Se lo fai, ti consigliamo di fornire più versioni del tuo APK, in modo che gli utenti che utilizzano versioni di Android precedenti ad Android 7.0 (livello API 24) possano scaricare una versione dell'app che contiene le librerie ICU4J.

Questa sezione fornisce alcune informazioni di base sui livelli API Android minimi richiesti per supportare queste librerie. Quindi spiega cosa devi sapere sull'implementazione specifica per Android di ICU4J. Infine, spiega come utilizzare le API ICU4J nel framework Android.

ICU4J su Android

Android espone un sottoinsieme delle API ICU4J tramite il pacchetto android.icu, anziché com.ibm.icu. Alcune API ICU4J non sono esposte dal framework Android, per motivi quali l'obsolescenza delle API o la mancata dichiarazione di stabilità. Man mano che il team ICU ritirerà le API, Android le contrassegnerà come ritirate, ma continuerà a includerle.

Ecco alcuni aspetti da tenere a mente:

• Le API del framework Android ICU4J non includono tutte le API ICU4J.
• Le API nel framework Android non sostituiscono il supporto di Android per la localizzazione con le risorse.
• In alcuni casi, il framework Android supporta più caratteri rispetto alle librerie ICU. Questo vale, ad esempio, per il supporto delle emoji della classe android.text.

Esegui la migrazione al pacchetto android.icu da com.ibm.icu

Se utilizzi già le API ICU4J nella tua app e le API android.icu soddisfano i tuoi requisiti, la migrazione alle API del framework richiede la modifica delle importazioni Java da com.ibm.icu a android.icu. A questo punto, puoi rimuovere la tua copia dei file ICU4J dall'app.

Nota: le API del framework ICU4J utilizzano lo spazio dei nomi android.icu anziché com.ibm.icu. per evitare conflitti di spazio dei nomi nelle app che contengono librerie com.ibm.icu proprie.

Esegui la migrazione alle API android.icu da altre API SDK Android

Alcune classi nei pacchetti java e android hanno classi alternative a quelle in ICU4J. Tuttavia, ICU4J spesso offre un supporto maggiore per standard e lingue.

La tabella 2 mostra alcuni esempi di queste equivalenze per iniziare:

Tabella 2.Classi Android e Java ICU4J

ICU4C su Android

Android espone un sottoinsieme delle API ICU4C tramite la libreria libicu.so, anziché libicuuc.so o libicui18n.so. Le API sono disponibili a partire da Android 12 (livello API 31). Le intestazioni NDK sono disponibili a partire dalla release r22b dell'NDK. Nessuna API C++ è esposta tramite l'NDK Android. Alcune API C non sono disponibili.

Versioni

Le versioni successive della piattaforma Android corrispondono a versioni più recenti di ICU e alle versioni CLDR e Unicode corrispondenti. La Tabella 3 mostra la corrispondenza a partire da Android 7.0 (livello API 24). Utilizza l'API VersionInfo.ICU_VERSION (disponibile a partire da Android 7.0) per ottenere le informazioni sulla versione di ICU in fase di runtime.

Tabella 3. Versioni di ICU e CLDR utilizzate nelle versioni di Android da Android 7.0 (livello API 24) ad Android 15 (livello API 35).

Impostazione del formato dell'ora a 24 ore/12 ore

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à del traslitteratore

Licenze

ICU4J viene rilasciato con licenza ICU. Per maggiori dettagli, consulta la guida dell'utente di ICU.