如何手動安裝 Xamarin.Android.Support 套件所需的 Android 支援程式庫？

Xamarin.Android.Support.v4 的範例步驟

Visual Studio

下載所需的 Xamarin.Android.Support NuGet 套件（例如，使用 NuGet 套件管理員安裝它）。

使用 ildasm 來檢查 NuGet 套件所需的android_m2repository.zip版本：

ildasm /caverbal /text /item:Xamarin.Android.Support.v4 packages\Xamarin.Android.Support.v4.23.4.0.1\lib\MonoAndroid403\Xamarin.Android.Support.v4.dll | findstr SourceUrl

範例輸出︰

property string 'SourceUrl' = string('https://dl-ssl.google.com/android/repository/android_m2repository_r32.zip')
property string 'SourceUrl' = string('https://dl-ssl.google.com/android/repository/android_m2repository_r32.zip')
property string 'SourceUrl' = string('https://dl-ssl.google.com/android/repository/android_m2repository_r32.zip')

使用 ildasm 傳回的 URL，從 Google 下載android_m2repository.zip。 或者，您可以檢查 Android SDK 管理員中目前已安裝的 Android 支援存放庫版本：

如果版本符合 NuGet 套件所需的版本，則不需要下載任何新功能。 您可以改為重新壓縮 SDK 路徑中位於 extras\android 底下的現有 m2repository 目錄（如 Android SDK 管理員視窗頂端所示）。

計算從 ildasm 傳回之 URL 的 MD5 哈希。 將產生的字串格式化為使用所有大寫字母，而且沒有空格。 例如，視需要調整 $url 變數，然後在PowerShell中執行下列 2 行（根據 來自 Xamarin.Android 的原始 C# 程式代碼：

$url = "https://dl-ssl.google.com/android/repository/android_m2repository_r32.zip"
(([System.Security.Cryptography.MD5]::Create()).ComputeHash([System.Text.Encoding]::UTF8.GetBytes($url)) | %{ $_.ToString("X02") }) -join ""

範例輸出︰

F16A3455987DBAE5783F058F19F7FCDF

將android_m2repository.zip複製到 %LOCALAPPDATA%\Xamarin\zips\ 資料夾。 將檔案重新命名為使用先前 MD5 哈希計算步驟中的 MD5 哈希。 例如：

%LOCALAPPDATA%\Xamarin\zips\F16A3455987DBAE5783F058F19F7FCDF.zip

（選擇性）將檔案解壓縮到 %LOCALAPPDATA%\Xamarin\Xamarin.Android.Support.v4\23.4.0.0\content\ （建立 content\m2repository 子目錄）。 如果您略過此步驟，則使用連結庫的第一個組建需要較長的時間，因為它需要完成此步驟。 此範例中子目錄的版本號碼 （在此範例中為 23.4.0.0 ）與 NuGet 套件版本不同。 您可以使用 ildasm 來尋找正確的版本號碼：

ildasm /caverbal /text /item:Xamarin.Android.Support.v4 packages\Xamarin.Android.Support.v4.23.4.0.1\lib\MonoAndroid403\Xamarin.Android.Support.v4.dll | findstr /C:"string 'Version'"

範例輸出︰

property string 'Version' = string('23.4.0.0')}
property string 'Version' = string('23.4.0.0')}
property string 'Version' = string('23.4.0.0')}

Visual Studio for Mac

下載所需的 Xamarin.Android.Support NuGet 套件（例如，使用 NuGet 套件管理員安裝它）。

按兩下 Visual Studio for Mac 中 Android 專案的 [參考] 區段下的 Xamarin.Android.Support.v4 元件，以在元件瀏覽器中開啟元件。 確定 [ 語言 ] 下拉式清單已設定為 C# ，然後從 [元件瀏覽器] 導覽樹狀目錄中選取最上層 的 Xamarin.Android.Support.v4 元件。 SourceUrl在下列其中一個 IncludeAndroidResourcesFrom 或 JavaLibraryReference 屬性下找出 屬性：

[assembly: IncludeAndroidResourcesFrom ("./", PackageName = "Xamarin.Android.Support.v4", SourceUrl = "https://dl-ssl.google.com/android/repository/android_m2repository_r32.zip", EmbeddedArchive = "m2repository/com/android/support/support-v4/23.4.0/support-v4-23.4.0.aar", Version = "23.4.0.0")]

使用 ildasm 傳回的 ，從 Google 下載android_m2repository.zip。SourceUrl 或者，您可以檢查 Android SDK 管理員中目前已安裝的 Android 支援存放庫版本：

如果版本符合 NuGet 套件所需的版本，則不需要下載任何新功能。 您可以改為重新壓縮 SDK 路徑中位於 extras/android 底下的現有 m2repository 目錄（如 Android SDK 管理員視窗頂端所示）。

計算從 ildasm 傳回之 URL 的 MD5 哈希。 將產生的字串格式化為使用所有大寫字母，而且沒有空格。 例如，視需要調整 URL 字串，然後在 Terminal.app 命令提示字元中執行下列命令：

echo -n "https://dl-ssl.google.com/android/repository/android_m2repository_r32.zip" | md5 | tr '[:lower:]' '[:upper:]'

另一個選項是使用 csharp 解釋器來執行 Xamarin.Android 本身所使用的相同 C# 程式代碼。 若要這樣做，請視需要調整url變數，然後在 Terminal.app 命令提示字元中執行下列命令：

csharp -e 'var url = "https://dl-ssl.google.com/android/repository/android_m2repository_r32.zip"; string.Concat((System.Security.Cryptography.MD5.Create().ComputeHash(System.Text.Encoding.UTF8.GetBytes(url))).Select(b => b.ToString("X02")))'

範例輸出︰

F16A3455987DBAE5783F058F19F7FCDF

將android_m2repository.zip複製到 $HOME/.local/share/Xamarin/zips/ 資料夾。 將檔案重新命名為使用先前 MD5 哈希計算步驟中的 MD5 哈希。 例如：

$HOME/.local/share/Xamarin/zips/F16A3455987DBAE5783F058F19F7FCDF.zip

（選擇性）將檔案解壓縮到：

$HOME/.local/share/Xamarin/Xamarin.Android.Support.v4/23.4.0.0/content/

（建立 content/m2repository 子目錄）。 如果您略過此步驟，則使用連結庫的第一個組建需要較長的時間，因為它需要完成此步驟。

此範例中子目錄的版本號碼 （在此範例中為 23.4.0.0 ）與 NuGet 套件版本不同。 如同先前的 ildasm 步驟，您可以使用 Visual Studio for Mac 中的元件瀏覽器來尋找正確的版本號碼。 Version尋找其中IncludeAndroidResourcesFrom一個 或 JavaLibraryReference 屬性底下的屬性：

[assembly: IncludeAndroidResourcesFrom ("./", PackageName = "Xamarin.Android.Support.v4", SourceUrl = "https://dl-ssl.google.com/android/repository/android_m2repository_r32.zip", EmbeddedArchive = "m2repository/com/android/support/support-v4/23.4.0/support-v4-23.4.0.aar", Version = "23.4.0.0")]

後續步驟

本文件討論截至 2016 年 8 月的目前行為。 本檔所述的技術不是 Xamarin 穩定測試套件的一部分，因此未來可能會中斷。

如需進一步協助、與我們連絡，或即使使用上述資訊，請參閱 Xamarin 有哪些支援選項可供 Xamarin 使用？ ，以取得連絡選項、建議的相關信息，以及如何視需要提出新的 Bug。