Destek Kitaplığı Paketleri

Not: Destek Kitaplığı 28.0.0 sürümü yayınlandığından android.support paketli kitaplıkların desteği sonlandırıldı ve bu kitaplıklar, androidx olarak paketlenmiş, ayrı ayrı sürümlendirilmiş Jetpack kitaplıklarıyla değiştirildi. Jetpack kitaplıklarının ilk 1.0.0 sürümü, Destek Kitaplığı 28.0.0 ile denklik sağlar ve yeni androidx paketine taşıma için bir başlangıç noktası sağlar.

android.support paketinde sunulan mevcut kitaplıklar çalışmaya devam edecek ancak 28.0.0 sonrası hiçbir güncelleme almayacak ve yeni Jetpack kitaplıklarıyla uyumlu olmayacak. Geçmiş yapılar (27 ve daha eski sürümler ve android.support olarak paketlenmiş) Google Maven'de kalmaya devam eder. Tüm yeni yapı androidx olarak paketlenir ve android.support'tan androidx'a taşınması gerekir.

Tüm yeni projelerde androidx kitaplıklarını kullanmanızı öneririz. Ayrıca, hata düzeltmelerini ve kitaplıktaki diğer iyileştirmeleri almaya devam etmeleri için mevcut projeleri taşımayı da düşünebilirsiniz.

Android Destek Kitaplığı, uygulamanıza eklenebilecek çeşitli kitaplık paketleri içerir. Bu kitaplıkların her biri belirli bir Android platform sürümü ve özellik grubunu 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. Belirli bir Destek Kitaplığı'nı uygulamanıza eklemek için ek adımlar atmanız gerekir. Kitaplığı uygulamanıza dahil etme hakkında ö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'tür. Bazı paketler için aşağıda belirtildiği gibi daha yüksek bir API düzeyi gerekir.

v4 Destek Kitaplıkları

Bu kitaplıklar; uygulama bileşenleri için destek, kullanıcı arayüzü özellikleri, erişilebilirlik, veri işleme, ağ bağlantısı ve programlama yardımcı programları için diğer kitaplıklara kıyasla en geniş API grubunu içerir.

v4 destek kitaplıklarının sağladığı 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ığı 24.2.0 düzeltmesinden önce tek bir v4 destek kitaplığı vardı. Bu kitaplık, verimliliği artırmak için birden fazla modüle bölündü. Geriye dönük uyumluluk için Gradle komut dosyanızda support-v4 öğesini 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 uyumlu kitaplığı

Context.obtainDrawable() ve View.performAccessibilityAction() gibi çeşitli çerçeve API'leri için uyumluluk sarmalayıcıları sağlar.

Bu kitaplık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:

com.android.support:support-compat:28.0.0

v4 core-utils kitaplığı

AsyncTaskLoader ve PermissionChecker gibi çeşitli yardımcı sınıflar sağlar.

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

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

v4 core-ui kitaplığı

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

Bu kitaplık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir: 

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

v4 media-compat kitaplığı

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

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

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

v4 snippet kitaplığı

Parçalar ile kullanıcı arayüzü ve işlevlerin kapsüllenmesi için destek eklendi. Böylece uygulamalar, küçük ve büyük ekranlı cihazlar arasında ayarlanabilen düzenler sunabilir. Bu modül, compat, core-utils, core-ui ve media-compat modüllerine bağlıdır.

Not: v13 destek kitaplığı bir FragmentCompat sınıfı sağlar. 4. sürüm Fragment sınıfı, daha sonraki platform sürümlerine eklenen hata düzeltmelerini sağlayan bağımsız bir sınıftır. 13. sürüm FragmentCompat sınıfı ise Fragment sınıfının çerçeve uygulaması için uyumluluk ara parçaları sağlar.

Bu kitaplık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir: 

com.android.support:support-fragment:28.0.0

Multidex Destek Kitaplığı

