İndirilebilir Yazı Tipleri Kullanma

Oluşturma yöntemini deneyin

Jetpack Compose, Android için önerilen kullanıcı arayüzü araç setidir. Oluştur'da metni nasıl kullanacağınızı öğrenin.

İndirilebilir Yazı Tipleri →

İndirilebilir Yazı Tipleri özelliği, API'lerin dosyaları uygulamada gruplandırmak veya uygulamanın yazı tiplerini indirmesine izin vermek yerine bir sağlayıcı uygulamasından yazı tipleri istemesini sağlar. İndirilebilir yazı tipleri, AndroidX Core kitaplığı aracılığıyla Android API 14 ve sonraki sürümleri çalıştıran cihazlarda kullanılabilir.

İndirilebilir yazı tipleri aşağıdaki avantajları sunar:

• Uygulama boyutunu küçülterek uygulama yükleme başarı oranını artırır.
• Birden fazla uygulama, bir sağlayıcı aracılığıyla aynı yazı tipini paylaşabileceği için genel sistem sağlığını iyileştirir. Bu sayede kullanıcılar hücresel veri, telefon belleği ve disk alanı tasarrufu sağlar. Bu modelde, yazı tipi gerektiğinde ağ üzerinden getirilir.

İndirilebilir yazı tiplerini kullanma deneyimi için DownloadableFonts örnek uygulamasını inceleyin.

İndirilebilir yazı tipleri nasıl çalışır?

Yazı tipi sağlayıcı, diğer uygulamaların yazı tiplerini isteyip paylaşabilmesi için yazı tiplerini alıp yerel olarak önbelleğe alan bir uygulamadır. Aşağıdaki şekilde bu süreç gösterilmektedir.

Şekil 1. İndirilebilir yazı tipleri işlemi.

Temel bilgiler

İndirilebilir Yazı Tipleri özelliğini, daha sonraki bölümlerde ayrıntılı olarak açıklanacak olan aşağıdaki şekillerde kullanabilirsiniz:

• Android Studio ve Google Play Hizmetleri'ni kullanma
• Programlı
• AndroidX Core kitaplığını kullanma

Android Studio ve Google Play Hizmetleri ile İndirilebilir Yazı Tiplerini kullanma

Android Studio 3.0 veya sonraki sürümleri kullanarak uygulamanızı yazı tiplerini indirecek şekilde ayarlayabilirsiniz. İndirilebilir yazı tipleri özelliklerini kullanmaya başlamanıza yardımcı olması için Google Play Hizmetleri'ndeki yazı tipi sağlayıcıyı kullanabilirsiniz.

Not: Google Yazı Tipleri sağlayıcısını kullanmak için cihazda Google Play Hizmetleri 11 veya daha yeni bir sürüm olmalıdır.

1. Düzen Düzenleyici'de bir TextView seçin. Ardından, Özellikler bölümünde fontFamily > Diğer Yazı Tipleri'ni seçin.

   

   Şekil 2. Düzen Düzenleyici'yi kullanarak.

   Kaynaklar penceresi görünür.
2. Kaynak menüsünde Google Fonts'u seçin.
3. Yazı tipleri kutusunda, "İndirilebilir" alanından bir yazı tipi seçin.
4. İndirilebilir yazı tipi oluştur'u seçip Tamam'ı tıklayın.

   

   Şekil 3. Kaynaklar penceresinden bir yazı tipi seçin.

Android Studio, yazı tipinin uygulamanızda doğru şekilde oluşturulması için gereken ilgili XML dosyalarını otomatik olarak oluşturur.



Şekil 4. Yazı tipi dosyasını önizleme.

İndirilebilir yazı tiplerini programatik olarak kullanma

Android 8.0 (API düzeyi 26) itibarıyla AndroidX Core, indirilebilir yazı tipleri için tam destek sunar. AndroidX Core kitaplığının kullanımı hakkında daha fazla bilgi için bu sayfadaki İndirilebilir Yazı Tipleri AndroidX Core kitaplığı bölümüne bakın.

İndirilebilir Yazı Tipleri özelliğini programatik olarak kullanmak için iki temel sınıfla etkileşimde bulunun:

• android.graphics.fonts.FontRequest: Bu sınıf, yazı tipi isteği oluşturmanıza olanak tanır.
• FontsContractCompat: Bu sınıf, yazı tipi isteğine göre yeni bir Typeface nesnesi oluşturmanıza olanak tanır.

Uygulamanız, FontsContract API'sini kullanarak yazı tiplerini yazı tipi sağlayıcıdan alır. Her sağlayıcının desteklediği Android sürümleri ve sorgu dili ile ilgili kendi kısıtlamaları vardır. Android sürümleri ve sorgu biçimi hakkında daha fazla bilgi için sağlayıcınızın dokümanlarına bakın.

Bir yazı tipini indirmek için aşağıdaki adımları uygulayın:

