設定 Xamarin.Android 的 Android SDK

Visual Studio 包含 Android SDK 管理員,可用來下載 Android SDK 工具、平台,以及開發 Xamarin.Android 應用程式所需的其他元件。

概觀

本指南說明如何在 Visual Studio 和 Visual Studio for Mac 中使用 Xamarin Android SDK 管理員。

注意

本指南適用於 Visual Studio 2019、Visual Studio 2017 和 Visual Studio for Mac。

Xamarin Android SDK 管理員 (與使用 .NET 的行動開發工作負載一併安裝) 可協助您下載開發 Xamarin.Android 應用程式所需的最新 Android 元件。 它會取代 Google 已過時的獨立 SDK 管理員。

規格需求

若要使用 Xamarin Android SDK 管理員,您需要下列項目:

  • Visual Studio 2019 Community、Professional 或 Enterprise。

  • 或是 Visual Studio 2017 (Community、Professional 或 Enterprise 版本)。 需要 Visual Studio 2017 15.7 版或更新版本。

  • Visual Studio Tools for Xamarin 4.10.0 版或更新版本 (隨著用 .NET 進行行動裝置開發工作負載安裝)。

Xamarin Android SDK 管理員也需要 Java 開發套件 (會隨 Xamarin.Android 自動安裝)。 有多個 JDK 替代項目可供選擇:

  • 根據預設,Xamarin.Android 會使用 JDK 8,如果您正在針對 API 層級 24 或更高層級進行開發,則需要此項 (JDK 8 也支援早於 24 的 API 層級)。

  • 如果您是針對 API 層級 23 或更早的層級進行開發,則可繼續使用 JDK 7

  • 如果您使用 Visual Studio 15.8 Preview 5 或更新版本,則可以嘗試使用Microsoft 的行動版 OpenJDK 散發套件,而不是 JDK 8。

重要

Xamarin.Android 不支援 JDK 9。

SDK 管理員

若要在 Visual Studio 中啟動 SDK 管理員,請按一下[工具 > Android > Android SDK 管理員]:

Location of the Android SDK Manager menu item

Android SDK 管理員會在 [Android SDKs and Tools] \(Android SDK 與工具\) 畫面中開啟。 此畫面有兩個索引標籤 – 平臺工具

Screenshot of the Android SDK Manager open in the Platforms tab

後續各節將更詳細說明 [Android SDK 及工具] 畫面。

Android SDK 位置

Android SDK 位置可在 [Android SDKs and Tools] \(Android SDK 與工具\) 畫面頂端設定,如先前的螢幕擷取畫面所示。 您必須先正確設定此位置,[平台] 和 [工具] 索引標籤才能正常運作。 您可能會因為下列一或多個原因,而需要設定 Android SDK 的位置:

  1. Android SDK 管理員找不到 Android SDK。

  2. 您已將 Android SDK 安裝於替代 (非預設) 位置。

若要設定 Android SDK 的位置,請按一下 Android SDK 位置最右邊的省略號 (...) 按鈕。 這會開啟 [瀏覽資料夾] 對話方塊,以用來瀏覽至 Android SDK 位置。 在下列螢幕擷取畫面中,正在選取 [程式檔] 底下的 Android SDK (x86) \Android

Screenshot of the Windows Browse For Folder dialog locating android sdk

當您按一下 [確定] 時,SDK 管理員將會管理安裝於所選位置的 Android SDK。

[Tools] \(工具\) 索引標籤

[工具] 索引標籤會顯示 [工具] 和 [額外項目] 的清單。 使用此索引標籤來安裝 Android SDK 工具、平台工具及建置工具。 此外,您還能安裝 Android Emulator、低階除錯程式 (LLDB)、NDK、HAXM 加速,以及 Google Play 程式庫。

例如,若要下載 Google Android Emulator 套件,請按一下 [Android Emulator] 旁的核取記號,然後按一下 [套用變更] 按鈕:

Installing the Android Emulator from the Tools tab

可能會顯示具有以下訊息的對話方塊:下列套件需要您先接受其授權條款,然後才能安裝

License acceptance screen

如果您接受條款及條件,請按一下 [接受]。 在視窗底部,進度列會指出下載及安裝的進度。 安裝完成之後,[工具] 索引標籤將會顯示已安裝所選取的工具和額外項目。

[Platforms] \(平台\) 索引標籤

[ 平臺 ] 索引標籤會顯示平臺 SDK 版本清單,以及其他資源 (,例如每個平臺的系統映射) :

Screenshot of the Platforms pane

此畫面列出了 Android 版本 (例如 Android 8.0)、代號 (Oreo)、API 層級 (例如 26),以及該平台的元件大小 (例如 1 GB)。 您可使用 [Platforms] \(平台\) 索引標籤來為您想要設為目標的 Android API 層級安裝元件。 如需 Android 版本與 API 層級的詳細資訊,請參閱 Understanding Android API Levels(了解 Android API 層級)。

當平台的所有元件均安裝完成時,平台名稱旁就會出現一個選取記號。 如果尚未安裝平台的所有元件,則會填滿該平台的方塊。 您可以按一下平台左邊的 + 方塊,來展開平台來查看其元件 (以及已安裝哪些元件)。 按一下 - 來取消展開平台的元件清單。

若要將其他平台新增至 SDK,請按一下平台旁邊的方塊,直到核取符號出現以安裝其所有元件為止,然後按一下 [套用變更]:

Example of adding Android 7.1 Nougat components to the Android SDK

若只要安裝特定元件,請按一下平台旁邊的方塊一次。 您接著可以選取任何所需的個別元件:

Example of adding some Android 7.1 components

請注意,要安裝的元件數目會出現在 [套用變更] 按鈕旁邊。 按一下 [Apply Changes] \(套用變更\) 按鈕後,您會看到先前顯示的 [License Acceptance] \(授權接受\) 畫面。 如果您接受條款及條件,請按一下 [接受]。 如果有多個要安裝的元件,您可能會多次看到這個對話方塊。 在視窗底部,進度列將會指出下載及安裝的進度。 當下載及安裝程序完成時 (視需要下載的元件數目而定,這可能需要花費幾分鐘),系統會以核取記號標示已新增的元件,並將其列為 [已安裝]

存放庫選取

根據預設,Android SDK 管理員會從 Microsoft 管理的存放庫下載平台元件與工具。 若您需要存取 Microsoft 存放庫中尚無法使用的實驗性 alpha/beta 平台與元件,您可以切換 SDK 管理員為使用 Google 的存放庫。 若要進行此參數,請按一下右下角的齒輪圖示,然後選取 [ 存放庫 > Google (不支援的)

Selecting Google's repository

選取 Google 存放庫時,先前無法使用的其他套件可能會出現在 [Platforms] \(平台\) 索引標籤中。 (在上述螢幕擷取畫面中,已藉由切換至 Google 存放庫來新增 Android SDK Platform 28 。) 請記住,不支援使用 Google 存放庫,因此不建議用於日常開發。

若要切換回支援的平台與工具存放庫,請按一下 Microsoft (Recommended) \(Microsoft (建議)\)。 這會將套件與工具的清單還原至預設選取項目。

總結

本指南說明如何在 Visual Studio 和 Visual Studio for Mac 中安裝和使用 Xamarin Android SDK 管理員工具。