AndroidX 與 Xamarin
如何使用 Xamarin.Android 開始使用 AndroidX 開發應用程式。
AndroidX 是原始 Android 支持連結庫的重大改進,不再維護。 AndroidX 套件提供可在 Android 應用程式中使用的功能同位和新連結庫,以完整取代 Android 支援連結庫。
AndroidX 包含下列功能:
- AndroidX 內的所有套件現在都有一致的命名空間,從
androidx
開始。 這表示所有 Android 支援連結庫套件都會對應至對應的androidx.*
套件。 androidx
套件會個別維護及更新。 這表示您可以彼此獨立更新 AndroidX 連結庫。- 從 Android 支援連結庫的 v28 開始,將不再有版本。 所有開發都會改為包含在 中
androidx
。
需求
下列清單需要使用以 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。@ |
如需套件命名的詳細資訊, 請參閱下列檔。
移轉工具
有三個移轉步驟可供您瞭解您的應用程式。
- 如果您的應用程式包含 Android 支援連結庫命名空間,而且您想要將其遷移至 AndroidX 命名空間,您可以使用我們的 移轉至 AndroidX IDE 工具來處理大部分的命名空間案例。
透過 Visual Studio 2019 內的工具>選項 > Xamarin > Android 設定 啟用 AndroidX 移轉程式(您可以在 Visual Studio for Mac 上略過此步驟)。
以滑鼠右鍵按下您的項目,然後 移轉至 AndroidX。
- 如果您的應用程式包含 任何尚未移轉至 AndroidX 命名空間的相依性,您必須使用 Android 支援連結庫至 AndroidX 移轉套件。
- 如果您的應用程式 不包含任何需要 AndroidX 命名空間移轉的相依性,您可以在 NuGet 上使用 AndroidX 連結庫。
疑難排解
- AndroidX 內的某些架構套件將會與支持連結庫版本衝突。 若要修正此問題,您應該使用這些套件的 AndroidX 版本,並移除支援連結庫版本。 例如,如果您在項目中參考
Xamarin.Android.Arch.Work.Runtime
,它將會與新加入AndroidX.Work
之套件的類型衝突。
摘要
本文介紹 AndroidX,並說明如何使用 AndroidX 安裝及設定 Xamarin.Android 開發的最新工具和套件。 它提供 AndroidX 是什麼概觀。 其中包含 API 檔和 Android 開發人員主題的連結,可協助您開始使用 AndroidX 建立應用程式。 它也會醒目提示最重要的 AndroidX 行為變更和疑難解答主題,這些主題可能會影響現有的應用程式。