Destek Kitaplığı Kurulumu

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

Destek kitaplığını kullanmaya devam edebilirsiniz. Geçmişe ait yapılar (27 ve önceki sürümler ile android.support.* olarak paketlenenler) Google Maven'de kullanılmaya devam edecek. Ancak tüm yeni kitaplık geliştirme işlemleri AndroidX kitaplığında gerçekleşir.

Tüm yeni projelerde AndroidX kitaplıklarını kullanmanızı öneririz. Ayrıca, mevcut projeleri de AndroidX'e taşımanız gerekir.

Geliştirme projenizde Android Destek Kitaplıkları'nı nasıl ayarlayacağınız, hangi özellikleri kullanmak istediğinize ve uygulamanızla hangi Android platformu sürümlerini desteklemek istediğinize bağlıdır.

Bu belge, Destek Kitaplığı paketini indirip geliştirme ortamınıza kitaplık ekleme konusunda size yol gösterir.

Destek kitaplıkları artık Google'ın Maven deposu üzerinden 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 bir 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 sağladığı ö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 geliştirme ortamınızdaki sınıf yolu bağımlılıklarını değiştirmeniz gerekir. Bu prosedürü kullanmak istediğiniz her bir Destek Kitaplığı için uygulamanı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 gerileme uyumsuzluklarına neden olabilir. Kitaplık sürümünü (ör. 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 Support Library sınıfları genellikle çerçeve sınıfıyla aynı ada sahiptir ancak android.support sınıf paketlerinde bulunur veya *Compat sonekine sahiptir.

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
  • Yalnızca API düzeyi 11 veya sonraki sürümler için geliştirme yaparken android.app.ActionBar

Not: Destek kitaplığını uygulama projenize ekledikten sonra, yayın için uygulamanızı küçültmenizi, karartmanızı ve optimize etmenizi şiddetle öneririz. Kaynak kodunuzu karartma ile korumanın yanı sıra küçültme, uygulamanıza dahil ettiğiniz kitaplıklardaki kullanılmayan sınıfları kaldırarak uygulamanızın indirme boyutunu mümkün olduğunca küçük tutar.

Bazı Destek Kitaplığı özelliklerinin kullanımıyla ilgili daha fazla bilgi için Android geliştirici eğitim sınıflarına, rehberlere ve örneklere göz atın. Destek kitaplığı sınıfları ve yöntemleri hakkında daha fazla bilgi için API referansındaki android.support paketlerine bakın.

Manifest Beyanı Değişiklikleri

Mevcut uygulamanızın geriye dönük uyumluluğunu Destek Kitaplığı ile Android API'nin daha eski bir sürümüne yükseltiyorsanız uygulamanızın manifest dosyasını güncellediğinizden emin olun. Özellikle, manifest dosyasındaki <uses-sdk> etiketinin android:minSdkVersion öğesini, aşağıda gösterildiği gibi yeni ve daha düşük sürüm numarasıyla güncellemeniz gerekir:

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

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

Gradle derleme dosyalarını kullanıyorsanız derleme dosyasındaki 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ümlerin yüklü olduğu cihazlara yüklenebileceğini bildirir. Derleme varyantları hakkında daha fazla bilgi için Derleme Sistemine Genel Bakış başlıklı makaleyi inceleyin.

Not: Birden fazla 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 Preference Support kitaplığını hem de v17 Leanback kitaplığını içeriyorsa minimum SDK sürümünüz 17 veya daha yeni olmalıdır.