1. Sağlayıcıdan yazı tipini istemek için android.graphics.fonts.FontRequest sınıfının bir örneğini oluşturun. İstek oluşturmak için aşağıdaki parametreleri iletin:
   • Yazı tipi sağlayıcı yetkilisi.
   • Sağlayıcının kimliğini doğrulamak için yazı tipi sağlayıcı paketi.
   • Yazı tipinin dize sorgusu. Sorgu biçimleri hakkında daha fazla bilgi için yazı tipi sağlayıcınızın (ör. Google Yazı Tipleri) belgelerini inceleyin.
   • Sağlayıcının kimliğini doğrulamak için sertifikalara ait karma gruplarının listesi.
     Not: Yazı tiplerini önceden yüklenmiş sağlayıcılardan talep ediyorsanız sertifika eklemeniz gerekmez. Ancak AndroidX Core kitaplığı üzerinden yazı tipi isteğinde bulunursanız her zaman sertifika sağlayın.

   Kotlin

   val request = FontRequest(
           "com.example.fontprovider.authority",
           "com.example.fontprovider",
           "my font",
           certs
   )
   

   Java

   FontRequest request = new FontRequest("com.example.fontprovider",
                      "com.example.fontprovider", "my font", certs);
   

   Not: Parametre değerlerini yazı tipi sağlayıcınızdan alabilirsiniz. Android Studio, desteklediği sağlayıcılar için bu değerleri kullanıcı arayüzünde otomatik olarak doldurur.
2. FontsContract.FontRequestCallback sınıfının bir örneğini oluşturun.
3. Yazı tipi isteğinin tamamlandığını belirtmek için onTypefaceRetrieved() yöntemini geçersiz kılın. Parametre olarak alınan yazı tipini sağlayın. Yazı tipini gerektiği gibi ayarlamak için bu yöntemi kullanabilirsiniz. Örneğin, bir TextView öğesinde yazı tipini ayarlayabilirsiniz.
4. Yazı tipi istek sürecindeki hatalar hakkında bilgi almak için onTypefaceRequestFailed() yöntemini geçersiz kılın. Hata kodları hakkında daha fazla bilgi için hata kodu sabitlerine bakın.
5. Yazı tipini yazı tipi sağlayıcıdan almak için FontsContract.requestFont() yöntemini çağırın. Yöntem, yazı tipinin önbellekte olup olmadığını belirlemek için bir kontrol başlatır. Yazı tipi yerel olarak kullanılamıyorsa yazı tipi sağlayıcıyı çağırır, yazı tipini asenkron olarak alır ve sonucu geri çağırma işlevine iletir. Aşağıdaki parametreleri iletin:
   • Context sınıfının bir örneği
   • android.graphics.fonts.FontRequest sınıfının bir örneği
   • Yazı tipi isteğinin sonuçlarını almak için geri çağırma işlevi
   • Bir ileti dizisindeki yazı tiplerini getiren işleyici
   Not: Bu işleyicinin kullanıcı arayüzü işleyicisi olmadığından emin olun.

Aşağıdaki örnek kod, indirilebilir yazı tipleri sürecini genel olarak göstermektedir:

Kotlin

val request = FontRequest(
        "com.example.fontprovider.authority",
        "com.example.fontprovider",
        "my font",
        certs
)
val callback = object : FontsContract.FontRequestCallback() {

    override fun onTypefaceRetrieved(typeface: Typeface) {
        // Your code to use the font goes here.
        ...
    }

    override fun onTypefaceRequestFailed(reason: Int) {
        // Your code to deal with the failure goes here.
        ...
    }
}
FontsContract.requestFonts(context, request, handler, null, callback)

Java

FontRequest request = new FontRequest("com.example.fontprovider.authority",
        "com.example.fontprovider", "my font", certs);
FontsContract.FontRequestCallback callback =
    new FontsContract.FontRequestCallback() {
        @Override
        public void onTypefaceRetrieved(Typeface typeface) {
            // Your code to use the font goes here.
            ...
        }

        @Override
        public void onTypefaceRequestFailed(int reason) {
            // Your code to deal with the failure goes here.
            ...
        }
};
FontsContract.requestFonts(context, request, handler, null, callback);

Bir yazı tipi sağlayıcısından bir yazı tipini nasıl indireceğiniz hakkında daha fazla bilgi edinmek için DownloadableFonts örnek uygulamasına bakın.

AndroidX Core'da İndirilebilir Yazı Tiplerini Kullanma

AndroidX Core, Android API 14 veya sonraki sürümünü çalıştıran cihazlarda İndirilebilir Yazı Tipleri özelliği için destek sağlar. androidx.core.provider paketi, geriye dönük olarak uyumlu İndirilebilir Yazı Tipleri özelliği desteğini uygulamak için FontsContractCompat ve FontRequest sınıflarını içerir. AndroidX sınıfları, çerçeve yöntemlerine benzer yöntemler içerir ve yazı tiplerini indirme işlemi, bu sayfada indirilebilir yazı tiplerini programatik olarak kullanma ile ilgili bölümde açıklanan işleme benzer.

AndroidX'i kullanarak yazı tiplerini indirmek için androidx.core.provider paketinden FontsContractCompat ve FontRequest sınıflarını içe aktarın. FontsContract ve android.graphics.fonts.FontRequest çerçeve sınıfları yerine bu sınıfların örneklerini oluşturun.

