Destek Kitaplığı Kurulumu

Not: Android 9.0 (API düzeyi 28) sürümünde destek kitaplığının yeni sürümü Jetpack'in bir parçası olan AndroidX. AndroidX kitaplığı mevcut destek kitaplığını ve en son 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 bulabilirsiniz.

Tüm yeni projelerde AndroidX kitaplıklarını kullanmanızı öneririz. Şunları da göz önünde bulundurmalısınız: AndroidX'e de taşıyoruz.

Geliştirme projenizde Android Destek Kitaplıklarını nasıl kuracağınız, hangi özelliklere ve hangi Android platformu sürümlerini desteklemek istediğinizi bir uygulamadır.

Bu belge, Destek Kitaplığı paketini indirme ve kitaplık ekleme konusunda size yol gösterir dikkat edin.

Destek kitaplıkları artık Google'ın Maven üzerinden kullanılabilir depodur. Kitaplıkların SDK üzerinden indirilmesi artık desteklenmiyor yakında devre dışı bırakılacak. Bu işlev yakında kaldırılacaktır.

Destek kitaplıklarını seçme

Uygulamanıza Destek Kitaplığı eklemeden önce hangi özellikleri eklemek istediğinize karar verin ve desteklemek istediğiniz en düşük Android sürümlerini kullanabilirsiniz. Gösterilen özellikler hakkında daha fazla bilgi için tarafından sağlandığından emin olmak için Destek Kitaplığı Özellikleri.

Destek Kitaplıkları Ekleme

Destek Kitaplığı kullanmak için uygulamanızın projesinin bağımlılıklarını nasıl ortaya koyabileceğinizi açıklayacağız. Bu işlemi şunun için gerçekleştirmeniz gerekir: destek kitaplığını açın.

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ğu. Örneğin, örnek olarak, v4 core-utils kitaplığını eklemek için şunu 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ü (ö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ı ile aynı ada sahiptir ancak android.support sınıf paketleri içinde yer alır. veya *Compat son ekine sahip olmanız gerekir.

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

• Destek Kitaplığı'nı kullanırken android.support.v7.app.ActionBar.
• Yalnızca API düzeyi 11 veya üstü için geliştirme yaparken android.app.ActionBar.

Not: Destek Kitaplığı'nı uygulama projenize ekledikten sonra, kodları karartmanızı, basitleştirmenizi uygulamanızın kullanıma sunulmasını sağlayabilirsiniz. Kod karartma yöntemiyle kaynak kodunuzu korumaya ek olarak, kullanılmayan sınıfları uygulamanıza eklediğiniz kitaplıklardan kaldırır, bu da indirme boyutunuz mümkün olduğunca küçük olmalıdır.

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 edinmek için API referansındaki android.support paketleri.

Manifest Beyanındaki Değişiklikler

Mevcut uygulamanızın geriye dönük uyumluluğunu önceki bir sürüme yükseltiyorsanız sürümünü öğrenmek istiyorsanız uygulamanızın manifest'ini kullanabilirsiniz. Özellikle, android:minSdkVersion öğesi Manifest'teki <uses-sdk> etiketini yeni, daha düşük sürüm numarasına aşağıda gösterilmiştir:

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

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

Gradle derleme dosyalarını kullanıyorsanız derleme dosyasındaki minSdkVersion ayarı manifesto 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 uygulama, Android 4.1 (API düzeyi 16) ve sonraki sürümleri çalıştıran cihazlara yüklenebilir. 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ığı hem de v17 Leanback kitaplığı (minimum fiyat) SDK sürümü 17 veya sonraki bir sürüm olmalıdır.