Verwenden des Surface Duo-Emulators mit Visual Studio

Wichtig

In diesem Artikel werden Funktionen und Anleitungen beschrieben, die sich in der öffentlichen Vorschau befinden und vor der allgemeinen Verfügbarkeit noch wesentlich geändert werden können. Microsoft übernimmt keine Garantie, weder ausdrücklich noch stillschweigend, für die hier bereitgestellten Informationen.

Um Android-Apps mit Xamarin in C# mithilfe von Visual Studio zu erstellen, richten Sie diese Tools ein, und befolgen Sie dann die Anweisungen auf dieser Seite:

• Hol dir die neueste Version von Visual Studio, und vergewissere dich, dass Xamarin installiert ist.
• Stelle sicher, dass das Android SDK gemäß dieser Anweisungen für Visual Studio installiert wird.
• Arbeite den Leitfaden zur Hardwarebeschleunigung durch, um die beste Emulatorleistung zu erzielen.

Installieren der Emulatorvorschau

Rufen Sie das Installationsprogramm aus dem Microsoft Download Center ab:

Surface Duo-Emulator herunterladen

Wählen Sie das .zip Paket für Windows oder das DMG für macOS aus.

Windows

Wenn der Download abgeschlossen ist, führen Sie das Installationsprogramm aus.

Das Installationsprogramm platziert Symbole im Startmenü in einem SurfaceDuoEmulator-Ordner . Verwenden Sie das Symbol mit der Bezeichnung Surface Duo Emulator für Visual Studio , um den Emulator zu öffnen, bevor Sie versuchen, in Visual Studio bereitzustellen.

Mac

Nach Abschluss des Downloads:

1. Öffne die Datei SurfaceDuoEmulator_ version _.dmg.
2. Kopieren Sie den Inhalt des Emulatorordners auf Ihre lokale Festplatte. (Der Name des Emulatorordners darf keine Punkte enthalten.)

Der Emulatorordner enthält eine Reihe von Shellskripts, die den Emulator starten können. Visual Studio für Mac Benutzer sollten die Skripts mit dem _vs Suffix starten (z. B. run_vs.bat und run_vs_clean.bat).

Ausführen des Emulators

Visual Studio startet den Surface Duo-Emulator nicht automatisch, sodass Sie sie manuell öffnen sollten, bevor Sie versuchen, Ihre Xamarin-App bereitzustellen oder zu debuggen.

Führen Sie die folgenden Anweisungen aus, um den Emulator zu starten, nachdem sie als Bereitstellungsoption in Visual Studio angezeigt wird:

Windows

Nach Abschluss des SDK-Setups können Sie den Surface Duo-Emulator für Visual Studio über den Link " Startmenü " starten.

Im Installationsordner gibt es eine Batchdatei run_vs.bat , die Sie direkt ausführen können. Es gibt auch eine run_vs_clean.bat Datei, die den Emulator in einem frischen Zustand startet (anstatt eine vorherige Sitzung fortzusetzen).

Wenn der Emulator nicht gestartet wird, musst du möglicherweise den Zeiger auf deine Android SDK-Installation aktualisieren.

Mac

• Navigiere in einem Terminalfenster zum Ordner, in den du den Emulator kopiert hast.
• Gib ./run_vs.sh ein, um den Emulator zu starten.

Es gibt auch ein run_vs_clean.sh-Skript , das den Emulator in einem frischen Zustand startet, anstatt eine vorherige Sitzung fortzusetzen.

Hinweis

Der Installationsordner enthält Startskripts namens "Run " und run_vs. Die Ausführungsskripts sind für Entwickler mit Android Studio vorgesehen und die run_vs Skripts sind für Visual Studio-Benutzer vorgesehen. Die Unterschiede sind der Android SDK-Speicherort und der Port, der für den Emulator verwendet wird.

Wenn der Emulator ausgeführt wird, aber nicht als Bereitstellungsoption in Visual Studio angezeigt wird, schließen Sie den Emulator und starten Sie erneut, und bestätigen Sie, dass Sie das Skript mit vs . im Namen verwenden.

Debuggen deiner Xamarin Android-App

Öffne dein Projekt in Visual Studio, und kompiliere es. Wähle <build> (Android 10.0 - API 29) (in der Liste der ausgeführten Geräte) aus, und stelle es bereit.

