Xamarin ile AndroidX

Xamarin.Android kullanarak AndroidX ile uygulama geliştirmeye başlama.

AndroidX, artık korunmayan orijinal Android Destek Kitaplığı'na yapılan önemli bir geliştirmedir. AndroidX paketleri, Android uygulamalarınızda kullanabileceğiniz özellik eşlikleri ve yeni kitaplıklar sağlayarak Android Destek Kitaplığı'nın yerini tamamen alır.

AndroidX aşağıdaki özellikleri içerir:

  • AndroidX içindeki tüm paketler artık ile androidxbaşlayan tutarlı bir ad alanına sahiptir. Bu, tüm Android Destek Kitaplığı paketlerinin karşılık gelen androidx.* bir paketle eş olduğu anlamına gelir.
  • androidx paketler ayrı ayrı tutulur ve güncelleştirilir. Bu, AndroidX kitaplıklarını birbirinden bağımsız olarak güncelleştirebileceğiniz anlamına gelir.
  • Android Destek Kitaplığı'nın v28 sürümünden itibaren başka sürüm olmayacaktır. Bunun yerine tüm geliştirmeler dahil androidx edilecek.

AndroidX Logo

Gereksinimler

Xamarin tabanlı uygulamalarda AndroidX özelliklerini kullanmak için aşağıdaki liste gereklidir:

  • Visual Studio - Visual Studio 2019 sürüm 16.4 veya sonraki bir sürüme Windows güncelleştirmesinde. macOS'ta, Mac için Visual Studio 2019 sürüm 8.4 veya sonraki bir sürüme güncelleştirin.
  • Xamarin.Android - Xamarin.Android 10.0 veya üzeri Visual Studio yüklü olmalıdır (Xamarin.Android, Windows üzerinde .NET ile Mobil Geliştirme iş yükünün bir parçası olarak otomatik olarak yüklenir ve Mac için Visual Studio Yükleyicisi'nin bir parçası olarak yüklenir)
  • Java Developer Kit - Xamarin.Android 10.0 geliştirmesi için JDK 8 gerekir. Microsoft'un OpenJDK dağıtımı, Visual Studio bir parçası olarak otomatik olarak yüklenir.
  • Android SDK - Android SDK API 28 veya üzeri, Android SDK Yöneticisi aracılığıyla yüklenmelidir.

Başlarken

Android projenizin içine herhangi bir AndroidX NuGet paketi ekleyerek AndroidX kullanmaya başlayabilirsiniz. Visual Studio veya Mac için Visual Studio'da paket yükleme ve kullanma hakkında daha fazla bilgi edinin

Davranış değişiklikleri

AndroidX, Android Destek Kitaplığı'nın yeniden tasarımı olduğundan, Android Destek Kitaplığı ile oluşturulan Android uygulamalarını etkileyecek geçiş adımlarını içerir.

Paket Adı Değişikliği

Paket adları eski ve yeni paketler arasında değiştirildi. Aşağıda bu değişikliklerin bir örneğini görebilirsiniz:

Eski Yeni
android.support.** androidx. @
android.design.** com.google.android.material. @
android.support.test.** androidx.test. @
android.arch.** androidx. @
android.arch.persistence.room.** androidx.room. @
android.arch.persistence.** androidx.sqlite. @

Paket adlandırma hakkında daha fazla bilgi için aşağıdaki belgelere bakın.

Geçiş Araçları

Uygulamanız için bilmeniz gereken üç geçiş adımı vardır.

  1. Uygulamanız Android Destek Kitaplığı ad alanları içeriyorsa ve bunları AndroidX ad alanlarına geçirmek istiyorsanız, çoğu ad alanı senaryosunu halletmek için AndroidX IDE'ye Geçiş araçlarımızı kullanabilirsiniz.

Visual Studio 2019'da Araçlar > Seçenekleri > Xamarin > Android Ayarlar aracılığıyla AndroidX Geçişi'ni etkinleştirin (bu adımı Mac için Visual Studio atlayabilirsiniz).

Enable AndroidX Migrator

Projenize sağ tıklayın ve AndroidX'e Geçiş'i seçin.

Migrate To AndroidX

Not

Aracın kapsamadığı senaryolar için el ile bazı ad alanı değişiklikleri yapmanız gerekir. Sizin için doğru paketi eşleyeceğiz ancak proje geçişinize yardımcı olmak için resmi yapıt eşlemelerini ve sınıf eşlemelerini incelemeniz önerilir.

  1. Uygulamanız AndroidX ad alanına geçirilmemiş bağımlılıklar içeriyorsa, Android Destek Kitaplığı'nı AndroidX'e Geçiş paketi kullanmanız gerekir.
  2. Uygulamanız AndroidX ad alanı geçişi gerektiren bağımlılıklar içermiyorsa, bugün NuGet'de AndroidX kitaplıklarını kullanabilirsiniz.

Sorun giderme

  • AndroidX içindeki bazı mimari paketleri Destek Kitaplığı sürümleriyle çakışacaktır. Bunu düzeltmek için bu paketlerin AndroidX sürümünü kullanmanız ve Destek Kitaplığı sürümünü kaldırmanız gerekir. Örneğin, projenizde başvuruyorsanız Xamarin.Android.Arch.Work.Runtime , yeni eklenen AndroidX.Work paketin türleriyle çakışacaktır.

Özet

Bu makalede AndroidX tanıtıldı ve AndroidX ile Xamarin.Android geliştirme için en son araç ve paketlerin nasıl yükleneceği ve yapılandırılacakları açıklandı. AndroidX'in ne olduğuna genel bir bakış sağladı. AndroidX kullanarak uygulama oluşturmaya başlamanıza yardımcı olmak için API belgelerinin ve Android Geliştirici konularının bağlantılarını içerir. Ayrıca mevcut uygulamaları etkileyebilecek en önemli AndroidX davranış değişikliklerini ve sorun giderme konularını da vurguladı.