Bu kitaplık, birden fazla Dalvik Yürütülebilir (DEX) dosyasına sahip uygulama derleme desteği sağlar. 65.536'dan fazla yönteme referans veren uygulamaların çoklu APK yapılandırmalarını kullanması gerekir. Multidex kullanma hakkında daha fazla bilgi için 64.000'den Fazla Yöntemle Uygulama Oluşturma başlıklı makaleyi inceleyin.

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

com.android.support:multidex:1.0.0

v7 Destek Kitaplıkları

Bu kitaplıklar belirli özellik grupları sunar ve birbirinden bağımsız olarak uygulamanıza dahil edilebilir.

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

Not: Appcompat kitaplığı, bir Android Jetpack bileşeni olan AndroidX kitaplığına taşındı. Bu özelliği Sunflower demo uygulamasında kullanımda görebilirsiniz.

Bu kitaplık, İşlem çubuğu kullanıcı arayüzü tasarım kalıbı için destek ekler. Bu kitaplık, materyal tasarım kullanıcı arayüzü uygulamalarını destekler.

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

v7 appcompat kitaplığında yer alan önemli sınıflardan bazıları şunlardır:

  • ActionBar: İşlem çubuğu kullanıcı arayüzü kalıbını uygular. İş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 sınıfı ekler.
  • ShareActionProvider: İşlem çubuğuna dahil edilebilecek standartlaştırılmış bir paylaşım işlemi (ör. e-posta gönderme veya sosyal uygulamalarda yayınlama) için destek ekler.

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

com.android.support:appcompat-v7:28.0.0

v7 cardview kitaplığı

Bu kitaplık, CardView widget'ı için destek ekler. Bu widget, kartların içindeki bilgileri herhangi bir uygulamada tutarlı bir görünümle göstermenize olanak tanır. Bu kartlar, materyal tasarımı uygulamalarında 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ık tanımlayıcısı şu şekildedir:

com.android.support:cardview-v7:28.0.0

v7 ızgara düzeni kitaplığı

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

Bu kitaplık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:

com.android.support:gridlayout-v7:28.0.0

v7 mediarouter kitaplığı

Bu kitaplıkta MediaRouter, MediaRouteProvider ve Google Cast'i destekleyen ilgili medya sınıfları yer alır.

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 etmenin bir yolunu sağlar. Kitaplıkta, uygulamaya özel medya rotası sağlayıcıları yayınlamak, hedef cihazları keşfetmek ve seçmek, medya durumunu kontrol etmek ve daha fazlası için API'ler bulunur. v7 mediarouter kitaplık API'leri hakkında ayrıntılı bilgi için API referansında android.support.v7.media paketine bakın.

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

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şiklik görebilir. Şu anda kitaplığı yalnızca Google Cast ile bağlantılı olarak kullanmanızı öneririz.

v7 palet kitaplığı

v7 paleti destek kitaplığı, bir resimden belirgin renkleri ayıklamanıza olanak tanıyan Palette sınıfını içerir. Örneğin, bir müzik uygulaması, albüm kapağındaki ana renkleri ayıklamak için Palette nesnesi kullanabilir ve bu renkleri kullanarak renk uyumlu bir şarkı başlığı kartı oluşturabilir.

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

com.android.support:palette-v7:28.0.0

v7 geri dönüşüm görünümü 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'ı için destek sağlar.

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

com.android.support:recyclerview-v7:28.0.0

v7 Tercih Destek Kitaplığı

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

7. sürüm tercih kitaplığı, Preference.OnPreferenceChangeListener ve Preference.OnPreferenceClickListener gibi arayüzlere ve CheckBoxPreference ile ListPreference gibi sınıflara destek ekler.

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

com.android.support:preference-v7:28.0.0

v8 Destek Kitaplığı

Bu kitaplık belirli özellik grupları 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: Destek kitaplığıyla RenderScript 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ı ve ek parça destek sınıflarıyla parça kullanıcı arayüzü kalıbı için destek ekler. Parçalar hakkında daha fazla bilgi için Parçalar geliştirici kılavuzuna bakın. v13 Destek Kitaplığı API'leri hakkında ayrıntılı bilgi için API referansında android.support.v13 paketine bakın.

