設定Xamarin.Android 的Android SDK - Microsoft Docs

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

跳到主要內容 已不再支援此瀏覽器。

請升級至MicrosoftEdge，以利用最新功能、安全性更新和技術支援。

下載MicrosoftEdge 其他資訊 目錄 結束焦點模式 閱讀英文 儲存 目錄 閱讀英文 儲存 Twitter LinkedIn Facebook 電子郵件 目錄 設定Xamarin.Android的AndroidSDK 發行項 05/10/2022 10位參與者 本文內容 VisualStudio包含AndroidSDK管理員，可用來下載AndroidSDK工具、平台，以及開發Xamarin.Android應用程式所需的其他元件。

概觀 本指南說明如何在VisualStudio和VisualStudioforMac中使用XamarinAndroidSDK管理員。

注意 本指南適用於VisualStudio2019、VisualStudio2017和VisualStudioforMac。

XamarinAndroidSDK管理員(與使用.NET的行動開發工作負載一併安裝)可協助您下載開發Xamarin.Android應用程式所需的最新Android元件。

它會取代Google已過時的獨立SDK管理員。

VisualStudio VisualStudioforMac 規格需求 若要使用XamarinAndroidSDK管理員，您需要下列項目： VisualStudio2019Community、Professional或Enterprise。

或是VisualStudio2017(Community、Professional或Enterprise版本)。

需要VisualStudio201715.7版或更新版本。

VisualStudioToolsforXamarin4.10.0版或更新版本(隨著用.NET進行行動裝置開發工作負載安裝)。

XamarinAndroidSDK管理員也需要Java開發套件(會隨Xamarin.Android自動安裝)。

有多個JDK替代項目可供選擇： 根據預設，Xamarin.Android會使用JDK8，如果您正在針對API層級24或更高層級進行開發，則需要此項(JDK8也支援早於24的API層級)。

如果您是針對API層級23或更早的層級進行開發，則可繼續使用JDK7。

如果您使用VisualStudio15.8Preview5或更新版本，則可以嘗試使用Microsoft的行動版OpenJDK散發套件，而不是JDK8。

重要 Xamarin.Android不支援JDK9。

SDK管理員 若要在VisualStudio中啟動SDK管理員，請按一下[工具>Android>AndroidSDK管理員]： AndroidSDK管理員會在[AndroidSDKsandTools]\(AndroidSDK與工具\)畫面中開啟。

此畫面有兩個索引標籤–平臺和工具： 後續各節將更詳細說明[AndroidSDK及工具]畫面。

AndroidSDK位置 AndroidSDK位置可在[AndroidSDKsandTools]\(AndroidSDK與工具\)畫面頂端設定，如先前的螢幕擷取畫面所示。

您必須先正確設定此位置，[平台]和[工具]索引標籤才能正常運作。

您可能會因為下列一或多個原因，而需要設定AndroidSDK的位置： AndroidSDK管理員找不到AndroidSDK。

您已將AndroidSDK安裝於替代(非預設)位置。

若要設定AndroidSDK的位置，請按一下AndroidSDK位置最右邊的省略號(...)按鈕。

這會開啟[瀏覽資料夾]對話方塊，以用來瀏覽至AndroidSDK位置。

在下列螢幕擷取畫面中，正在選取[程式檔]底下的AndroidSDK(x86)\Android： 當您按一下[確定]時，SDK管理員將會管理安裝於所選位置的AndroidSDK。

[Tools]\(工具\)索引標籤 [工具]索引標籤會顯示[工具]和[額外項目]的清單。

使用此索引標籤來安裝AndroidSDK工具、平台工具及建置工具。

此外，您還能安裝AndroidEmulator、低階除錯程式(LLDB)、NDK、HAXM加速，以及GooglePlay程式庫。

例如，若要下載GoogleAndroidEmulator套件，請按一下[AndroidEmulator]旁的核取記號，然後按一下[套用變更]按鈕： 可能會顯示具有以下訊息的對話方塊：下列套件需要您先接受其授權條款，然後才能安裝： 如果您接受條款及條件，請按一下[接受]。

