Drahtlose Bereitstellung für .NET MAUI iOS-Apps

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

Wichtig

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

Ein iOS-Gerät koppeln:

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 verbunden ist wie Ihr Mac.

2. Schließen Sie Ihr iOS-Gerät mit einem USB-Kabel an Ihren Mac an.

   Hinweis

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

3. Öffnen Sie Xcode und klicken Sie auf Fenster > Geräte und Simulatoren Klicken Sie in dem daraufhin 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 Verbinden über Netzwerk:

   

   Xcode wird mit dem iOS-Gerät gekoppelt.

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

   

6. Trennen Sie das USB-Kabel ab und überprü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 über Xcode auf Ihrem Mac zu entkoppeln:

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

2. Öffnen Sie Xcode und klicken Sie auf Fenster > Geräte und Simulatoren Klicken Sie in dem daraufhin angezeigten Fenster auf Geräte.

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

   

Auf Gerät bereitstellen

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

1. Stellen Sie sicher, dass Ihr iOS-Gerät drahtlos mit Ihrem Mac-Build-Host 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 Build-Host gekoppelt ist. Weitere Informationen finden Sie unter Pair to Mac für die iOS-Entwicklung.

3. Verwenden Sie in der Visual Studio-Symbolleiste das Dropdown-Menü Debug-Ziel, um iOS-Remote-Geräte und dann das Gerät auszuwählen, das mit Ihrem Mac-Build-Host verbunden ist:

   

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

   

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-App auf einem lokalen 64-Bit-iOS-Gerät von Visual Studio aus bereitstellen, ohne einen Mac-Build-Host zu benötigen. Weitere Informationen finden Sie unter Bereitstellen einer iOS-App mit Hot Restart.

Problembehandlung

• Stellen Sie sicher, dass Ihr iOS-Gerät mit demselben Netzwerk wie Ihr Mac verbunden ist.
• Stellen Sie sicher, dass Ihr Gerät bereitgestellt ist. Weitere Informationen zum Provisioning finden Sie unter Geräteprovisioning für iOS.
• Überprüfen Sie, ob Xcode das Gerät erkennen kann:
  • Wählen Sie in Xcode Fenster >Geräte und Simulatoren aus, und klicken Sie in dem daraufhin angezeigten Fenster auf Geräte. Das Gerät sollte unter Verbunden erscheinen.
• Pingen Sie das Gerät:

  • Finden Sie die IP-Adresse des Geräts. Öffnen Sie auf dem Gerät Einstellungen, tippen Sie auf WLAN und dann auf die Informationstaste neben dem aktiven Netzwerk.

  • Auf einem Mac öffnen Sie Terminal und geben ping gefolgt von der IP-Adresse des Geräts ein. Wenn Ihr Mac das Gerät sehen kann, 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
    

    Wenn ein Fehler auftritt, wird Request timeout for icmp_seq 0 ausgegeben. Wenn Sie das Gerät nicht anpingen 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.
• Schließen Sie das Gerät über ein Ethernet-Kabel an das Netzwerk an:
  • Verwenden Sie den Lightning-auf-USB-Kameraadapter und einen USB-auf-Ethernet-Adapter.
• Koppeln Sie das iOS-Gerät erneut:
  • Entkoppeln sie das Gerät. Weitere Informationen finden Sie unter Entkoppeln eines iOS-Geräts.
  • Koppeln Sie das iOS-Gerät mit Xcode. Weitere Informationen finden Sie unter Koppeln eines iOS-Geräts.