Xamarin ile AndroidX

  • Makale

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

AndroidX, artık korunmayan orijinal Android Destek Kitaplığı için önemli bir iyileş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 ilgili androidx.* paketle eş olduğu anlamına gelir.
  • androidx paketler ayrı olarak korunur 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 - Windows'ta Visual Studio 2019 sürüm 16.4 veya sonraki bir sürüme güncelleştirme. 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 ile yüklenmelidir (Xamarin.Android, Windows'da .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 Geliştirici Seti - Xamarin.Android 10.0 geliştirmesi için JDK 8 gerekir. Microsoft'un OpenJDK dağıtımı Visual Studio'nun 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.

Kullanmaya başlayın

Android projenizin içine herhangi bir AndroidX NuGet paketi ekleyerek AndroidX'i kullanmaya başlayabilirsiniz. Visual Studio'da veya Mac için Visual Studio bir paketi 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ı senaryosuyla ilgilenmek için AndroidX IDE'ye Geçiş aracı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çir'i seçin.

Migrate To AndroidX

Not

Aracın kapsamadığı senaryolar için bazı el ile 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 herhangi bir bağımlılık içermiyorsa, bugün NuGet'te 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, projenize 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çları ve paketleri yükleme ve yapılandırma işlemi 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ı.