Unicode ve uluslararasılaştırma desteği

Android, Unicode ve diğer uluslararasılaştırma desteğini sağlamak için ICU kitaplığını ve CLDR projesinden yararlanır. Bu sayfada Unicode ve uluslararasılaştırma desteği ile ilgili açıklamalar iki bölüme ayrılmıştır: Android 6.0 (API düzeyi 23) ve önceki sürümler ile Android 7.0 (API düzeyi 24) ve sonraki sürümler.

Android 6.0 (API düzeyi 23) ile Unicode ve uluslararasılaştırma desteği

Android platformu, hem Latin hem de Latin olmayan yazım sistemlerini işlemek için çeşitli sınıflar uygulamak amacıyla ICU ve CLDR'yi kullanır. Bu sınıflar arasında Locale, Character ve java.text'nin birçok alt sınıfı bulunur. Açık sınıfların ötesinde uluslararasılaştırma işlevleri gerektiren ve platformun Android 6.0 (API düzeyi 23) ile sonraki sürümlerini hedefleyen uygulamalar ICU kitaplığını içermelidir.

Sürüm oluşturma

Android platformunun art arda yayınlanan sürümleri, ICU'nun ve ilgili CLDR ve Unicode sürümlerinin daha yeni sürümlerine karşılık gelir. Tablo 1'de, Android 6.0 (API düzeyi 23) ile bu eşleşme gösterilmektedir.

Tablo 1. Android 6.0 (API düzeyi 23) ile birlikte kullanılan ICU ve CLDR sürümleri.

Android çerçevesi, Android 7.0 (API düzeyi 24) ve sonraki sürümleri hedefleyen uygulamalar için Unicode ve uluslararasılaştırma için daha kapsamlı destek sağlar. Bu sayfanın sonraki bölümünde bu destek hakkında ayrıntılı bilgi verilmektedir.

Android 7.0 (API düzeyi 24) ve sonraki sürümlerde Unicode ve uluslararasılaştırma desteği

Android platformu, Android 7.0 (API düzeyi 24) ve sonraki sürümlerde uygulama geliştiricilerin android.icu paketi kapsamında kullanması için ICU4J API'lerinin bir alt kümesini sunar. ICU4J, yazılım uygulamaları için Unicode ve uluslararasılaştırma desteği sağlayan açık kaynaklı, yaygın olarak kullanılan bir Java kitaplığı grubudur.

ICU4J API'leri, cihazdaki yerelleştirme verilerini kullanır. Sonuç olarak, ICU4J kitaplıklarını uygulamanızda derlemeyerek uygulamanızın ayak izini azaltabilirsiniz. Bunun yerine, bu kitaplıkları çerçeve içinde çağırabilirsiniz. Bunu yaparsanız Android 7.0 (API düzeyi 24) ve önceki sürümleri çalıştıran kullanıcıların ICU4J kitaplıklarını içeren uygulama sürümünü indirmesi için APK'nızın birden fazla sürümünü sunabilirsiniz.

Bu bölüm, bu kitaplıkların desteklenmesi için gereken minimum Android API düzeyleri hakkında bazı temel bilgilerle başlar. Ardından, ICU4J'nin Android'e özgü uygulaması hakkında bilmeniz gerekenler açıklanır. Son olarak, Android çerçevesinde ICU4J API'lerini nasıl kullanacağınızı da açıklar.

Android'de ICU4J

Android, ICU4J API'lerinin bir alt kümesini com.ibm.icu yerine android.icu paketi üzerinden kullanıma sunar. Bazı ICU4J API'leri, API'lerin desteğinin sonlandırılması veya kararlı olarak tanımlanmaması gibi nedenlerle Android çerçevesi tarafından kullanıma sunulmaz. ICU ekibi gelecekte API'leri kullanımdan kaldırdıkça Android de bu API'leri kullanımdan kaldırıldı olarak işaretler ancak dahil etmeye devam eder.

Aşağıda birkaç hatırlatma bulabilirsiniz:

• ICU4J Android çerçeve API'leri tüm ICU4J API'lerini içermez.
• Android çerçevesindeki API'ler, Android'in kaynaklarla yerelleştirme desteğinin yerini almaz.
• Bazı durumlarda Android çerçevesi, ICU kitaplıklarından daha fazla karakteri destekler. Örneğin, android.text sınıfının emoji desteği bu duruma örnek gösterilebilir.

com.ibm.icu'dan android.icu paketine taşıyın

Uygulamanızda zaten ICU4J API'lerini kullanıyorsanız ve android.icu API'leri gereksinimlerinizi karşılıyorsa çerçeve API'lerine geçiş için Java içe aktarmalarınızı com.ibm.icu yerine android.icu olarak değiştirmeniz gerekir. Ardından, ICU4J dosyalarınızın kendi kopyasını uygulamadan kaldırabilirsiniz.

Not: ICU4J çerçeve API'leri, com.ibm.icu yerine android.icu ad alanını kullanır. Bunun nedeni, kendi com.ibm.icu kitaplıklarını içeren uygulamalarda ad alanı çakışmalarını önlemektir.

Diğer Android SDK API'lerinden android.icu API'lerine geçiş

java ve android paketlerindeki bazı sınıflar, ICU4J'deki sınıflara eşdeğerdir. Ancak ICU4J genellikle standartlar ve diller için daha kapsamlı destek sağlar.

Tablo 2'de, başlamanıza yardımcı olacak bu eşdeğerliklere ilişkin bazı örnekler gösterilmektedir:

Tablo 2.Android ve Java ICU4J sınıfları

Android'de ICU4C

Android, ICU4C API'lerinin bir alt kümesini libicuuc.so veya libicui18n.so yerine libicu.so kitaplığı üzerinden gösterir. API'ler, Android 12 (API düzeyi 31) sürümünden itibaren kullanılabilir. NDK üst bilgileri, NDK r22b sürümünden itibaren kullanılabilir. Android NDK üzerinden hiçbir C++ API'si açığa çıkarılmaz. C API'lerinin bazıları kullanılamaz.

Sürüm oluşturma

Android platformunun art arda yayınlanan sürümleri, ICU'nun ve ilgili CLDR ile Unicode sürümlerinin daha yeni sürümlerine karşılık gelir. Tablo 3'te bu yazışma Android 7.0'dan (API düzeyi 24) itibaren gösterilmektedir. Çalışma zamanında ICU sürüm bilgilerini almak için VersionInfo.ICU_VERSION API'yi (Android 7.0'dan itibaren kullanılabilmektedir) kullanın.

Tablo 3. Android 7.0 (API düzeyi 24) ile Android 15 (API düzeyi 35) arasındaki Android sürümlerinde kullanılan ICU ve CLDR sürümleri.

24 sa./12 sa. saat biçimi ayarı

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

Harf çeviricinin kararlılığı

Lisanslama

ICU4J, ICU lisansı kapsamında yayınlanır. Ayrıntılar için ICU kullanıcı kılavuzuna bakın.