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

Android, Unicode ve diğer uluslararasılaştırma desteği sağlamak için ICU kitaplığından ve CLDR projesinden yararlanır. Bu sayfada Unicode ve uluslararasılaştırma desteğiyle ilgili tartışma 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 üzere 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 konusunda 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 7.0 (API düzeyi 24) ve sonraki sürümlerde Android platformu, uygulama geliştiricilerin android.icu paketi altında kullanabileceği ICU4J API'lerinin bir alt kümesini gösterir. 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ıza derlemeyerek uygulamanızın boyutunu azaltabilirsiniz. Bunun yerine, bunları çerçevede ç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ü sağlamanız önerilir.

Bu bölüm, bu kitaplıkları desteklemek için gereken minimum Android API düzeyleri hakkında bazı temel bilgiler vererek başlar. Ardından, ICU4J'nin Android'e özel 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 desteği sonlandırıldı olarak işaretledikçe Android de bu API'leri desteği sonlandırıldı olarak işaretler ancak bunları dahil etmeye devam eder.

Aşağıda hatırlatmak istediğimiz birkaç nokta verilmiştir:

• 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 paketinden android.icu paketine taşıma

Uygulamanızda zaten ICU4J API'lerini kullanıyorsanız ve android.icu API'leri gereksinimlerinizi karşılıyorsa çerçeve API'lerine geçmek 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. Bu, kendi com.ibm.icu kitaplıklarını içeren uygulamalarda ad alanı çakışmalarını önlemek içindir.

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, standartlar ve diller için genellikle daha geniş destek sunar.

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) ve sonraki sürümlerde kullanılabilir. NDK üst bilgileri, NDK r22b sürümünden itibaren kullanılabilir. Android NDK üzerinden C++ API'si gösterilmez. 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 ve Unicode sürümlerinin daha yeni sürümlerine karşılık gelir. Tablo 3'te, Android 7.0 (API düzeyi 24) ve sonraki sürümlerde bu eşleşme gösterilmektedir. Çalışma zamanında ICU sürüm bilgilerini almak için VersionInfo.ICU_VERSION API'yi (Android 7.0'dan beri kullanılabilir) 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 saat/12 saat 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.