Destek Kitaplığı Paketleri

Not: Support Library 28.0.0'ın yayınlanmasıyla birlikte android.support paketli kitaplıklar kullanımdan kaldırıldı ve androidx olarak paketlenmiş, ayrı ayrı sürüm oluşturulmuş Jetpack kitaplıklarıyla değiştirildi. Jetpack kitaplıklarının ilk 1.0.0 sürümü, Support Library 28.0.0 ile eşitlik sağlar ve yeni androidx paketine geçiş için bir başlangıç noktası sunar.

Mevcut android.support paketli kitaplıklar çalışmaya devam edecek ancak 28.0.0'dan sonraki güncellemeleri almayacak ve yeni Jetpack kitaplıklarıyla uyumlu olmayacak. Geçmişe ait yapılar (27 ve önceki sürümler, android.support olarak paketlenmiş olanlar) Google Maven'de kullanılmaya devam edecektir. Tüm yeni yapılar androidx olarak paketlenir ve android.support'den androidx'ya taşınması gerekir.

Tüm yeni projelerde androidx kitaplıklarını kullanmanızı öneririz. Ayrıca, mevcut projelerin hata düzeltmeleri ve diğer kitaplık iyileştirmelerini almaya devam etmesini sağlamak için bu projeleri taşımanız da önerilir.

Android Destek Kitaplığı, uygulamanıza dahil edilebilecek çeşitli kitaplık paketleri içerir. Bu kitaplıkların her biri belirli bir Android platform sürümü aralığını ve özellik kümesini destekler.

Aşağıdaki kitaplıklardan herhangi birini kullanmak için kitaplık dosyalarını Android SDK yüklemenize indirmeniz gerekir. Bu adımı tamamlamak için Destek Kitaplığı Kurulumu bölümündeki Destek Kitaplıklarını indirme talimatlarını uygulayın. Uygulamanıza belirli bir Destek Kitaplığı'nı eklemek için ek adımlar uygulamanız gerekir. Kitaplığı uygulamanıza nasıl dahil edeceğinizle ilgili önemli bilgiler için aşağıdaki her kitaplık bölümünün sonuna bakın.

Not: Tüm destek kitaplığı paketleri için minimum SDK sürümü en az API düzeyi 14 olmalıdır. Bazı paketler, aşağıda belirtildiği gibi daha yüksek bir API düzeyi gerektirir.

v4 Destek Kitaplıkları

Bu kitaplıklar, uygulama bileşenleri, kullanıcı arayüzü özellikleri, erişilebilirlik, veri işleme, ağ bağlantısı ve programlama yardımcı programları desteği de dahil olmak üzere diğer kitaplıklara kıyasla en büyük API grubunu içerir.

v4 destek kitaplıkları tarafından sağlanan sınıflar ve yöntemler hakkında eksiksiz ve ayrıntılı bilgi için API referansındaki android.support.v4 paketine bakın.

Not: Destek kitaplığı revizyonu 24.2.0'dan önce tek bir v4 destek kitaplığı vardı. Bu kitaplık, verimliliği artırmak için birden fazla modüle bölünmüştü. Geriye dönük uyumluluk için Gradle komut dosyanızda support-v4 listelerseniz uygulamanız v4 modüllerinin tümünü içerir. Ancak uygulama boyutunu küçültmek için uygulamanızın ihtiyaç duyduğu belirli modülleri listelemenizi öneririz.

v4 uyumluluk kitaplığı

Context.obtainDrawable() ve View.performAccessibilityAction() gibi bir dizi çerçeve API'si için uyumluluk sarmalayıcıları sağlar.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:support-compat:28.0.0

v4 core-utils kitaplığı

AsyncTaskLoader ve PermissionChecker gibi bir dizi yardımcı sınıf sağlar.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir: 

com.android.support:support-core-utils:28.0.0

v4 core-ui kitaplığı

ViewPager, NestedScrollView ve ExploreByTouchHelper gibi çeşitli kullanıcı arayüzüyle ilgili bileşenleri uygular.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir: 

com.android.support:support-core-ui:28.0.0

v4 media-compat kitaplığı

MediaBrowser ve MediaSession dahil olmak üzere medya çerçevesinin bazı bölümlerini geriye dönük olarak taşır.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir: 

com.android.support:support-media-compat:28.0.0

v4 parça kitaplığı

