Bagikan melalui

AndroidX dengan Xamarin

  • Artikel

Cara mulai mengembangkan aplikasi dengan AndroidX menggunakan Xamarin.Android.

AndroidX adalah peningkatan besar pada Android Support Library asli, yang tidak lagi dipertahankan. Paket AndroidX sepenuhnya menggantikan Android Support Library dengan menyediakan paritas fitur dan pustaka baru yang dapat Anda gunakan di aplikasi Android Anda.

AndroidX menyertakan fitur-fitur berikut:

  • Semua paket di dalam AndroidX sekarang memiliki namespace yang konsisten dimulai dengan androidx. Ini berarti semua paket Pustaka Dukungan Android dipetakan ke paket yang androidx.* sesuai.
  • androidx paket dikelola dan diperbarui secara terpisah. Ini berarti Anda dapat memperbarui pustaka AndroidX secara independen satu sama lain.
  • Pada v28 Dari Android Support Library, tidak akan ada lagi rilis. Semua pengembangan akan disertakan sebagai androidx gantinya.

AndroidX Logo

Persyaratan

Daftar berikut diperlukan untuk menggunakan fitur AndroidX di aplikasi berbasis Xamarin:

  • Visual Studio - Pada pembaruan Windows ke Visual Studio 2019 versi 16.4 atau yang lebih baru. Di macOS, perbarui ke Visual Studio 2019 untuk Mac versi 8.4 atau yang lebih baru.
  • Xamarin.Android - Xamarin.Android 10.0 atau yang lebih baru harus diinstal dengan Visual Studio (Xamarin.Android secara otomatis diinstal sebagai bagian dari Beban kerja Mobile Development With .NET di Windows dan diinstal sebagai bagian dari Penginstal Visual Studio untuk Mac)
  • Pengembangan Java Developer Kit - Xamarin.Android 10.0 memerlukan JDK 8. Distribusi OpenJDK Microsoft secara otomatis diinstal sebagai bagian dari Visual Studio.
  • Android SDK - Android SDK API 28 atau yang lebih tinggi harus diinstal melalui Android SDK Manager.

Memulai

Anda dapat mulai menggunakan AndroidX dengan menyertakan paket AndroidX NuGet apa pun di dalam proyek Android Anda. Pelajari selengkapnya tentang menginstal dan menggunakan paket di Visual Studio atau Visual Studio untuk Mac

Perubahan perilaku

Karena AndroidX adalah desain ulang Android Support Library, Android Support Library menyertakan langkah-langkah migrasi yang akan memengaruhi aplikasi Android yang dibangun dengan Android Support Library.

Perubahan Nama Paket

Nama paket telah diubah antara paket lama dan baru. Di bawah ini Anda dapat melihat contoh perubahan ini:

Tua Baru
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. @

Untuk detail selengkapnya tentang penamaan paket, lihat dokumentasi berikut.

Alat Migrasi

Ada tiga langkah migrasi yang ingin Anda waspadai untuk aplikasi Anda.

  1. Jika aplikasi Anda menyertakan namespace Android Support Library dan ingin memigrasikannya ke namespace AndroidX, Anda dapat menggunakan alat Migrate to AndroidX IDE kami untuk mengurus sebagian besar skenario namespace.

Aktifkan AndroidX Migrator melalui Opsi > Alat > Xamarin > Android Pengaturan di dalam Visual Studio 2019 (Anda dapat melewati langkah ini di Visual Studio untuk Mac).

Enable AndroidX Migrator

Klik kanan proyek Anda dan Migrasikan ke AndroidX.

Migrate To AndroidX

Catatan

Anda harus membuat beberapa perubahan namespace manual untuk skenario yang tidak dicakup alat. Meskipun kami akan memetakan paket yang benar untuk Anda, dianjurkan agar Anda melihat pemetaan artefak resmi dan pemetaan kelas untuk membantu migrasi proyek Anda.

  1. Jika aplikasi Anda menyertakan dependensi yang belum dimigrasikan ke namespace AndroidX, Anda harus menggunakan paket Android Support Library ke AndroidX Migration.
  2. Jika aplikasi Anda tidak menyertakan dependensi apa pun yang memerlukan migrasi namespace AndroidX, Anda dapat menggunakan pustaka AndroidX di NuGet hari ini.

Pemecahan Masalah

  • Paket arsitektur tertentu dalam AndroidX akan berkonflik dengan versi Pustaka Dukungan. Untuk memperbaikinya, Anda harus menggunakan versi AndroidX dari paket ini dan menghapus versi Pustaka Dukungan. Misalnya, jika Anda mereferensikan Xamarin.Android.Arch.Work.Runtime dalam proyek Anda, itu akan bertentangan dengan jenis paket yang baru ditambahkan AndroidX.Work .

Ringkasan

Artikel ini memperkenalkan AndroidX dan menjelaskan cara menginstal dan mengonfigurasi alat dan paket terbaru untuk pengembangan Xamarin.Android dengan AndroidX. Ini memberikan gambaran umum tentang apa itu AndroidX. Ini termasuk tautan ke dokumentasi API dan topik Android Developer untuk membantu Anda mulai membuat aplikasi menggunakan AndroidX. Ini juga menyoroti perubahan perilaku AndroidX yang paling penting dan topik pemecahan masalah yang dapat memengaruhi aplikasi yang ada.