Freigeben über

Remote-iOS-Simulator für Windows

Mit dem Remote-iOS Simulator für Windows können Sie Ihre Apps auf einem iOS-Simulator testen, der zusammen mit Visual Studio 2022 in Windows angezeigt wird.

Loslegen

Der Remote-iOS-Simulator für Windows wird automatisch als Teil der .NET plattformübergreifenden App UI-Entwicklungsarbeitslast in Visual Studio 2022 installiert. Führen Sie die folgenden Schritte aus, um sie zu verwenden:

  1. Starten Sie Visual Studio 2022, und erstellen oder laden Sie ein .NET MAUI-App-Projekt.

  2. Koppeln Sie in Visual Studio 2022 die IDE mit einem Mac-Build-Host, wenn Sie dies noch nicht zuvor getan haben. Weitere Informationen finden Sie unter Pair to Mac für die iOS-Entwicklung.

  3. Verwenden Sie in der Visual Studio-Symbolleiste die Dropdown-Liste Debug-Ziel, um iOS-Simulatoren und anschließend einen bestimmten iOS-Simulator auszuwählen:

    Debugziele für Visual Studio-iOS-Simulatoren.

  4. Drücken Sie auf der Visual Studio-Symbolleiste die grüne Startschaltfläche für den ausgewählten iOS-Simulator:

    Auswahl des Debugziels für Visual Studio iOS-Simulatoren.

    Visual Studio erstellt die App, startet den Remote-iOS-Simulator für Windows und stellt die App im Simulator bereit:

    Visual Studio iOS-Remotesimulator, der eine App ausführt.

Aktivieren des Remote-iOS-Simulators für Windows

Der Remote-iOS-Simulator für Windows ist standardmäßig aktiviert. Wenn sie jedoch zuvor deaktiviert wurde, kann sie in Visual Studio aktiviert werden, indem Sie zu den Tools-Optionen >> Xamarin > iOS-Einstellungen navigieren und sicherstellen, dass der Remotesimulator für Windows überprüft wird:

Visual Studio-Kontrollkästchen zum Aktivieren des iOS-Remotesimulators.

Hinweis

Wenn der Remotesimulator in Visual Studio deaktiviert ist, öffnet das Debuggen einer .NET MAUI iOS-App den iOS-Simulator auf dem verbundenen Mac-Buildhost.

Symbolleiste des Simulatorfensters

Die Symbolleiste am oberen Rand des Simulatorfensters zeigt fünf Schaltflächen an:

Visual Studio iOS-Remotesimulator für die Windows-Symbolleiste.

Die Schaltflächen sind wie folgt:

  • Home – simuliert die Startschaltfläche auf einem iOS-Gerät.
  • Sperren – Sperrt den Simulator (zum Entsperren wischen).
  • Screenshot erstellen – Speichert einen Screenshot des Simulators in \Users\{User}\Pictures\Microsoft\iOS Simulator.
  • Einstellungen – zeigt Tastatur und andere Einstellungen an.
  • Weitere Optionen – zeigt verschiedene Simulationsoptionen an, wie beispielsweise Drehung und Schüttelgeste.

Durch Klicken auf die Schaltfläche " Einstellungen " der Symbolleiste (zahnradsymbol) wird das Fenster "Einstellungen " geöffnet:

iOS-Remotesimulatoreinstellungen.

Mit diesen Einstellungen können Sie die Hardwaretastatur aktivieren und den Inhalt und die Einstellungen für den Simulator zurücksetzen.

Wenn Sie auf die Schaltfläche " Andere Optionen " der Symbolleiste klicken (das Symbol mit den Auslassungspunkten), werden zusätzliche Schaltflächen wie Drehung, Schüttelgesten und Neustarten angezeigt:

Zusätzliche Einstellungen für den iOS-Remotesimulator.

Hinweis

Wenn Sie im Remote-iOS-Simulatorfenster mit der rechten Maustaste auf eine beliebige Stelle klicken, werden alle Symbolleistenschaltflächen als Kontextmenü angezeigt.

Touchscreen-Unterstützung

Viele Windows-Computer verfügen über Touchscreens. Da der Remote-iOS-Simulator für Windows Touchinteraktionen unterstützt, können Sie Ihre App mit den gleichen Zusammendrücken, Wischen und Fingereingabegesten testen, die Sie mit physischen iOS-Geräten verwenden.

Ebenso behandelt der Remote-iOS-Simulator für Windows Windows Eingabestifteingaben als Apple Pencil-Eingabe.

Klangverarbeitung

Sounds, die vom Simulator wiedergegeben werden, stammen von den Lautsprechern des Host-Macs. iOS-Sounds werden unter Windows nicht gehört.

Problembehandlung

Unter bestimmten Umständen kann ein Xcode-Konfigurationsproblem dazu führen, dass der Remote-iOS-Simulator für Windows in einer Endlosschleife bei der Verbindung mit dem Mac, dem Überprüfen des Servers und dem Verbinden hängen bleibt. In diesem Fall müssen Sie die Simulatoren auf Ihrem Mac-Buildhost entfernen und zurücksetzen:

  • Stellen Sie sicher, dass Xamarin Mac Agent (XMA) und Xcode nicht ausgeführt werden.
  • Löschen Sie Ihren Ordner ~/Library/Developer/CoreSimulator/Devices .
  • Führen Sie killall -9 com.apple.CoreSimulator.CoreSimulatorService aus.
  • Führen Sie xcrun simctl list devices aus.

In einigen Fällen hat Xcode möglicherweise Simulatorgeräte generiert, die auch dazu führen können, dass der Remote-iOS-Simulator für Windows seine Eigenschaften nicht richtig lesen kann, da versucht wird, zu überprüfen, für welche Geräte bereitgestellt werden können, was zu einer Startschleife führt.

Sie können dies umgehen, indem Sie alte Simulatoren entfernen und neue erstellen, die Sie bereitstellen können.

  • Stellen Sie sicher, dass Xamarin Mac Agent (XMA) und Xcode nicht ausgeführt werden.
  • Führen Sie xcrun simctl list | grep -w "Shutdown" | grep -o "([-A-Z0-9]*)" | sed 's/[\(\)]//g' | xargs -I uuid xcrun simctl delete uuid aus.
  • Führen Sie xcrun simctl list devices aus. Es sollten keine Geräte aufgelistet werden.
  • Öffnen Sie Xcode auf Ihrem verbundenen Mac.
  • Öffnen Sie Windows-Geräte > und Simulatoren.
  • Wählen Sie Simulatoren aus.
  • Erstellen Sie einen neuen Simulator, für den Sie bereitstellen möchten.

Protokolle

Wenn Probleme mit dem Remote-iOS-Simulator auftreten, können Sie die Protokolle an den folgenden Speicherorten anzeigen:

  • Mac – ~/Library/Logs/Xamarin/Simulator.Server
  • Windows – %LOCALAPPDATA%\Xamarin\Logs\Xamarin.Simulator