Kullanıcı arayüzü ve işlevselliğin parçalar ile kapsüllenmesi için destek eklenir. Bu sayede uygulamalar, küçük ve büyük ekranlı cihazlar arasında ayarlanan düzenler sağlayabilir. Bu modülün compat, core-utils, core-ui ve media-compat üzerinde bağımlılıkları vardır.

Not: v13 destek kitaplığı FragmentCompat sınıfını sağlar. v4 Fragment sınıfı, sonraki platform sürümlerinde eklenen hata düzeltmelerini sağlayan bağımsız bir sınıftır. v13 FragmentCompat sınıfı ise Fragment sınıfının çerçeve uygulaması için uyumluluk dolguları sağlar.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir: 

com.android.support:support-fragment:28.0.0

Multidex Destek Kitaplığı

Bu kitaplık, birden fazla Dalvik Executable (DEX) dosyası içeren uygulamalar oluşturma desteği sunar. 65.536'dan fazla yönteme referans veren uygulamaların multidex yapılandırmalarını kullanması gerekir. Çoklu dex kullanma hakkında daha fazla bilgi için 64.000'den Fazla Yöntem İçeren Uygulamalar Oluşturma başlıklı makaleye bakın.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir: 

com.android.support:multidex:1.0.0

v7 Destek Kitaplıkları

Bu kitaplıklar belirli özellik kümeleri sağlar ve uygulamanıza birbirinden bağımsız olarak dahil edilebilir.

v7 appcompat kitaplığı   Android Jetpack'in bir parçasıdır.

Not: AppCompat kitaplığı, Android Jetpack bileşeni olan AndroidX kitaplığına taşındı. Sunflower demo uygulamasında nasıl kullanıldığını görün.

Bu kitaplık, işlem çubuğu kullanıcı arayüzü tasarım deseni için destek ekler. Bu kitaplık, Materyal Tasarım kullanıcı arayüzü uygulamaları için destek içerir.

Not: Bu kitaplık, v4 Destek Kitaplığı'na bağlıdır.

v7 appcompat kitaplığında bulunan temel sınıflardan bazıları şunlardır:

  • ActionBar - İşlem çubuğu kullanıcı arayüzü kalıbının uygulanmasını sağlar. İşlem çubuğunu kullanma hakkında daha fazla bilgi için İşlem çubuğu geliştirici kılavuzuna bakın.
  • AppCompatActivity - Destek kitaplığı işlem çubuğu uygulamasını kullanan etkinlikler için temel sınıf olarak kullanılabilecek bir uygulama etkinliği sınıfı ekler.
  • AppCompatDialog - AppCompat temalı iletişim kutuları için temel sınıf olarak kullanılabilecek bir iletişim kutusu sınıfı ekler.
  • ShareActionProvider - Bir işlem çubuğuna eklenebilecek standartlaştırılmış bir paylaşım işlemi (ör. e-posta veya sosyal uygulamalarda yayınlama) için destek ekler.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:appcompat-v7:28.0.0

v7 cardview kitaplığı

Bu kitaplık, CardView widget'ı için destek ekler. Bu widget, herhangi bir uygulamada tutarlı bir görünüme sahip kartların içinde bilgi göstermenize olanak tanır. Bu kartlar, Material Design uygulamaları için kullanışlıdır ve TV uygulamalarının düzenlerinde yaygın olarak kullanılır.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:cardview-v7:28.0.0

v7 gridlayout kitaplığı

Android Destek Kitaplıklarını indirdikten sonra bu kitaplık, dikdörtgen hücrelerden oluşan bir ızgara kullanarak kullanıcı arayüzü öğelerini düzenlemenize olanak tanıyan GridLayout sınıfı için destek ekler. v7 gridlayout kitaplığı API'leri hakkında ayrıntılı bilgi için API referansındaki android.support.v7.widget paketine bakın.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:gridlayout-v7:28.0.0

v7 mediarouter kitaplığı

Bu kitaplık, Google Cast'i destekleyen MediaRouter, MediaRouteProvider ve ilgili medya sınıflarını sağlar.

Genel olarak, v7 mediarouter kitaplığındaki API'ler, medya kanallarının ve akışlarının mevcut cihazdan harici ekranlara, hoparlörlere ve diğer hedef cihazlara yönlendirilmesini kontrol etme yöntemi sağlar. Kitaplıkta, uygulamaya özel medya rotası sağlayıcılarını yayınlama, hedef cihazları keşfedip seçme, medya durumunu kontrol etme ve daha birçok işlem için API'ler bulunur. v7 mediarouter kitaplığı API'leri hakkında ayrıntılı bilgi için API referansındaki android.support.v7.media paketine bakın.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:mediarouter-v7:28.0.0

