Share via

Drahtlose Bereitstellung für .NET MAUI iOS-Apps

  • Artikel

Anstatt ein iOS-Gerät über ein USB-Kabel mit dem Mac zu verbinden, um eine .NET Multi-platform App UI-App (.NET MAUI) bereitzustellen und zu debuggen, können Visual Studio und Visual Studio für Mac .NET MAUI iOS-Apps drahtlos auf Geräten bereitstellen und debuggen. Dazu müssen Sie Ihr iOS-Gerät mit Xcode auf Ihrem Mac koppeln. Nach der Kopplung kann das Gerät aus der Gerätezielliste in Visual Studio und Visual Studio für Mac ausgewählt werden.

Wichtig

.NET MAUI iOS-Apps müssen bereitgestellt worden sein, bevor sie für Tests und Debugging auf einem Gerät bereitgestellt werden können. Weitere Informationen finden Sie unter Gerätebereitstellung für iOS.

Auf einem iOS-Gerät:

Führen Sie die folgenden Schritte aus, um ein iOS-Gerät mit Xcode auf Ihrem Mac zu koppeln:

  1. Stellen Sie sicher, dass Ihr iOS-Gerät mit demselben drahtlosen Netzwerk wie Ihr Mac verbunden ist.

  2. Schließen Sie Ihr iOS-Gerät über ein USB-Kabel an Ihren Mac an.

    Hinweis

    Wenn Sie ein iOS-Gerät zum ersten Mal mit Ihrem Mac verbinden, müssen Sie auf die Schaltfläche Vertrauen im Dialogfeld Diesem Gerät vertrauen auf Ihrem Computer tippen.

  3. Öffnen Sie Xcode, und klicken Sie auf Fenster Geräte und Simulatoren>. Klicken Sie im angezeigten Fenster auf Geräte.

  4. Wählen Sie im Fenster Geräte und Simulatoren in der linken Spalte Ihr Gerät aus. Aktivieren Sie dann im Detailbereich das Kontrollkästchen Verbindung über Netzwerk:

    Screenshot of Devices and Simulators window showing Connect via network option.

    Xcode verbindet sich mit dem iOS-Gerät.

  5. Im Fenster Geräte und Simulatoren wird in der linken Spalte ein Netzwerksymbol neben einem verbundenen Gerät angezeigt, das gekoppelt ist:

    Screenshot of Devices and Simulators window showing a paired iOS device.

  6. Trennen Sie das USB-Kabel und prüfen Sie, ob das Gerät weiterhin gekoppelt ist.

Xcode behält die Kopplungseinstellungen bei, sodass das Gerät nicht erneut gekoppelt werden muss.

Entkoppeln eines iOS-Geräts

Führen Sie die folgenden Schritte aus, um ein iOS-Gerät von Xcode auf Ihrem Mac zu entkoppeln:

  1. Stellen Sie sicher, dass Ihr iOS-Gerät mit demselben drahtlosen Netzwerk wie Ihr Mac verbunden ist.

  2. Öffnen Sie Xcode, und klicken Sie auf Fenster Geräte und Simulatoren>. Klicken Sie im angezeigten Fenster auf Geräte.

  3. Wählen Sie im Fenster Geräte und Simulatoren in der linken Spalte Ihr Gerät aus. Klicken Sie dann mit der rechten Maustaste auf das Gerät und wählen Sie die Option Gerät entkoppeln.

    Screenshot of Devices and Simulators window showing a paired iOS device about to be unpaired.

Auf Gerät bereitstellen

Nachdem Sie Ihr Gerät drahtlos mit Xcode gekoppelt haben, können bereitgestellte .NET MAUI iOS-Apps drahtlos auf dem Gerät bereitgestellt werden.

  1. Stellen Sie sicher, dass Ihr iOS-Gerät drahtlos mit Ihrem Mac-Buildhost gekoppelt ist. Weitere Informationen finden Sie unter Koppeln eines iOS-Geräts.

  2. Stellen Sie in Visual Studio sicher, dass die IDE mit einem Mac-Buildhost gekoppelt ist. Weitere Informationen finden Sie unter Koppeln mit Mac für iOS-Entwicklung.

  3. Verwenden Sie in der Visual Studio-Symbolleiste das Dropdown-Menü Debugziel, um iOS-Remotegeräte und dann das Gerät auszuwählen, das mit Ihrem Mac-Buildhost verbunden ist:

    Select your remote device in Visual Studio.

  4. Drücken Sie in der Visual Studio-Symbolleiste die grüne Startschaltfläche, um die App auf Ihrem Remotegerät zu starten:

    Visual Studio iOS device debug target choice.

Hinweis

Ein alternativer Ansatz für die Bereitstellung einer .NET MAUI iOS-App auf einem Gerät ist die Verwendung von Hot Restart. Mit Hot Restart können Sie eine .NET MAUI-Anwendung von Visual Studio aus auf einem lokalen 64-Bit-iOS-Gerät bereitstellen, ohne dass ein Mac-Buildhost erforderlich ist. Weitere Informationen finden Sie unter Bereitstellen einer iOS-App mit dem Hot Restart.

Problembehandlung

  • Stellen Sie immer sicher, dass Ihr iOS-Gerät mit demselben Netzwerk verbunden ist wie Ihr Mac.
  • Stellen Sie sicher, dass Ihr Gerät bereitgestellt ist. Weitere Informationen zur Bereitstellung finden Sie unter Gerätebereitstellung für iOS.
  • Überprüfen Sie, ob Xcode das Gerät sehen kann:
    • Wählen Sie in Xcode Fenster > Geräte und Simulatoren und klicken Sie im eingeblendeten Fenster auf Geräte. Das Gerät sollte unter Verbunden angezeigt werden.
  • Pingen Sie das Gerät:

    • Geben Sie die IP-Adresse des Geräts ein. Öffnen Sie auf dem Gerät Einstellungen, tippen Sie aufWi-Fi und dann auf die Informationsschaltfläche neben dem aktiven Netzwerk.

    • Auf einem Mac öffnen Sie Terminal und geben ping gefolgt von der IP-Adresse des Geräts ein. Vorausgesetzt, Ihr Mac kann das Gerät sehen, erhalten Sie eine ähnliche Ausgabe wie diese:

      PING 192.168.1.107 (192.168.1.107): 56 data bytes
64 bytes from 192.168.1.107: icmp_seq=0 ttl=64 time=121.015 ms
64 bytes from 192.168.1.107: icmp_seq=1 ttl=64 time=28.387 ms
64 bytes from 192.168.1.107: icmp_seq=2 ttl=64 time=49.890 ms
64 bytes from 192.168.1.107: icmp_seq=3 ttl=64 time=72.283 ms

      Bei einem Fehler ist die Ausgabe Request timeout for icmp_seq 0. Wenn Sie das Gerät nicht pingen können, ist das Internet Control Message Protocol (ICMP) blockiert oder es liegt ein anderes Verbindungsproblem vor.

  • Stellen Sie sicher, dass Port 62078 geöffnet ist.
  • Verbinden Sie das Gerät über ein Ethernet-Kabel mit dem Netzwerk:
    • Verwenden Sie den Lightning-auf-USB-Kameraadapter und einen USB-auf-Ethernet-Adapter.
  • iOS-Gerät erneut koppeln: