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ş eserler (27 ve önceki sürümler ile android.support.* olarak paketlenenler) Google Maven'de kullanmaya devam edebilirsiniz. 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ı yükleyin.

   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 kullanma (örneğin, palette-v7:23.0.+), beklenmeyen sürüm güncellemelerine neden olabilir ve regresyon uyumsuzlukları. Bu seçeneği açıkça belirtmenizi öneririz. kitaplık sürümü (örneğin, palette-v7:28.0.0).

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.

Destek Kitaplığı özelliklerinin bazılarıyla ilgili daha fazla yardım Android geliştiricisinde sağlanmıştır eğitim dersleri, rehberler ve örnekler. Destek Kitaplığı sınıfları ve yöntemleri hakkında daha fazla bilgi edinmek için API referansındaki android.support paketleri.

Manifest Beyanı Değişiklikleri

Mevcut uygulamanızın geriye dönük uyumluluğunu önceki bir sürüme yükseltiyorsanız sürümünü kullanıyorsanı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. Daha fazla derleme varyantları hakkında bilgi için bkz. Derleme Sistemine Genel Bakış.

Not: Birden fazla destek kitaplığı ekliyorsanız minimum SDK sürümü, belirtilen kitaplıklar. Ö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.