Destek Kitaplığı r18'de kullanıma sunulan v7 mediarouter kitaplığı API'leri, Destek Kitaplığı'nın sonraki düzeltmelerinde değişebilir. Şu anda kitaplığı yalnızca Google Cast ile birlikte kullanmanızı öneririz.

v7 palet kitaplığı

v7 palet destek kitaplığı, bir resimden belirgin renkleri almanızı sağlayan Palette sınıfını içerir. Örneğin, bir müzik uygulaması, albüm kapağındaki baskın renkleri çıkarmak için Palette nesnesini kullanabilir ve bu renkleri kullanarak renk uyumlu bir şarkı başlığı kartı oluşturabilir.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:palette-v7:28.0.0

v7 recyclerview kitaplığı

recyclerview kitaplığı, RecyclerView sınıfını ekler. Bu sınıf, sınırlı bir veri öğesi penceresi sağlayarak büyük veri kümelerini verimli bir şekilde görüntülemek için kullanılan bir görünüm olan RecyclerView widget'ını destekler.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:recyclerview-v7:28.0.0

v7 Preference Support Library

Preference paketi, kullanıcıların kullanıcı arayüzü ayarlarını değiştirmesi için CheckBoxPreference ve ListPreference gibi tercih nesnelerinin eklenmesini destekleyen API'ler sağlar.

v7 Preference kitaplığı, Preference.OnPreferenceChangeListener ve Preference.OnPreferenceClickListener gibi arayüzlerin yanı sıra CheckBoxPreference ve ListPreference gibi sınıflar için destek ekler.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:preference-v7:28.0.0

v8 Destek Kitaplığı

Bu kitaplık, belirli özellik kümeleri sağlar ve diğer kitaplıklardan bağımsız olarak uygulamanıza dahil edilebilir.

v8 renderscript kitaplığı

Bu kitaplık, RenderScript hesaplama çerçevesi için destek ekler. Bu API'ler android.support.v8.renderscript paketine dahildir. Bu API'leri uygulamanıza dahil etme adımlarının diğer destek kitaplığı API'lerinden çok farklı olduğunu unutmayın. Bu API'leri uygulamanızda kullanma hakkında daha fazla bilgi için RenderScript geliştirici kılavuzuna bakın.

Not: RenderScript'in destek kitaplığıyla kullanımı, Android Studio ve Gradle tabanlı derlemelerde desteklenir. RenderScript kitaplığı build-tools/$VERSION/renderscript/ klasöründe bulunur.

Aşağıdaki örnekte bu kitaplığın Gradle derleme komut dosyası özellikleri gösterilmektedir:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

v13 Destek Kitaplığı

Bu kitaplık, (FragmentCompat) sınıfıyla Fragment kullanıcı arayüzü deseni ve ek parça destek sınıfları için destek ekler. Parçalar hakkında daha fazla bilgi için Parçalar geliştirici kılavuzuna bakın. v13 Support Library API'leri hakkında ayrıntılı bilgi için API referansındaki android.support.v13 paketine bakın.

Not: v4 fragment kitaplığı, Fragment sınıfını sağlar. v4 Fragment sınıfı, sonraki platform sürümlerinde eklenen hata düzeltmelerini sağlayan bağımsız bir sınıftır. v13 FragmentCompat sınıfı ise Fragment sınıfının çerçeve uygulaması için uyumluluk dolguları sağlar.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:support-v13:28.0.0

v14 Preference Support Library

android.support.v14.preference paketi, PreferenceFragment.OnPreferenceStartFragmentCallback ve PreferenceFragment.OnPreferenceStartScreenCallback gibi tercih arayüzlerine destek eklemek için API'ler sağlar. Ayrıca MultiSelectListPreference ve PreferenceFragment gibi sınıflar da içerir. v14 Preference Support Library API'leri hakkında ayrıntılı bilgi için API referansındaki preference paketine bakın.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:preference-v14:28.0.0

TV için v17 Tercih Destek Kitaplığı

android.support.v17.preference paketi, LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener arayüzü ve BaseLeanbackPreferenceFragment ile LeanbackPreferenceFragment gibi sınıflar için destek de dahil olmak üzere TV cihazlarında tercih arayüzleri sağlamaya yönelik API'ler sunar. v17 Preference Support Library API'leri hakkında ayrıntılı bilgi için API referansındaki preference paketine bakın.