Not: AndroidX Core kitaplığı üzerinden yazı tipi istediğinizde sertifika vermeniz gerekir. Bu, önceden yüklenmiş yazı tipi sağlayıcıları için bile geçerlidir.

AndroidX Core bağımlılık ekleme

FontsContractCompat ve FontRequest sınıflarını kullanmak için uygulama projenizin sınıf yolu bağımlılıkları geliştirme ortamınızda değiştirilmelidir.

AndroidX Core'u uygulama projenize eklemek için uygulamanızın build.gradle dosyasına aşağıdaki bağımlılığı ekleyin:

Groovy

dependencies {
    ...
    implementation "androidx.core:core-ktx:2.2.0"
}

Kotlin

dependencies {
    ...
    implementation("androidx.core:core-ktx:2.2.0")
}

İndirilebilir yazı tiplerini XML'de kaynak olarak kullanma

Android 8.0 (API düzeyi 26) ve AndroidX Core, XML düzeninde özel bir yazı tipini kaynak olarak belirtmenin daha hızlı ve daha kolay bir yolunu sunar. Bu nedenle, yazı tipini öğe olarak paketlemeniz gerekmez. Temanızın tamamı için özel bir yazı tipi tanımlayabilirsiniz. Bu, sağlandığında kalın, orta veya ince gibi birden fazla ağırlık ve stil için kullanılabilirliği hızlandırır.

1. res/font klasöründe yeni bir XML dosyası oluşturun.
2. Aşağıdaki örnek XML dosyasında gösterildiği gibi bir <font-family> kök öğesi ekleyin ve yazı tipiyle ilgili özellikleri ayarlayın:

<?xml version="1.0" encoding="utf-8"?>
<font-family xmlns:android="http://schemas.android.com/apk/res/android"
        android:fontProviderAuthority="com.example.fontprovider.authority"
        android:fontProviderPackage="com.example.fontprovider"
        android:fontProviderQuery="example font"
        android:fontProviderCerts="@array/certs">
</font-family>

3. Dosyaya, sayfa düzeni XML dosyasında @font/font_file_name olarak referans verin. Dosyayı programatik olarak almak için getFont() yöntemini de kullanabilirsiniz. Örneğin, getFont(R.font.font_file_name).

Yazı tiplerini manifest'te önceden tanımlama

Sayfa oluşturma ve kaynak getirme işlemleri senkronize görevlerdir. Varsayılan olarak, yazı tiplerini almayla ilgili ilk deneme yazı tipi sağlayıcıya bir istek gönderir ve bu nedenle ilk düzen süresi artar. Gecikmeyi önlemek için, alınması gereken yazı tiplerini manifest dosyanızda önceden bildirebilirsiniz. Sistem, yazı tipini sağlayıcıdan aldıktan sonra yazı tipi hemen kullanılabilir. Yazı tipi getirme işlemi beklenenden uzun sürerse sistem getirme işlemini iptal eder ve varsayılan yazı tipini kullanır.

Yazı tiplerini manifest dosyasında önceden bildirmek için aşağıdaki adımları tamamlayın:

1. res/values/arrays.xml içinde bir resources dizisi oluşturun ve önceden almak istediğiniz yazı tiplerini bildirin.

res/values/arrays.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <array name="preloaded_fonts">
        <item>@font/font1</item>
        <item>@font/font2</item>
    </array>
</resources>

2. Manifest dosyanızdaki kaynak dizisini bildirmek için meta-data etiketi kullanın.

<meta-data android:name="preloaded_fonts" android:resource="@array/preloaded_fonts" />

Sertifika ekleme

Yazı tipi sağlayıcı önceden yüklenmemişse veya AndroidX Core kitaplığını kullanıyorsanız yazı tipi sağlayıcının imzalandığı sertifikaları bildirin. Sistem, yazı tipi sağlayıcının kimliğini doğrulamak için sertifikaları kullanır.

Not: Android Studio'da yazı tipi seçici aracını kullanırsanız Android Studio, Google Play Hizmetleri sağlayıcının değerlerini otomatik olarak doldurabilir. Yazı tipi indirmek için Android Studio'yu kullanma hakkında daha fazla bilgi edinmek isterseniz bu sayfadaki Android Studio ve Google Play Hizmetleri ile İndirilebilir Yazı Tiplerini Kullanma bölümüne bakın.

Sertifika eklemek için aşağıdaki adımları uygulayın:

1. Sertifika ayrıntılarını içeren bir dize dizisi oluşturun. Sertifika ayrıntıları hakkında daha fazla bilgi edinmek için yazı tipi sağlayıcınızın dokümanlarına bakın.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string-array name="certs">
       <item>MIIEqDCCA5CgAwIBAgIJA071MA0GCSqGSIb3DQEBBAUAMIGUMQsww...</item>
    </string-array>
</resources>

2. fontProviderCerts özelliğini dizi olarak ayarlayın.

android:fontProviderCerts="@array/certs"

Not: Sağlayıcının birden fazla sertifika grubu varsa bir dize dizisi dizisi tanımlayabilirsiniz.

Compose'daki İndirilebilir Yazı Tipleri