Not: Destek Kitaplığı 28.0.0 sürümüyle birlikte android.support
paketli kitaplıklar kullanımdan kaldırıldı ve yerini androidx
adlı paketteki Jetpack kitaplıkları aldı. Jetpack kitaplıklarının ilk 1.0.0 sürümü, Destek Kitaplığı 28.0.0 ile eşdeğerdir ve yeni androidx
paketine taşıma için bir başlangıç noktası sağlar.
Mevcut paket android.support
kitaplıklar çalışmaya devam edecektir. Ancak bunlar 28.0.0'dan sonraki güncellemeleri almayacak ve yeni Jetpack kitaplıklarıyla uyumlu olmayacaktır.
Geçmiş yapılar (27 ve önce sürümleri ile android.support
olarak paketlenmiş olan yapılar) Google Maven'da kullanılabilir olmaya devam eder. Tüm yeni yapılar androidx
olarak paketlenecek ve android.support
ile androidx
arasında taşınması gerekecek.
Tüm yeni projelerde androidx
kitaplıklarını kullanmanızı öneririz. Hata düzeltmelerini ve diğer kitaplık iyileştirmelerini almaya devam etmeleri için mevcut projeleri taşımanız da önerilir.
Android Destek Kitaplığı, uygulamanıza eklenebilecek çeşitli kitaplık paketleri içerir. Bu kitaplıkların her biri, belirli Android platformu sürümlerini ve özellik gruplarını 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'ndaki Destek Kitaplıklarını indirme talimatlarını uygulayın. Uygulamanıza belirli bir destek kitaplığı eklemek için ek adımlar atmanız gerekir. Kitaplığı kitaplığınıza nasıl ekleyeceğ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'tü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 dahil 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ığı 24.2.0 sürümünden önce tek bir v4 destek kitaplığı bulunuyordu. 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
öğesini listelerseniz uygulamanız tüm v4 modüllerini içerir. Ancak uygulamanızın boyutunu küçültmek için uygulamanızın ihtiyaç duyduğu belirli modülleri listelemenizi öneririz.
v4 yolcu kitaplığı
Context.obtainDrawable()
ve View.performAccessibilityAction()
gibi çeşitli çerçeve API'leri için uyumluluk sarmalayıcılar sunar.
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 temel yardımcı programlar kitaplığı
AsyncTaskLoader
ve PermissionChecker
gibi çeşitli yardımcı programlar 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-core-utils:28.0.0
v4 temel kullanıcı arayüzü kitaplığı
ViewPager
, NestedScrollView
ve ExploreByTouchHelper
gibi kullanıcı arayüzüyle ilgili çeşitli bileşenler 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 medya uyumlu kitaplığı
MediaBrowser
ve MediaSession
dahil olmak üzere medya çerçevesinin geri alanlarını gösterir.
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-media-compat:28.0.0
v4 parça kitaplığı
Parçalar ile kullanıcı arayüzü ve işlevleri kapsama alanı için destek sunarak uygulamaların küçük ve büyük ekranlı cihazlar arasında uyum sağlayan düzenler sunmasını sağlar. Bu modül compat, core-utils, core-ui ve media-compat'a bağımlıdır.
Not: v13 destek kitaplığı bir FragmentCompat
sınıfı sağlar. v4 Fragment
sınıfı, daha sonra sunulan platform sürümlerine eklenen hata düzeltmeleri sunan 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ı sunar.
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) dosya içeren uygulamalar oluşturma desteği sunar. 65.536'dan fazla yönteme referans veren uygulamaların çok noktalı yapılandırmaları kullanması gerekir. Multiplex'i kullanma hakkında daha fazla bilgi için 64K'dan Fazla Yöntemle Uygulama Oluşturma sayfasını inceleyin.
Bu kitaplık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:
com.android.support:multidex:1.0.0
v7 Destek Kitaplıkları
Bu kitaplıklar belirli özellik kümeleri sağlar ve birbirinden bağımsız olarak uygulamanıza dahil edilebilir.
App Store v7 kitaplığı Android Jetpack'in parçasıdır.
Not: Appcompat kitaplığı, Android Jetpack bileşeni olan AndroidX kitaplığına taşındı. Bu uygulamayı, Sunflower demo uygulamasında kullanın.
Bu kitaplık, İşlem Çubuğu kullanıcı arayüzü tasarım kalıbını destekler. Bu kitaplık, materyal tasarım kullanıcı arayüzü uygulamalarını da içerir.
Not: Bu kitaplık, v4 Destek Kitaplığı'na bağlıdır.
Aşağıda, v7 Appcompat kitaplığındaki bazı önemli sınıflar verilmiştir:
ActionBar
- İşlem çubuğu kullanıcı arayüzü kalıbının uygulanmasını sağlar. İşlem Çubuğu'nun kullanımı hakkında daha fazla bilgi için İşlem Çubuğu geliştirici kılavuzuna göz atı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
- Bir işlem çubuğuna eklenebilecek standartlaştırılmış bir paylaşım işlemi (e-posta veya sosyal uygulamalarda yayınlama gibi) 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:appcompat-v7:28.0.0
v7 kart görünümü kitaplığı
Bu kitaplık, CardView
widget'ını destekler. Bu widget, tüm uygulamalarda tutarlı bir görünüme sahip olan kartlarda bilgi göstermenizi sağlar. Bu kartlar, materyal tasarım uygulamaları için kullanışlıdır ve TV uygulamalarının düzenlerinde kapsamlı bir şekilde kullanılı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:cardview-v7:28.0.0
Sürüm 7 ızgara düzeni kitaplığı
Android Destek Kitaplıklarını indirdikten sonra bu kitaplık, dikdörtgen bir tablo ızgarası kullanarak kullanıcı arayüzü öğelerini düzenlemenize olanak tanıyan GridLayout
sınıfı desteği ekler.
v7 ızgara yerleşimi kitaplığı API'leri hakkında ayrıntılı bilgi için API referansındaki android.support.v7.widget
paketine bakı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 medya yönlendiricisi 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, geçerli kanaldan medya kanallarının ve akışların harici ekranlara, hoparlörlere ve diğer hedef cihazlara yönlendirilmesini kontrol etmenin bir yolunu sunar. Kitaplık, uygulamaya özel medya rotası sağlayıcılarını yayınlama, hedef cihazları bulup seçme ve medya durumunu kontrol etme gibi pek çok API'yi içerir. 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ık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:
com.android.support:mediarouter-v7:28.0.0
Destek Kitaplığı 18 sürümünde kullanıma sunulan v7 medyayüzer kitaplığı API'ları, Destek Kitaplığı'nın sonraki sürümlerinde değişiklik yapabilmektedir. Şu anda, kitaplığı yalnızca Google Cast ile bağlantılı olarak kullanmanızı öneririz.
v7 palet kitaplığı
v7 palet destek kitaplığı, bir resimden belirgin renkleri çıkarmanızı sağlayan Palette
sınıfını içerir. Örneğin, bir müzik uygulaması bir albüm kapağından ana renkleri çıkarmak için Palette
nesnesi kullanabilir ve bu renkleri kullanarak renk koordinalı bir şarkı başlık kartı oluşturabilir.
Bu kitaplık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:
com.android.support:palette-v7:28.0.0
v7 geri dönüşüm kitaplığı
Geri dönüşüm kitaplığı, RecyclerView
sınıfını ekler. Bu sınıf, sınırlı bir veri öğeleri penceresi sunarak büyük veri kümelerini verimli bir şekilde görüntülemeyi sağlayan RecyclerView widget'ını destekler.
Bu kitaplık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:
com.android.support:recyclerview-v7:28.0.0
v7 Tercih Desteği Kitaplığı
Tercih paketi, kullanıcıların kullanıcı arayüzü ayarlarını değiştirmeleri için CheckBoxPreference
ve ListPreference
gibi tercih edilen nesnelerin eklenmesini destekleyen API'ler sağlar.
v7 Tercih kitaplığı, Preference.OnPreferenceChangeListener
ve Preference.OnPreferenceClickListener
gibi arayüzler ve CheckBoxPreference
ve ListPreference
gibi 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:preference-v7:28.0.0
v8 Destek Kitaplığı
Bu kitaplık, belirli özellik kümeleri sağlar ve uygulamanıza diğer kitaplıklardan bağımsız olarak eklenebilir.
v8 createscript 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 ekleme adımlarının, diğer destek kitaplığı API'lerinden çok farklı olduğunu bilmeniz gerekir. 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ık için 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 sağlar. Parçalar hakkında daha fazla bilgi için Parçalar geliştirici kılavuzunu inceleyin. v13 Destek Kitaplığı API'leri hakkında ayrıntılı bilgi için API referansındaki android.support.v13
paketine bakın.
Not: v4 parça kitaplığı bir Fragment
sınıfı sağlar. v4 Fragment
sınıfı, daha sonra sunulan platform sürümlerine eklenen hata düzeltmeleri sunan 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ı sunar.
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-v13:28.0.0
v14 Tercih Desteği Kitaplığı
android.support.v14.preference
paketi, MultiSelectListPreference
ve PreferenceFragment
gibi sınıfların yanı sıra PreferenceFragment.OnPreferenceStartFragmentCallback
ve PreferenceFragment.OnPreferenceStartScreenCallback
gibi tercih edilen arayüzler için destek eklemek üzere API'ler sağlar. v14 Tercihler Destek Kitaplığı API'leri hakkında ayrıntılı bilgi için API referansındaki tercih paketine bakı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:preference-v14:28.0.0
TV için v17 Destek Desteği Kitaplığı
android.support.v17.preference
paketi, LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener
arayüzleri ve BaseLeanbackPreferenceFragment
ve LeanbackPreferenceFragment
gibi sınıflar için destek de dahil olmak üzere TV cihazlarında tercih arayüzleri sağlayan API'ler sağlar. v17 Tercih Desteği Kitaplığı API'leri hakkında ayrıntılı bilgi için API referansındaki tercih paketine bakın.
Bu paket, API düzeyi 17 veya üstünü gerektirir. Bu kitaplık için Gradle derleme komut dosyası bağımlı tanımlayıcısı aşağıdaki gibidir:
com.android.support:preference-leanback-v17:28.0.0
Leanback v17 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çok önemli widget sağlar. Önemli sınıflardan bazıları şunlardır:
BrowseFragment
- Kategori ve medya öğesi satırlarına göz atmak için birincil düzen oluşturmaya yarayan bir parçadır.DetailsFragment
- Leanback ayrıntılar ekranları için bir sarmalayıcı parçasıdır.PlaybackOverlayFragment
- Oynatma denetimlerini ve ilgili içeriği görüntülemek için kullanılanDetailsFragment
alt sınıfı.SearchFragment
- Aramaları işleyecek bir parça. Parça, kullanıcının arama isteğini alır ve uygulama tarafından sağlananSearchResultProvider
öğesine aktarır.SearchResultProvider
, arama sonuçlarınıSearchFragment
öğesine döndürerekRowsFragment
oluşturur.
Bu paket, API düzeyi 17 veya üstünü gerektirir. Bu kitaplık için Gradle derleme komut dosyası bağımlı tanımlayıcısı aşağıdaki gibidir:
com.android.support:leanback-v17:28.0.0
Vektör Çekilebilir Kitaplığı
Statik vektör grafikleri için destek 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-vector-drawable:28.0.0
Animasyonlu Vektör Çekilebilir Kitaplığı
Animasyonlu vektör grafikleri için destek 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:animated-vector-drawable:28.0.0
Ek Açıklamalar Destek Kitaplığı
Ek açıklama paketi, uygulamalarınıza ek açıklama meta verisi eklemeyi destekleyen API'ler 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-annotations:28.0.0
Tasarım Destek Kitaplığı
Tasarım paketi, uygulamalarınıza malzeme tasarımı bileşenleri ve desenleri eklemeyi destekleyen API'ler sağlar.
Tasarım Desteği kitaplığı, uygulama geliştiricilerin temel alabileceği çeşitli malzeme tasarımı bileşenleri ve desenleri (ör. gezinme çekmeceleri, kayan işlem düğmeleri (FAB), yemek çubukları ve sekmeler için destek 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:design:28.0.0
Özel Sekmeler Destek Kitaplığı
Özel Sekmeler paketi, uygulamalarınızdaki özel sekmelerin eklenmesini ve yönetilmesini destekleyen API'ler sağlar.
Özel Sekmeler Destek kitaplığı, Özel Sekmeler Hizmet ve Özel Sekmeler İçin Geri Çağırma gibi çeşitli sınıflara yönelik destek ekler.
Bu paket, API düzeyi 15 veya üstünü gerektirir. Bu kitaplık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:
com.android.support:customtabs:28.0.0
Percent Destek Kitaplığı
Percent paketi, uygulamanızda yüzdeye dayalı boyutların eklenmesini ve yönetilmesini destekleyen API'ler sağlar.
Not: Sürüm 26.0.0'dan itibaren, Percent Destek kitaplığı kullanımdan kaldırılmıştır.
Bu modülün müşterileri, SDK Manager'da ayrı bir yapı olarak sağlanan yeni ConstraintLayout
widget'ına geçiş yapmalıdır.
Percent Destek kitaplığı, PercentPercentHelper.PercentLayoutParams arayüzü ve PercentFrameLayout ve PercentPercentLayout gibi çeşitli sınıflar için destek 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: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ında depolar. ExifInterface
sınıfı, JPEG ve ham dosyalarda (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW ve RAF) Exif bilgilerini okuma ve JPEG resim dosyalarında Exif bilgilerini ayarlama desteği sunar.
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 eklenmesini destekleyen API'ler sunar.
Uygulama kitaplığı, ContentSuggest.ContentMaturity gibi ek açıklamaların yanı sıra ContentEx ve SuggestExtender gibi çeşitli sınıfları destekler.
Bu paket, API düzeyi 21 veya üstünü gerektirir. Bu kitaplık için Gradle derleme komut dosyası bağımlılık tanımlayıcısı aşağıdaki gibidir:
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, Giyilebilir Cihaz Destek Kitaplığı'ndaki ilgili API'lerin yerini alır.
Daha fazla bilgi için Wear kullanıcı arayüzü kitaplığını kullanma bölümüne bakı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:wear:28.0.0