Bu paket için API düzeyi 17 veya üstü gerekir. Bu kitaplığın Gradle derleme komut dosyasındaki bağımlılık tanımlayıcısı şöyledir:

 com.android.support:preference-leanback-v17:28.0.0

v17 Leanback Kitaplığı

android.support.v17.leanback paketi, TV cihazlarında kullanıcı arayüzleri oluşturmayı destekleyen API'ler sağlar. TV uygulamaları için bir dizi önemli widget sağlar. Öne çıkan sınıflardan bazıları:

Bu paket için API düzeyi 17 veya üstü gerekir. Bu kitaplığın Gradle derleme komut dosyasındaki bağımlılık tanımlayıcısı şöyledir:

com.android.support:leanback-v17:28.0.0

Vector Drawable Library

Statik vektör grafikler için destek sağlar.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şu şekildedir:

com.android.support:support-vector-drawable:28.0.0

Animated Vector Drawable Library

Animasyonlu vektör grafikler için destek sağlar.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şu şekildedir:

com.android.support:animated-vector-drawable:28.0.0

Ek Açıklamalar Destek Kitaplığı

Annotation paketi, uygulamalarınıza ek açıklama meta verileri eklemeyi destekleyen API'ler sağlar.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:support-annotations:28.0.0

Tasarım Destek Kitaplığı

Tasarım paketi, uygulamalarınıza Materyal Tasarım bileşenleri ve desenleri eklemeyi destekleyen API'ler sağlar.

Tasarım Destek Kitaplığı, uygulama geliştiricilerin üzerine inşa edebileceği çeşitli Materyal Tasarım bileşenleri ve kalıpları için destek ekler. Örneğin, gezinme çekmeceleri, kayan işlem düğmeleri (KİD), snackbar'lar ve sekmeler.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:design:28.0.0

Özel Sekmeler Destek Kitaplığı

Özel Sekmeler paketi, uygulamalarınıza özel sekmeler eklemeyi ve yönetmeyi destekleyen API'ler sağlar.

Custom Tabs Support kitaplığı, Custom Tabs Service ve Custom Tabs Callback gibi çeşitli sınıflar için destek ekler.

Bu paket için API düzeyi 15 veya üstü gerekir. Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:customtabs:28.0.0

Percent Support Library

Percent paketi, uygulamanıza yüzde tabanlı boyutlar eklemeyi ve bunları yönetmeyi destekleyen API'ler sağlar.

Not: Percent Support kitaplığı, 26.0.0 sürümünden itibaren kullanımdan kaldırılmıştır. Bu modülün istemcileri, SDK Yöneticisi'nde ayrı bir yapı olarak sağlanan yeni ConstraintLayout widget'ına geçmelidir.

Percent Support kitaplığı, PercentLayoutHelper.PercentLayoutParams arayüzü ve PercentFrameLayout ve PercentRelativeLayout gibi çeşitli sınıflar için destek ekler.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:percent:28.0.0

ExifInterface Destek Kitaplığı

Exif etiketleri, yön, tarih ve saat, kamera bilgileri ve konum gibi bilgileri doğrudan bir JPEG veya RAW dosyasına kaydeder. ExifInterface sınıfı, JPEG ve RAW (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW ve RAF) biçimli dosyalardan Exif bilgilerinin okunması ve JPEG resim dosyalarında Exif bilgilerinin ayarlanması için desteği ayırır.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir: 

com.android.support:exifinterface:28.0.0

TV için Uygulama Önerisi Destek Kitaplığı

Uygulama Önerisi paketi, TV cihazlarında çalışan uygulamanıza içerik önerileri eklemeyi destekleyen API'ler sağlar.

Uygulama kitaplığı, ContentRecommendation.ContentMaturity gibi ek açıklamaların yanı sıra ContentRecommendation ve RecommendationExtender gibi çeşitli sınıfları destekler.

Bu paket için API düzeyi 21 veya üstü gerekir. Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir:

com.android.support:recommendation:28.0.0

Wear Kullanıcı Arayüzü Kitaplığı

Bu kitaplık, Wear uygulamaları için kullanıcı arayüzleri oluşturmaya yönelik API'ler içerir. android.support.wear.widget paketinde bulunan API'ler, Wearable Support Library'deki ilgili API'lerin yerini alır.

Daha fazla bilgi için Wear kullanıcı arayüzü kitaplığını kullanma başlıklı makaleyi inceleyin.

Bu kitaplığın Gradle derleme komut dosyası bağımlılığı tanımlayıcısı şöyledir: 

com.android.support:wear:28.0.0