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 olan ve android.support.* olarak paketlenenler) 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 (ör. palette-v7:23.0.+) kullanılması beklenmedik sürüm güncellemelerine ve geriye dönük uyumsuzluklara neden olabilir. Bir kitaplık sürümünü açıkça belirtmenizi (örneğin, palette-v7:28.0.0) ö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.

Dikkat: Destek Kitaplığı'ndaki sınıfları kullanırken sınıfı uygun paketten içe aktardığınızdan emin olun. Örneğin, ActionBar sınıfını uygularken:

  • android.support.v7.app.ActionBar Destek Kitaplığı'nı kullanırken.
  • android.app.ActionBar kullanabilirsiniz.

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.

Bazı Destek Kitaplığı özelliklerini kullanmayla ilgili daha fazla bilgi için Android geliştirici eğitim sınıflarına, kılavuzlara ve örneklere göz atın. 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 seviyesi 16) ve sonraki sürümlere sahip 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 14 numaralı Tercih Desteği kitaplığını hem de 17 numaralı Leanback kitaplığını içeriyorsa minimum SDK sürümünüz 17 veya daha yeni olmalıdır.