Compatibilidade com Unicode e internacionalização

O Android utiliza a biblioteca ICU e o projeto CDLR (links em inglês) para oferecer suporte a Unicode e outras formas de internacionalização. Este documento sobre suporte a Unicode e internacionalização é dividido em duas seções: Android 6.0 (nível 23 da API) e versões anteriores e Android 7.0 (nível 24 da API) e versões mais recentes.

Suporte a Unicode e internacionalização até o Android 6.0 (nível 23 da API)

A plataforma Android usa ICU e CLDR para implementar várias classes para lidar com ortografias latinas e não latinas, expondo classes como Locale, Character e muitas subclasses de java.text. Os apps que exigem funcionalidades de internacionalização além das classes expostas e são direcionados ao Android 6.0 (nível 23 da API) e versões anteriores precisam incluir a biblioteca ICU.

Controle de versões

Versões sucessivas da plataforma Android correspondem às versões mais recentes da ICU e às versões CLDR e Unicode correspondentes. A tabela 1 mostra essa correspondência até o Android 6.0 (nível 23 da API).

Tabela 1. Versões da ICU e CLDR usadas até o Android 6.0 (nível 23 da API).

Os apps destinado ao Android 7.0 (nível 24 da API) ou versões mais recente podem aproveitar um suporte mais abrangente para Unicode e internacionalização que é exposto pelo framework do Android. A próxima seção deste documento apresenta detalhes sobre esse suporte.

Suporte a Unicode e internacionalização no Android 7.0 (nível 24 da API) ou mais recente

No Android 7.0 (nível 24 da API) e versões mais recentes, a plataforma Android expõe um subconjunto das APIs ICU4J para desenvolvedores de apps usarem no pacote android.icu. O ICU4J é um conjunto de bibliotecas Java de código aberto amplamente utilizado que fornece suporte para Unicode e internacionalização para aplicativos de software.

As APIs ICU4J usam dados de localização presentes no dispositivo. Como resultado, é possível reduzir a pegada do app ao não compilar as bibliotecas do ICU4J. Em vez disso, basta fazer a chamada delas no framework. Nesse caso, convém fornecer várias versões do seu APK para que os usuários que estiverem usando versões anteriores ao Android 7.0 (nível 24 da API) podem fazer o download da versão do app que contém as bibliotecas ICU4J.

Este documento começa fornecendo algumas informações básicas sobre os níveis mínimos de API do Android necessários para oferecer suporte a essas bibliotecas. Em seguida, o documento explica o que você precisa saber sobre a implementação específica da ICU4J no Android. Por fim, ele informa como usar as APIs ICU4J no framework do Android.

ICU4J no Android

O Android expõe um subconjunto das APIs ICU4J pelo pacote android.icu, em vez do com.ibm.icu. O framework do Android pode não expor as APIs ICU4J por vários motivos, por exemplo, por que as APIs foram descontinuadas ou não foram declaradas estáveis. Conforme a equipe da ICU descontinuar as APIs no futuro, elas também vão ser marcadas como descontinuadas no Android, mas vão continuar sendo incluídas.

Confira abaixo algumas observações importantes:

• As APIs ICU4J do framework do Android não incluem todas as APIs ICU4J.
• As APIs no framework do Android não substituem o suporte do Android para localização com recursos.
• Em alguns casos, o framework do Android oferece suporte a mais caracteres do que as bibliotecas ICU. Isso vai ocorrer, por exemplo, ao oferecer suporte à classe android.text de emojis.

Como migrar para o pacote android.icu do com.ibm.icu

Se você já estiver usando as APIs ICU4J no seu app, e as APIs android.icu atenderem suas necessidades, a migração para as APIs do framework exige que você mude suas importações em Java de com.ibm.icu para android.icu. Em seguida, remova sua própria cópia dos arquivos ICU4J do APK.

Observação: as APIs ICU4J do framework usam o namespace android.icu em vez de com.ibm.icu. Isso acontece para evitar conflitos de namespace em APKs que contenham as próprias bibliotecas com.ibm.icu.

Como migrar de APIs android.icu de outras APIs do SDK do Android

Algumas classes nos pacotes java e android têm equivalentes àquelas encontradas na ICU4J. A ICU4J geralmente oferece suporte mais abrangente para padrões e idiomas.

A Tabela 2 mostra alguns exemplos dessas equivalências para que você possa começar:

Tabela 2. Classes ICU4J do Android e do Java.

ICU4C no Android

O Android expõe um subconjunto das APIs ICU4C pela biblioteca libicu.so, em vez de libicuuc.so ou libicui18n.so. As APIs estão disponíveis no Android 12 (nível 31 da API) e versões mais recentes. Os cabeçalhos do NDK estão disponíveis a partir da versão r22b do NDK. Nenhuma API C++ é exposta pelo Android NDK. Algumas das APIs C ainda não estão disponíveis.

Controle de versões

Versões sucessivas da plataforma Android correspondem às versões mais recentes da ICU e às versões CLDR e Unicode correspondentes. A Tabela 3 mostra essa correspondência no Android 7.0 (nível 24 da API) e versões mais recentes.

Tabela 3. Versões da ICU e CLDR usadas no Android 7.0 (nível 24 da API) ou mais recente.

Configuração de formato de hora 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());

Estabilidade da transliteração

Licenciamento

A ICU4J é lançada na licença da ICU. Para mais detalhes, consulte o Guia do usuário da ICU (em inglês).