Distribuzione wireless per le app iOS .NET MAUI

Invece di dover usare un cavo USB per connettere un dispositivo iOS al Mac per distribuire ed eseguire il debug di un'app .NET Multipiattaforma App UI (.NET MAUI), Visual Studio può distribuire app iOS MAUI .NET ai dispositivi in modalità wireless ed eseguirne il debug wireless. A tale scopo, è necessario associare il dispositivo iOS a Xcode sul Mac. Una volta abbinato, il dispositivo può essere selezionato dall'elenco di destinazione del dispositivo in Visual Studio.

Importante

È necessario eseguire il provisioning delle app .NET MAUI iOS prima di poter essere distribuite in un dispositivo per il test e il debug. Per altre informazioni, vedere Provisioning dei dispositivi per iOS.

Associare un dispositivo iOS

Seguire questa procedura per associare un dispositivo iOS a Xcode nel Mac:

  1. Assicurarsi che il dispositivo iOS sia connesso alla stessa rete wireless del Mac.

  2. Collegare il dispositivo iOS al Mac usando un cavo USB.

    Nota

    La prima volta che si connette un dispositivo iOS al Mac, è necessario toccare il pulsante Attendibilità nella finestra di dialogo Considera attendibile questo computer nel dispositivo.

  3. Aprire Xcode e fare clic su Dispositivi > finestra e simulatori. Nella finestra visualizzata fare clic su Dispositivi.

  4. Nella colonna sinistra della finestra Dispositivi e simulatori selezionare il dispositivo. Nell'area dei dettagli selezionare quindi la casella di controllo Connetti tramite rete :

    Screenshot della finestra Dispositivi e simulatori che mostra l'opzione Connetti tramite rete.

    Xcode associa il dispositivo iOS.

  5. Nella colonna sinistra della finestra Dispositivi e simulatori verrà visualizzata un'icona di rete accanto a un dispositivo connesso associato:

    Screenshot della finestra Dispositivi e simulatori che mostra un dispositivo iOS associato.

  6. Scollegare il cavo USB e verificare che il dispositivo rimanga associato.

Xcode manterrà le impostazioni di associazione, quindi il dispositivo non deve essere associato di nuovo.

Annullare l'associazione di un dispositivo iOS

Seguire questa procedura per annullare l'associazione di un dispositivo iOS da Xcode sul Mac:

  1. Assicurarsi che il dispositivo iOS sia connesso alla stessa rete wireless del Mac.

  2. Aprire Xcode e fare clic su Dispositivi > finestra e simulatori. Nella finestra visualizzata fare clic su Dispositivi.

  3. Nella colonna sinistra della finestra Dispositivi e simulatori selezionare il dispositivo associato. Fare quindi clic con il pulsante destro del mouse sul dispositivo e selezionare l'elemento Annulla associazione dispositivo .

    Screenshot della finestra Dispositivi e simulatori che mostra un dispositivo iOS associato che sta per essere scollegato.

Distribuzione nel dispositivo

Dopo l'associazione wireless del dispositivo a Xcode, è possibile distribuire in modalità wireless le app .NET MAUI iOS con .NET con Visual Studio:

  1. Assicurarsi che il dispositivo iOS sia associato in modalità wireless all'host di compilazione Mac. Per altre informazioni, vedere Associare un dispositivo iOS.

  2. In Visual Studio verificare che l'IDE sia associato a un host di compilazione Mac. Per altre informazioni, vedere Associare a Mac per lo sviluppo iOS.

  3. Nella barra degli strumenti di Visual Studio usare l'elenco a discesa Destinazione di debug per selezionare Dispositivi remoti iOS e quindi il dispositivo connesso all'host di compilazione Mac:

    Selezionare il dispositivo remoto in Visual Studio.

  4. Nella barra degli strumenti di Visual Studio premere il pulsante Start verde per avviare l'app nel dispositivo remoto:

    Scelta della destinazione di debug del dispositivo iOS di Visual Studio.

Nota

Un approccio alternativo alla distribuzione di un'app iOS .NET MAUI in un dispositivo consiste nell'usare il riavvio a caldo. Il riavvio rapido consente di distribuire un'app MAUI .NET in un dispositivo iOS locale a 64 bit, da Visual Studio, senza richiedere un host di compilazione Mac. Per altre informazioni, vedere Distribuire un'app iOS usando il riavvio rapido.

Risoluzione dei problemi

  • Assicurarsi che il dispositivo iOS sia connesso alla stessa rete del Mac.
  • Assicurarsi che il provisioning del dispositivo sia stato effettuato. Per altre informazioni sul provisioning, vedere Provisioning dei dispositivi per iOS.
  • Verificare che Xcode possa visualizzare il dispositivo:
    • In Xcode scegliere Dispositivi e simulatori finestra > e nella finestra visualizzata fare clic su Dispositivi. Il dispositivo dovrebbe essere visualizzato in Connesso.
  • Effettuare il ping del dispositivo:
    • Trovare l'indirizzo IP del dispositivo. Nel dispositivo aprire Impostazioni toccare Wi-Fi e quindi toccare il pulsante informazioni accanto alla rete attiva.

    • In un Mac aprire Terminale e digitare ping seguito dall'indirizzo IP del dispositivo. A condizione che il Mac possa visualizzare il dispositivo, si riceverà un output simile al seguente:

      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
      

      Se si verifica un errore, l'output sarà Request timeout for icmp_seq 0. Se non è possibile effettuare il ping del dispositivo, il protocollo ICMP (Internet Control Message Protocol) viene bloccato o si verifica un altro problema di connettività.

  • Verificare che la porta 62078 sia aperta.
  • Connettere il dispositivo alla rete usando un cavo Ethernet:
    • Usare l'adattatore da fotocamera USB a Fulmine e una scheda USB a Ethernet.
  • Riabilitare il dispositivo iOS: