AndroidX 與 Xamarin

如何使用 Xamarin.Android 開始使用 AndroidX 開發應用程式。

AndroidX 是原始 Android 支持連結庫的重大改進,不再維護。 AndroidX 套件提供可在 Android 應用程式中使用的功能同位和新連結庫,以完整取代 Android 支援連結庫。

AndroidX 包含下列功能:

  • AndroidX 內的所有套件現在都有一致的命名空間,從 androidx開始。 這表示所有 Android 支援連結庫套件都會對應至對應的 androidx.* 套件。
  • androidx 套件會個別維護及更新。 這表示您可以彼此獨立更新 AndroidX 連結庫。
  • 從 Android 支援連結庫的 v28 開始,將不再有版本。 所有開發都會改為包含在 中 androidx

AndroidX Logo

需求

下列清單需要使用以 Xamarin 為基礎的應用程式中的 AndroidX 功能:

  • Visual Studio - 在 Windows 上更新至 Visual Studio 2019 16.4 版或更新版本。 在 macOS 上,更新至 Visual Studio 2019 for Mac 8.4 版或更新版本。
  • Xamarin.Android - Xamarin.Android 10.0 或更新版本必須隨 Visual Studio 一起安裝(Xamarin.Android 會自動安裝為 Windows 上行動裝置開發 With .NET 工作負載的一部分,並安裝為 Visual Studio for Mac 安裝程式一部分)
  • Java Developer Kit - Xamarin.Android 10.0 開發需要 JDK 8。 Microsoft 的 OpenJDK 發行版會自動安裝為 Visual Studio 的一部分。
  • Android SDK - Android SDK API 28 或更高版本必須透過 Android SDK 管理員安裝。

開始使用

您可以在 Android 專案內包含任何 AndroidX NuGet 套件 ,以開始使用 AndroidX。 深入瞭解在Visual Studio或Visual Studio for Mac 中安裝和使用套件

行為變更

因為AndroidX是Android支援連結庫的重新設計,所以它包含會影響使用Android支援連結庫建置之Android應用程式的移轉步驟。

套件名稱變更

舊套件和新套件之間的套件名稱已變更。 您可以在下方看到這些變更的範例:

舊版 新增
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。@

如需套件命名的詳細資訊, 請參閱下列檔

移轉工具

有三個移轉步驟可供您瞭解您的應用程式。

  1. 如果您的應用程式包含 Android 支援連結庫命名空間,而且您想要將其遷移至 AndroidX 命名空間,您可以使用我們的 移轉至 AndroidX IDE 工具來處理大部分的命名空間案例。

透過 Visual Studio 2019 內的工具>選項 > Xamarin > Android 設定 啟用 AndroidX 移轉程式(您可以在 Visual Studio for Mac 上略過此步驟)。

Enable AndroidX Migrator

以滑鼠右鍵按下您的項目,然後 移轉至 AndroidX

Migrate To AndroidX

注意

您必須針對工具未涵蓋的案例進行一些手動命名空間變更。 雖然我們會為您對應正確的套件,但建議您查看官方 成品對應類別對應 ,以協助您的專案移轉。

  1. 如果您的應用程式包含 任何尚未移轉至 AndroidX 命名空間的相依性,您必須使用 Android 支援連結庫至 AndroidX 移轉套件。
  2. 如果您的應用程式 不包含任何需要 AndroidX 命名空間移轉的相依性,您可以在 NuGet 上使用 AndroidX 連結庫。

疑難排解

  • AndroidX 內的某些架構套件將會與支持連結庫版本衝突。 若要修正此問題,您應該使用這些套件的 AndroidX 版本,並移除支援連結庫版本。 例如,如果您在項目中參考 Xamarin.Android.Arch.Work.Runtime ,它將會與新加入 AndroidX.Work 之套件的類型衝突。

摘要

本文介紹 AndroidX,並說明如何使用 AndroidX 安裝及設定 Xamarin.Android 開發的最新工具和套件。 它提供 AndroidX 是什麼概觀。 其中包含 API 檔和 Android 開發人員主題的連結,可協助您開始使用 AndroidX 建立應用程式。 它也會醒目提示最重要的 AndroidX 行為變更和疑難解答主題,這些主題可能會影響現有的應用程式。