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 行為變更和疑難解答主題,這些主題可能會影響現有的應用程式。