Wie kann ich die Android-Unterstützungsbibliotheken, die für die Xamarin.Android.Support-Pakete erforderlich sind, manuell installieren?

Beispielschritte für Xamarin.Android.Support.v4

Visual Studio

Laden Sie das gewünschte Xamarin.Android.Support-NuGet-Paket herunter (z. B. durch eine Installation über den NuGet-Paket-Manager).

Überprüfen Sie mit ildasm, welche Version von android_m2repository.zip das NuGet-Paket erfordert:

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

Beispielausgabe:

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')

Laden Sie android_m2repository.zip von Google mit der URL herunter, die von ildasm zurückgegeben wurde. Alternativ können Sie überprüfen, welche Version des Android Support Repository Sie zurzeit im Android-SDK-Manager installiert haben:

Wenn die Version mit der übereinstimmt, die Sie für das NuGet-Paket benötigen, müssen Sie keine neue Software herunterladen. Sie können stattdessen das vorhandene m2repository-Verzeichnis neu zippen, das sich unter extras\android im SDK-Pfad befindet (wie oben im Android SDK-Manager-Fenster dargestellt).

Berechnen Sie den MD5-Hash der URL, die von ildasm zurückgegeben wurde. Formatieren Sie die resultierende Zeichenfolge so, dass nur Großbuchstaben und keine Leerzeichen verwendet werden. Passen Sie z. B. die Variable $url nach Bedarf an, und führen Sie dann die folgenden zwei Zeilen (die auf dem ursprünglichen C#-Code aus Xamarin.Android basieren) in PowerShell aus:

$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 ""

Beispielausgabe:

F16A3455987DBAE5783F058F19F7FCDF

Kopieren Sie android_m2repository.zip in den Ordner "%LOCALAPPDATA%\Xamarin\zips\". Benennen Sie die Datei um, um den MD5-Hash aus dem vorherigen Hashberechnungsschritt zu verwenden. Zum Beispiel:

%LOCALAPPDATA%\Xamarin\zips\F16A3455987DBAE5783F058F19F7FCDF.zip

(Optional) Entpacken Sie die Datei in %LOCALAPPDATA%\Xamarin\Xamarin.Android.Support.v4\23.4.0.0\content\ (Erstellen eines Unterverzeichnisses "content\m2repository "). Wenn Sie diesen Schritt überspringen möchten, nimmt der erste Build, der diese Bibliothek verwendet, etwas mehr Zeit in Anspruch, da er diesen Schritt durchführen muss. Die Versionsnummer dieses Unterverzeichnisses (23.4.0.0 in diesem Beispiel) ist nicht ganz dieselbe wie die Versionsnummer des NuGet-Pakets. Die richtige Versionsnummer können Sie mithilfe von ildasm ermitteln:

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'"

Beispielausgabe:

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 für Mac

Laden Sie das gewünschte Xamarin.Android.Support-NuGet-Paket herunter (z. B. durch eine Installation über den NuGet-Paket-Manager).

Doppelklicken Sie auf die Assembly Xamarin.Android.Support.v4 im Abschnitt Verweise des Android-Projekts in Visual Studio für Mac, um die Assembly im Assembly-Browser zu öffnen. Stellen Sie sicher, dass die Dropdownliste Sprache auf C# festgelegt ist, und wählen Sie die oberste Xamarin.Android.Support.v4-Assembly aus der Navigationsstruktur des Assembly-Browsers aus. Suchen Sie die Eigenschaft SourceUrl unter dem Attribut IncludeAndroidResourcesFrom oder 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")]

Laden Sie android_m2repository.zip von Google mithilfe der SourceUrl von ildasm zurückgegebenen Herunter. Alternativ können Sie überprüfen, welche Version des Android Support Repository Sie zurzeit im Android-SDK-Manager installiert haben:

Wenn die Version mit der übereinstimmt, die Sie für das NuGet-Paket benötigen, müssen Sie keine neue Software herunterladen. Sie können stattdessen das vorhandene Verzeichnis m2repository, das sich SDK-Pfad unter extras/android befindet, noch einmal zippen. Der Pfad wird oben im Fenster „Android-SDK-Manager“ angezeigt.

Berechnen Sie den MD5-Hash der URL, die von ildasm zurückgegeben wurde. Formatieren Sie die resultierende Zeichenfolge so, dass nur Großbuchstaben und keine Leerzeichen verwendet werden. Passen Sie beispielsweise die URL-Zeichenfolge nach Bedarf an, und führen Sie den folgenden Befehl in eine Terminal.app-Eingabeaufforderung aus:

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

Eine weitere Option ist, mit dem Interpreter csharpdenselben C#-Code auszuführen, den Xamarin.Android selbst verwendet. Dazu müssen Sie die Variable url nach Bedarf anpassen und den folgenden Befehl in einer Terminal.app-Eingabeaufforderung ausführen:

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")))'

Beispielausgabe:

F16A3455987DBAE5783F058F19F7FCDF

Kopieren Sie android_m2repository.zip in den Ordner $HOME/.local/share/Xamarin/zips/. Benennen Sie die Datei um, um den MD5-Hash aus dem vorherigen Hashberechnungsschritt zu verwenden. Zum Beispiel:

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

(Optional) Entzippen Sie die Datei in:

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

(so erstellen Sie ein Unterverzeichnis des Typs content/m2repository). Wenn Sie diesen Schritt überspringen möchten, nimmt der erste Build, der diese Bibliothek verwendet, etwas mehr Zeit in Anspruch, da er diesen Schritt durchführen muss.

Die Versionsnummer dieses Unterverzeichnisses (23.4.0.0 in diesem Beispiel) ist nicht ganz dieselbe wie die Versionsnummer des NuGet-Pakets. So wie im ildasm-Schritt zuvor, können Sie mit dem Assembly-Browser in Visual Studio für Mac nach der richtigen Versionsnummer suchen. Suchen Sie die Eigenschaft Version unter dem Attribut IncludeAndroidResourcesFrom oder 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")]

Nächste Schritte

In diesem Artikel wird das im August 2016 aktuelle Verhalten besprochen. Die in diesem Artikel beschriebene Technik ist kein Teil einer stabilen Testsammlung für Xamarin. Sie könnte daher in Zukunft nicht mehr unterstützt werden.

Wenn Sie weitere Unterstützung benötigen, kontaktieren Sie uns. Wenn das Problem auch nach Zuhilfenahme der obigen Informationen weiter besteht, lesen Sie die Informationen unter Hilfe zu Visual Studio erhalten. Dort finden Sie alle Kontaktoptionen, Vorschläge und, falls notwendig, Anleitungen zum Erstellen eines neuen Bugs.