Destek Kitaplığı Kurulumu

Not: Android 9.0'un (API düzeyi 28) yayınlanmasıyla birlikte, Jetpack'in bir parçası olan AndroidX adlı destek kitaplığının yeni bir sürümü kullanıma sunuldu. AndroidX kitaplığı, mevcut destek kitaplığını ve en yeni Jetpack bileşenlerini içerir.

Destek kitaplığını kullanmaya devam edebilirsiniz. Geçmiş yapı taşları (27 ve önceki sürümlere sahip ve android.support.* olarak paketlenmiş olanlar) Google Maven'de kullanılabilir olmaya devam edecektir. Ancak tüm yeni kitaplık geliştirmeleri AndroidX kitaplığında yapılacaktır.

Tüm yeni projelerde AndroidX kitaplıklarını kullanmanızı öneririz. Mevcut projeleri AndroidX'e taşımayı da düşünmeniz gerekir.

Android Destek Kitaplıkları'nı geliştirme projenizde nasıl ayarlayacağınız, kullanmak istediğiniz özelliklere ve uygulamanızla hangi Android platform sürümü aralığını desteklemek istediğinize bağlıdır.

Bu doküman, Destek Kitaplığı paketini indirme ve kitaplıkları geliştirme ortamınıza ekleme konusunda size yol gösterir.

Destek kitaplıkları artık Google'ın Maven deposundan kullanılabilir. Kitaplıkların SDK Yöneticisi üzerinden indirilmesi artık desteklenmiyor ve bu işlev yakında kaldırılacak.

Destek Kitaplıklarını Seçme

Uygulamanıza Destek Kitaplığı eklemeden önce hangi özellikleri dahil etmek istediğinize ve desteklemek istediğiniz en düşük Android sürümlerine karar verin. Farklı kitaplıkların sunduğu özellikler hakkında daha fazla bilgi için Destek Kitaplığı Özellikleri başlıklı makaleyi inceleyin.

Destek Kitaplıkları Ekleme

Destek kitaplığı kullanmak için uygulamanızın projesinin sınıf yolu bağımlılıkları üzerinde geliştirme ortamınızda değişiklik yapmanız gerekir. Bu işlemi, kullanmak istediğiniz her Destek Kitaplığı için yapmanız gerekir.

Uygulama projenize destek kitaplığı eklemek için:

1. Google'ın Maven deposunu projenizin settings.gradle dosyasına ekleyin.

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
   
           // If you're using a version of Gradle lower than 4.1, you must
           // instead use:
           //
           // maven {
           //     url 'https://maven.google.com'
           // }
       }
   }

2. Destek kitaplığı kullanmak istediğiniz her modül için kitaplığı, modülün build.gradle dosyasının dependencies bloğuna ekleyin. Örneğin, v4 core-utils kitaplığını eklemek için aşağıdakileri ekleyin:

   dependencies {
       ...
       implementation "com.android.support:support-core-utils:28.0.0"
   }

Dikkat: Dinamik bağımlılıkların (örneğin, palette-v7:23.0.+) kullanılması beklenmedik sürüm güncellemelerine ve regresyon uyumsuzluklarına neden olabilir. Bir kitaplık sürümünü (örneğin, palette-v7:28.0.0) açıkça belirtmenizi öneririz.

Destek Kitaplığı API'lerini Kullanma

Mevcut çerçeve API'leri için destek sağlayan Destek Kitaplığı sınıfları genellikle çerçeve sınıfıyla aynı ada sahiptir ancak android.support sınıf paketlerinde bulunur veya *Compat son eki içerir.

Not: Destek kitaplığını uygulama projenize ekledikten sonra, uygulamanızı küçültmenizi, karartmanızı ve optimize etmenizi önemle tavsiye ederiz. Kod küçültme, kaynak kodunuzu karartma ile korumanın yanı sıra uygulamanıza dahil ettiğiniz kitaplıklardan kullanılmayan sınıfları kaldırır. Böylece uygulamanızın indirme boyutu mümkün olduğunca küçük olur.

Android geliştirici eğitim sınıflarında, kılavuzlarda ve örneklerde bazı Destek Kitaplığı özelliklerinin kullanımıyla ilgili daha fazla bilgi bulabilirsiniz. Destek kitaplığı sınıfları ve yöntemleri hakkında daha fazla bilgi için API referansında android.support paketlerine bakın.

Manifest Beyanındaki Değişiklikler

Mevcut uygulamanızın geriye dönük uyumluluğunu Destek Kitaplığı ile Android API'nin önceki bir sürümüne yükseltiyorsanız uygulamanızın manifest dosyasını güncellediğinizden emin olun. Daha açık belirtmek gerekirse, manifest dosyasında <uses-sdk> etiketinin android:minSdkVersion öğesini aşağıdaki gibi yeni ve daha düşük bir sürüm numarasına güncellemeniz gerekir:

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

Manifest ayarı, Google Play'e uygulamanızın Android 4.0 (API seviyesi 14) ve sonraki sürümlerin yüklü olduğu cihazlara yüklenebileceğini bildirir.

Gradle derleme dosyaları kullanıyorsanız derleme dosyasında minSdkVersion ayarı, manifest ayarlarını geçersiz kılar.

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

Bu durumda, derleme dosyası ayarı Google Play'e, uygulamanızın varsayılan derleme varyantının, Android 4.1 (API düzeyi 16) ve sonraki sürümleri çalıştıran cihazlara yüklenebileceğini bildirir. Derleme varyantları hakkında daha fazla bilgi için Derleme sistemine genel bakış başlıklı makaleyi inceleyin.

Not: Birkaç destek kitaplığı ekliyorsanız minimum SDK sürümü, belirtilen kitaplıklardan herhangi biri tarafından gereken en yüksek sürüm olmalıdır. Örneğin, uygulamanız hem v14 Tercih Desteği kitaplığını hem de v17 Leanback kitaplığını içeriyorsa minimum SDK sürümünüz 17 veya daha yeni olmalıdır.