在視窗底部，進度列會指出下載及安裝的進度。

安裝完成之後，[工具]索引標籤將會顯示已安裝所選取的工具和額外項目。

[Platforms]\(平台\)索引標籤 [平臺]索引標籤會顯示平臺SDK版本清單，以及其他資源(，例如每個平臺的系統映射)： 此畫面列出了Android版本(例如Android8.0)、代號(Oreo)、API層級(例如26)，以及該平台的元件大小(例如1GB)。

您可使用[Platforms]\(平台\)索引標籤來為您想要設為目標的AndroidAPI層級安裝元件。

如需Android版本與API層級的詳細資訊，請參閱UnderstandingAndroidAPILevels(了解AndroidAPI層級)。

當平台的所有元件均安裝完成時，平台名稱旁就會出現一個選取記號。

如果尚未安裝平台的所有元件，則會填滿該平台的方塊。

您可以按一下平台左邊的+方塊，來展開平台來查看其元件(以及已安裝哪些元件)。

按一下-來取消展開平台的元件清單。

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

您接著可以選取任何所需的個別元件： 請注意，要安裝的元件數目會出現在[套用變更]按鈕旁邊。

按一下[ApplyChanges]\(套用變更\)按鈕後，您會看到先前顯示的[LicenseAcceptance]\(授權接受\)畫面。

如果您接受條款及條件，請按一下[接受]。

如果有多個要安裝的元件，您可能會多次看到這個對話方塊。

在視窗底部，進度列將會指出下載及安裝的進度。

當下載及安裝程序完成時(視需要下載的元件數目而定，這可能需要花費幾分鐘)，系統會以核取記號標示已新增的元件，並將其列為[已安裝]。

存放庫選取 根據預設，AndroidSDK管理員會從Microsoft管理的存放庫下載平台元件與工具。

若您需要存取Microsoft存放庫中尚無法使用的實驗性alpha/beta平台與元件，您可以切換SDK管理員為使用Google的存放庫。

