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 eşdeğerlik sağlar ve yeni androidx paketine taşıma için bir başlangıç noktası sunar.

Mevcut android.support paketli kitaplıklar çalışmaya devam edecek ancak 28.0.0'den sonraki sürümlerde güncellenmeyecek ve yeni Jetpack kitaplıklarıyla uyumlu olmayacaktır. Geçmiş yapı taşları (27 ve önceki sürümlere sahip ve android.support olarak paketlenmiş olanlar) Google Maven'de kullanılabilir durumda kalacaktır. 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üzeltmeleri ve diğer kitaplık iyileştirmelerini almaya devam etmeleri için mevcut projeleri taşımayı da düşünmeniz gerekir.

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ü 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, kullanıcı arayüzü özellikleri, erişilebilirlik, veri işleme, ağ bağlantısı ve programlama yardımcı programları için destek de dahil olmak üzere diğer kitaplıklara kıyasla en büyük 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 yalnızca uygulamanızın ihtiyaç duyduğu 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ığın Gradle derleme komut dosyası bağımlılık tanımlayıcısı şu şekildedir:

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ığın Gradle derleme komut dosyası bağımlılık tanımlayıcısı şu şekildedir: 

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ünün ve işlevselliğinin kapsüllenmesine yönelik destek ekler. Bu sayede uygulamalar, küçük ve büyük ekranlı cihazlar arasında ayarlanan yerleşimler sunabilir. Bu modül, compat, core-utils, core-ui ve media-compat modüllerine bağlıdır.

Not: v13 destek kitaplığı, 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ığın Gradle derleme komut dosyası bağımlılık tanımlayıcısı şu şekildedir: 

com.android.support:support-fragment:28.0.0

Multidex Destek Kitaplığı

Bu kitaplık, birden fazla Dalvik yürütülebilir (DEX) dosyası içeren uygulamalar oluşturma 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ı sağlar ve birbirinden bağımsız olarak uygulamanıza 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ı. 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 uygulama uyumluluğu kitaplığına dahil edilen temel sınıflardan birkaçını aşağıda bulabilirsiniz:

  • ActionBar: İşlem çubuğu kullanıcı arayüzü kalıbını uygular. İşlem çubuğu hakkında daha fazla bilgi edinmek 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: İşlem çubuğuna eklenebilecek 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 gridlayout 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 gridlayout kitaplığı API'leri hakkında ayrıntılı bilgi için API referansında android.support.v7.widget paketine bakın.

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

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 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ığı 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 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'ı 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üzleri için destek eklemek üzere 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. 17 sürümü Tercih Destek Kitaplığı API'leri hakkında ayrıntılı bilgi için API referansında preference paketine bakın.

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ı ş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ı şu şekildedir:

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ı şu şekildedir:

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ı ş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ı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 için API düzeyi 15 veya üzeri gerekir. 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 Support kitaplığının desteği sonlandırılmıştır. Bu modülün istemcileri, SDK Yöneticisi'nde ayrı bir yapı olarak sağlanan yeni ConstraintLayout widget'a geçmelidir.

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

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

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ığın Gradle derleme komut dosyası bağımlılık tanımlayıcısı şu şekildedir: 

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'ler bulunur. 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