Not: v4 parça kitaplığı, Fragment sınıfı sağlar. 4. sürüm Fragment sınıfı, daha sonraki platform sürümlerine eklenen hata düzeltmelerini sağlayan bağımsız bir sınıftır. 13. sürüm FragmentCompat sınıfı ise Fragment sınıfının çerçeve uygulaması için uyumluluk ara parçaları sağlar.

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

com.android.support:support-v13:28.0.0

v14 Tercih Destek Kitaplığı

android.support.v14.preference paketi, MultiSelectListPreference ve PreferenceFragment gibi sınıfların yanı sıra PreferenceFragment.OnPreferenceStartFragmentCallback ve PreferenceFragment.OnPreferenceStartScreenCallback gibi tercih arayüzlerine destek eklemek için API'ler sağlar. 14 sürümü Tercih Destek Kitaplığı API'leri hakkında ayrıntılı bilgi için API referansında preference paketine bakın.

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

com.android.support:preference-v14:28.0.0

TV için v17 Tercih Destek Kitaplığı

android.support.v17.preference paketi, TV cihazlarında tercih arayüzleri sağlamak için API'ler sağlar. Bu API'ler, LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener arayüzü ve BaseLeanbackPreferenceFragment ile LeanbackPreferenceFragment gibi sınıflar için destek içerir. v17 Tercih Destek Kitaplığı API'leri hakkında ayrıntılı bilgi için API referansındaki tercih edilen pakete bakın.

Bu paket, API düzeyi 17 veya üstünü gerektiriyor. Bu kitaplığın Gradle derleme komut dosyası bağımlılık tanımlayıcısı şu şekildedir:

 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ı şunlardır:

Bu paket için API düzeyi 17 veya üzeri gerekir. Bu kitaplığın Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:

com.android.support:leanback-v17:28.0.0

Vektör Resmi Kitaplığı

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

Bu kitaplığın Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:

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

Animasyonlu Vektör Resmi Kitaplığı

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

Bu kitaplığın Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:

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ık tanımlayıcısı şu şekildedir:

com.android.support:support-annotations:28.0.0

Tasarım Destek Kitaplığı

Tasarım paketi, uygulamalarınıza materyal tasarım bileşenleri ve kalıpları eklemeyi destekleyen API'ler sağlar.

Tasarım Desteği kitaplığı, uygulama geliştiricilerin kullanabileceği çeşitli Materyal Tasarım bileşenleri ve kalıpları (ör. gezinme çekmeceleri, yüzen işlem düğmeleri (FAB), bilgi çubuğu ve sekmeler) için destek ekler.

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

com.android.support:design:28.0.0

Özel Sekmeler Destek Kitaplığı

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

Özel Sekmeler Destek kitaplığı, Özel Sekmeler Hizmeti ve Özel Sekmeler Geri Çağırma gibi çeşitli sınıflar için destek ekler.

Bu paket, API düzeyi 15 veya üstünü gerektiriyor. Bu kitaplığın Gradle derleme komut dosyası bağımlılık tanımlayıcısı şu şekildedir:

com.android.support:customtabs:28.0.0

Yüzde Destek Kitaplığı

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

Not: 26.0.0 sürümü itibarıyla Percent Destek kitaplığı 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'a taşınmalıdır.

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

Bu kitaplık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:

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 JPEG veya RAW dosyasında depolar. ExifInterface sınıfı, JPEG ve RAW (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW ve RAF) biçimli dosyalardan Exif bilgilerini okuma ve JPEG resim dosyalarında Exif bilgilerini ayarlama desteğini paketten çıkarır.

Bu kitaplık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir: 

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 ve ContentRecommendation ile RecommendationExtender gibi çeşitli sınıflar için destek ekler.

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

com.android.support:recommendation:28.0.0

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

Bu kitaplıkta, Wear uygulamaları için kullanıcı arayüzleri oluşturmaya yönelik API'lar bulunmaktadır. android.support.wear.widget paketinde bulunan API'ler, Wearable Destek Kitaplığı'ndaki 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ık tanımlayıcısı şu şekildedir: 

com.android.support:wear:28.0.0