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.
Birden çok API sürümünü destekleyen uygulamalar geliştirirken, sürümlerinde yeni özellikler sağlamanın standart bir yolu olan ve eşdeğer işlevlere geri dönüyor. Kod oluşturmak yerine Bu kitaplıklardan yararlanarak platformun önceki sürümlerini kullanabilir, sağlamak için çok iyidir. Ayrıca, Destek Kitaplıkları şurada bulunmayan ek kolaylık dersleri ve özellikleri sağlayabilirsiniz: Daha kolay geliştirme ve destek için standart Çerçeve API'si cihazlar.
Önceden uygulamalar için tek bir ikili program kitaplığı olan Android Destek Kitaplığı uygulama geliştirmeye yönelik bir kitaplık paketine dönüştü. Bunların birçoğu kitaplıklarının artık zorunlu olmasa da uygulamanın bir parçası olması şiddetle tavsiye ediliyor. bahsedeceğim.
Bu dokümanda, size yardımcı olmak için destek kitaplığına genel bir bakış sunulmaktadır bileşenlerini ve uygulamanızda etkili şekilde nasıl kullanacağınızı anlamanıza yardımcı olabilir.
Dikkat: Destek Kitaplığı 26.0.0 sürümünden itibaren geçerlidir (Temmuz 2017), çoğu destek kitaplığında desteklenen minimum API düzeyi , çoğu kitaplık paketi için Android 4.0 (API düzeyi 14) sürümüne yükseldi. Örneğin, Daha fazla bilgi için Sürüm Desteği ve Paket Adlar bölümüne bakın.
Destek Kitaplıklarının Kullanımları
Destek kitaplıklarının birkaç farklı kullanım alanı vardır. Geri uyumluluk sınıfları, platformun önceki sürümleri için gerekir. Destek kitaplıklarını kullanmanın daha kapsamlı bir listesi aşağıda verilmiştir inceleyebilirsiniz:
-
Yeni API'ler için Geriye Dönük Uyumluluk -
destek kitaplıkları yeni çerçeve için geriye dönük uyumluluk sağlar
ve yöntemler. Örneğin,
Fragmentdestek sınıfı, sürümleri çalıştıran cihazlarda parçalar için destek sağlar . -
Kolaylık ve Yardımcı Sınıflar: Destek kitaplıkları
yardımcı sınıfların sayısını artırır. Örneğin,
Örneğin,
RecyclerViewsınıfı bir kullanıcıya çok uzun listeleri görüntülemek ve yönetmek için kullanılan arayüz widget'ı; API düzeyi 7 ve sonraki sürümlerdeki Android sürümlerinde kullanılabilir. -
Hata Ayıklama ve Yardımcı Programlar - Çok sayıda özellik vardır
uygulamanıza entegre ettiğiniz kodun ötesinde bir fayda sağlayan,
support-annotationsyöntem girişlerinde geliştirilmiş kod lint kontrolleri için kitaplığı ve Multidex desteği 65.536'dan fazla yöntemle uygulamaları yapılandırıp dağıtıyor.
Destek ve Çerçeve API'lerini Kullanma
Destek Kitaplıkları, bahsedeceğim. Bunu öğrendikten sonra, dilerseniz API'nin çerçeve sürümünü veya destek kitaplığı eşdeğerini kullanın. Burası destek kitaplığı sınıflarını ne zaman kullanmanız gerektiğine ilişkin yönergeler hakkında daha fazla bilgi edinin:
- Belirli Bir Özellik için Uyumluluk - sürümlerinin yüklü olduğu cihazlardaki yeni platform özelliği destek kitaplığındaki eşdeğer sınıfları ve yöntemleri kullanın.
-
İlgili Kitaplık Özellikleri ile Uyumluluk - Daha gelişmiş
destek kitaplığı sınıfları bir veya daha fazla ek desteğe bağlı olabilir
bu nedenle eğitim için destek kitaplığı sınıflarını
ve bildirmeyi konuştuk. Örneğin,
ViewPagerdestek sınıfı,FragmentPagerAdapterveyaFragmentStatePagerAdapterdestek sınıflarıyla birlikte kullanılmalıdır. -
Genel Cihaz Uyumluluğu - Belirli bir
geriye dönük uyumlu bir şekilde uygulamanızla kullanmayı düşündüğünüz platform özelliği
Bu şekilde, uygulamanızda destek kitaplığı sınıflarını kullanmak yine de iyi bir fikirdir.
Örneğin, yeni özelliklerden yararlanmak için
Activityçerçevesi yerineActivityCompatkullanabilirsiniz. örneğin, Android 6.0 (API düzeyi 23).
Platformun uyumlu bir uygulamasını sağlayan kitaplık sınıflarını destekleyin API sınıfları, tüm işlevleri sunmayabilir Android'deki yeni bir sürüm olduğundan platform sürümü gereklidir. Bu durumlarda Destek Kitaplığı sınıfları, yardımcı olabilir ve sahip olduğu tüm işlevleri ya da verileri API'yi kullanabilirsiniz. Bu nedenle, referansı incelemelisiniz. yöntemleriyle ilgili belgeleri ve kaynakları eksiksiz bir şekilde Google tarafından desteklenen en eski platform sürümünü çalıştıran cihazlarda test edin. en iyi şekilde yararlanabilirsiniz.
Not: Destek kitaplıkları bu işlevin eşdeğerini her çerçeve API'sinin sınıfları ve yöntemlerini inceleyeceğiz. Bazı durumlarda, bir çerçeve yöntemi çağrısını açık bir SDK sürüm kontrolüyle sarmalayıp bir cihazda bulunmayan yöntemleri işlemek için alternatif kod. Daha fazla kodunuzda sürüm kontrollerini kullanma hakkında bilgi için Farklı Destekleme Platform Sürümleri.
Sürüm Desteği ve Paket Adları
Bazı Destek Kitaplığı paketlerinin, Google'ın başlangıçta desteklediği minimum API düzeyini bir v# gösterimi kullanarak, support-v4 paketi Destek Kitaplığı 26.0.0 sürümünden itibaren (sürüm Temmuz 2017) itibarıyla, desteklenen minimum API düzeyi Android 4.0 (API) olarak değişti. düzeyi 14) kullanın. Bu nedenle, bir ekiple çalışırken kullanıma sunulmasından sonra, v# paket gösterimi minimum API destek düzeyini belirtir. Son sürümlerde yapılan bu değişiklik, v4 v7 temel olarak destekledikleri minimum API düzeyinde eşdeğerdir. Örneğin, support-v4 ve support-v7 paketinin her ikisi de minimum bir Destek Kitaplığı'nın 26.0.0 ve sonraki sürümleri için API düzeyi 14.
Destek Kitaplığı Sürüm Sürümleri
Destek Kitaplığı'nın 24.2.0 veya 25.0.1 gibi bir sürümü her kitaplık tarafından desteklenen minimum API düzeyinden farklı olmalıdır. yayın.Sürüm sürüm numarası, platformun hangi sürümünün ve dolayısıyla en yeni API'lerin neler için dahil edilmiştir.
Özellikle, sürüm numarasının ilk bölümü, örneğin 24.2.0 sürümündeki 24 sürümü, genellikle platform API'sini kullanıma sunduk. Öğenin sürüm düzeyi destek kitaplığı, söz konusu API'nin bazı özelliklerini içerdiğini belirtir ile uyumludur, ancak tüm tüm yeni platform API sürümünde kullanıma sunulan özellikler.
Kitaplık Bağımlılıkları
Android Destek Kitaplığı paketindeki çoğu kitaplık,
kullanabilirsiniz. Örneğin, neredeyse tüm destek kitaplıklarında
bağımlılığı support-compat. Genel olarak,
destek kitaplığı bağımlılıkları konusunda endişelenmeniz gerekir çünkü gradle derlemesi
araç, kitaplık bağımlılıklarını sizin için yönetir;
bağımlı kitaplıklar var.
Hangi kitaplıkların ve kitaplık bağımlılıklarının dahil olduğunu uygulamanızda kullanıyorsanız, uygulama geliştirmenizin derleme kökünde aşağıdaki komutu çalıştırın söz konusu projenin bağımlılıklarının bir raporunu almak için Android Destek Kitaplıkları ve diğer kitaplıklar:
gradle -q dependencies your-app-project:dependencies
Geliştirme sürecinize destek kitaplıkları ekleme hakkında daha fazla bilgi daha fazla bilgi edinmek için Destek Kitaplık Kurulumu bölümünde bulabilirsiniz. Gradle ile çalışma hakkında daha fazla bilgi için bkz. Yapılandır Yapınız.
Tüm Android Destek Kitaplıklarının da bazı temel düzeylere bağlı olduğunu unutmayın Android 4.0 (API düzeyi 14) veya daha yüksek olabilir.