Das Debuggen (Breakpoints, Schritt in, Schritt über usw.) funktioniert wie gewohnt.

Aktualisieren des Android-Emulators in SDK-Tools

Visual Studio verwaltet eine genehmigte Liste von SDK-Tools und ist standardmäßig auf diese Liste beschränkt. Manchmal müssen Sie die Standardeinstellungen außer Kraft setzen, um die neueste Version einer Komponente abzurufen, z. B. die Android 12L-Emulatorversion, die eine bestimmte Version einiger SDK-Tools erfordert.

Führen Sie die folgenden Schritte aus, um die neueste Version des Android-Emulators in Visual Studio zu aktualisieren:

1. Wechseln Sie zur Registerkarte "Android > SDK-Managertools>".

   

2. Beachten Sie, dass der Android-Emulatorstatus"Update" verfügbar ist.

3. Klicken Sie auf die Schaltfläche "Verfügbar aktualisieren ", und ein neues Fenster zeigt die Version an, die heruntergeladen wird. In diesem Beispiel wird 31.2.10 installiert, ABER wir möchten Version 31.3.12 installieren.

   

4. Abbrechen Sie das Update und klicken Sie im Fenster "Android-SDKs und -Tools " auf das kleine Zahnradsymbol in der unteren rechten Ecke. Dadurch wird ein Repository-Untermenü mit zwei Optionen angezeigt:

   • Genehmigte Liste (Empfohlen)
   • Vollständige Liste (nicht unterstützt)

   Wählen Sie die Option "Vollständige Liste" (Nicht unterstützt) aus .

   

5. Klicken Sie erneut auf die Schaltfläche "Verfügbar aktualisieren ", und dieses Mal wird die Version 31.3.12 angeboten.

   

6. Klicken Sie auf "Aktualisierungen installieren", und die neuesten Versionen der ausgewählten SDK-Tools werden installiert.

Problembehandlung

Surface Duo-Emulator wird nicht in der Visual Studio-Geräteliste angezeigt.

Die aktuelle Version des Surface Duo-Emulators kann nicht von Visual Studio gestartet werden. Starte den Emulator zunächst manuell, und sobald er ausgeführt wird, sollte er in der Liste für Bereitstellung und Debuggen angezeigt werden:

• Windows – Öffnen Sie > Surface Duo Emulator, und wählen Sie Surface Duo Emulator für Visual Studio aus.
• Mac - starten Sie mit der Befehlszeile sh ./run_vs.sh (der Name des Skripts gibt an, dass sie für Visual Studio für Mac vorgesehen ist).

Aktualisieren des Zeigers auf dein Android SDK

Wenn du den Installationsspeicherort des Android SDK gegenüber der Standardeinstellung geändert hast, musst du das Skript run_vs so ändern, dass es auf den gewünschten Installationsspeicherort zeigt. Andernfalls wird der Emulator nicht ausgeführt, wenn du auf die Verknüpfung klickst oder das Skript ausführst.

Windows

1. Wechsle zum Installationsspeicherort des Surface Duo-Emulators. Der Standardspeicherort ist %USERPROFILE%\SurfaceDuoEmulator.
2. Öffne im Installationsordner den Ordner artifacts.
3. Erstelle eine Sicherungskopie von run_vs.bat, die du beispielsweise in run_vs_original.bat kopieren kannst.
4. Öffne in einem Text-Editor die Datei run_vs.bat.
5. Vergewissere dich, dass der Pfadwert ANDROID_SDK_LOCATION im oberen Bereich der Datei stimmt.

rem ##### ENSURE THE SDK LOCATION BELOW IS CORRECT: #######
set ANDROID_SDK_LOCATION=C:\Program Files (x86)\Android\android-sdk

Mac

1. Navigiere zum Speicherort, in den du das heruntergeladene Surface Duo-Emulatorarchiv extrahiert hast.
2. Erstelle eine Sicherungskopie von run_vs.sh, die du beispielsweise in run_vs_original_.sh kopieren kannst.
3. Öffne in einem Text-Editor die Datei run_vs.sh.
4. Vergewissere dich, dass der Pfadwert ANDROID_SDK_LOCATION im oberen Bereich der Datei stimmt.

##### ENSURE THE SDK LOCATION BELOW IS CORRECT: #######
ANDROID_SDK_LOCATION=~/Library/Developer/android-sdk-macosx