若要進行此參數，請按一下右下角的齒輪圖示，然後選取[存放庫>Google(不支援的)： 選取Google存放庫時，先前無法使用的其他套件可能會出現在[Platforms]\(平台\)索引標籤中。

(在上述螢幕擷取畫面中，已藉由切換至Google存放庫來新增AndroidSDKPlatform28。

)請記住，不支援使用Google存放庫，因此不建議用於日常開發。

若要切換回支援的平台與工具存放庫，請按一下Microsoft(Recommended)\(Microsoft(建議)\)。

這會將套件與工具的清單還原至預設選取項目。

規格需求 若要使用XamarinAndroidSDK管理員，您需要下列項目： VisualStudioforMac7.5(或更新版本)。

XamarinAndroidSDK管理員也需要Java開發套件(會隨Xamarin.Android自動安裝)。

有多個JDK替代項目可供選擇： 根據預設，Xamarin.Android會使用JDK8，如果您正在針對API層級24或更高層級進行開發，則需要此項(JDK8也支援早於24的API層級)。

如果您是針對API層級23或更早的層級進行開發，則可繼續使用JDK7。

如果您使用VisualStudioforMac7.7或更新版本，您可以嘗試使用Microsoft的行動版OpenJDK散發套件，而不是JDK8。

重要 Xamarin.Android不支援JDK9。

SDK管理員 若要在VisualStudioforMac中啟動SDK管理員，請按一下[工具>SDK管理員]： AndroidSDK管理員會在[喜好設定]視窗中開啟，該視窗會包含三個索引標籤：[平台]、[工具]和[位置]： 後續各節將說明AndroidSDK管理員的索引標籤。

[Locations]\(位置\)索引標籤 [位置]索引標籤有三種設定，可用來設定AndroidSDK、AndroidNDK及JavaSDK(JDK)的位置。

您必須先正確設定這些位置，[平台]和[工具]索引標籤才能正常運作。

當SDK管理員啟動時，它會自動判斷每個安裝套件的路徑，並藉由在路徑旁邊放置綠色核取記號圖示來指出已找到它： 按一下[重設為預設]按鈕，讓SDK管理員在SDK、NDK及JDK的預設位置上搜尋它們。

通常，您會使用[位置]索引標籤來修改AndroidSDK和/或JavaJDK的位置。

您不需要安裝NDK來開發Xamarin.Android應用程式–只有在您需要使用C和C++等原生程式碼語言開發應用程式的部分時，才會使用NDK。

[Tools]\(工具\)索引標籤 [工具]索引標籤會顯示[工具]和[額外項目]的清單。

使用此索引標籤來安裝AndroidSDK工具、平台工具及建置工具。

此外，您還能安裝AndroidEmulator、低階除錯程式(LLDB)、NDK、HAXM加速，以及GooglePlay程式庫。

例如，若要下載GoogleAndroidEmulator套件，請按一下[AndroidEmulator]旁的核取記號，然後按一下[套用變更]按鈕： 可能會顯示具有以下訊息的對話方塊：下列套件需要您先接受其授權條款，然後才能安裝： 如果您接受條款及條件，請按一下[接受]。

在視窗底部，進度列會指出下載及安裝的進度。

安裝完成之後，[工具]索引標籤將會顯示已安裝所選取的工具和額外項目。

[Platforms]\(平台\)索引標籤 [平臺]索引標籤會顯示平臺SDK版本清單，以及其他資源(，例如每個平臺的系統映射)： 此畫面列出了Android版本(例如Android8.1)、代號(Oreo)、API層級(例如27)，以及該平台的元件大小(例如1GB)。

您可使用[Platforms]\(平台\)索引標籤來為您想要設為目標的AndroidAPI層級安裝元件。

如需Android版本與API層級的詳細資訊，請參閱UnderstandingAndroidAPILevels(了解AndroidAPI層級)。

當平台的所有元件均安裝完成時，平台名稱旁就會出現一個選取記號。

如果尚未安裝平台的所有元件，則會填滿該平台的方塊。

您可以按一下平台左邊的箭頭，來展開平台來查看其元件(以及已安裝哪些元件)。

按一下向下箭頭來取消展開平台的元件清單。

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

您接著可以選取任何所需的個別元件： 請注意，要安裝的元件數目會出現在[套用變更]按鈕旁邊。

按一下[ApplyChanges]\(套用變更\)按鈕後，您會看到先前顯示的[LicenseAcceptance]\(授權接受\)畫面。

如果您接受條款及條件，請按一下[接受]。

如果有多個要安裝的元件，您可能會多次看到這個對話方塊。

在視窗底部，進度列將會指出下載及安裝的進度。

當下載及安裝程序完成時(視需要下載的元件數目而定，這可能需要花費幾分鐘)，系統會以核取記號標示已新增的元件，並將其列為[已安裝]。

存放庫選取 根據預設，AndroidSDK管理員會從Microsoft管理的存放庫下載平台元件與工具。

若您需要存取Microsoft存放庫中尚無法使用的實驗性alpha/beta平台與元件，您可以切換SDK管理員為使用Google的存放庫。

若要進行此參數，請按一下右下角的齒輪圖示，然後選取[存放庫>Google(不支援的)： 選取Google存放庫時，先前無法使用的其他套件可能會出現在[Platforms]\(平台\)索引標籤中。

(在上述螢幕擷取畫面中，已藉由切換至Google存放庫來新增AndroidSDKPlatform28。

)請記住，不支援使用Google存放庫，因此不建議用於日常開發。

若要切換回支援的平台與工具存放庫，請按一下Microsoft(Recommended)\(Microsoft(建議)\)。

這會將套件與工具的清單還原至預設選取項目。

總結 本指南說明如何在VisualStudio和VisualStudioforMac中安裝和使用XamarinAndroidSDK管理員工具。

相關連結 了解AndroidAPI層級 對於AndroidSDK工具所做的變更 本文內容