Déploiement sans fil pour les applications iOS .NET MAUI

Plutôt que de devoir utiliser un câble USB pour connecter un appareil iOS à votre Mac afin de déployer et de déboguer une application NET Multi-platform App UI (.NET MAUI), Visual Studio peut déboguer et déployer des applications iOS .NET MAUI sur des appareils sans fil. Pour ce faire, vous devez associer votre appareil iOS à Xcode sur votre Mac. Une fois associé, vous pouvez le sélectionner dans la liste cible des appareils dans Visual Studio.

Important

Les applications iOS .NET MAUI doivent avoir été approvisionnées avant de pouvoir être déployées sur un appareil pour le test et le débogage. Pour plus d’informations, consultez Provisionnement des appareils pour iOS.

Associer un appareil iOS

Procédez comme suit pour associer un appareil iOS à Xcode sur votre Mac :

1. Assurez-vous toujours que votre appareil iOS est connectés au même réseau que votre Mac.

2. Branchez votre appareil iOS sur votre Mac à l’aide d’un câble USB.

   Remarque

   La première fois que vous connectez un appareil iOS à votre Mac, vous devez appuyer sur le bouton Faire confiance dans la boîte de dialogue Faire confiance à cet ordinateur sur votre appareil.

3. Ouvrez Xcode, et cliquez sur Window > Devices and Simulators. Dans la fenêtre qui s’affiche, cliquez sur Devices.

4. Dans la fenêtre Devices and Simulators, dans la colonne de gauche, sélectionnez votre appareil. Ensuite, dans la zone de détails, cochez la case Connect via network :

   

   Xcode s’associe à l’appareil iOS.

5. Dans la fenêtre Devices and Simulators, dans la colonne de gauche, une icône de réseau s’affiche à côté d’un appareil connecté associé :

   

6. Débranchez le câble USB et vérifiez que l’appareil reste associé.

Xcode conserve les paramètres d’association, de sorte que l’appareil ne doit pas avoir besoin d’être associé à nouveau.

Découpler un appareil iOS

Procédez comme suit pour découpler un appareil iOS à partir de Xcode sur votre Mac :

1. Assurez-vous toujours que votre appareil iOS est connectés au même réseau que votre Mac.

2. Ouvrez Xcode, et cliquez sur Window > Devices and Simulators. Dans la fenêtre qui s’affiche, cliquez sur Devices.

3. Dans la fenêtre Devices and Simulators, dans la colonne de gauche, sélectionnez votre appareil associé. Cliquez ensuite avec le bouton droit sur l’appareil, puis sélectionnez l’élément Unpair Device.

   

Déployer sur un appareil

Après avoir associé sans fil votre appareil à Xcode, les applications iOS .NET MAUI approvisionnées peuvent être déployées sans fil sur l’appareil avec Visual Studio :

1. Vérifiez que votre appareil iOS est associé sans fil à votre hôte de build Mac. Pour plus d’informations, consultez Associer un appareil iOS.

2. Dans Visual Studio, vérifiez que l’IDE est associé à un hôte de build Mac. Pour plus d’informations, consultez Appairer avec un Mac pour le développement iOS.

3. Dans la barre d’outils Visual Studio, utilisez la liste déroulante Cible de débogage pour sélectionner Appareils distants iOS, puis l’appareil qui est connecté à votre hôte de build Mac :

   

4. Dans la barre d’outils Visual Studio, appuyez sur le bouton Démarrer pour lancer l’application sur votre distant :

   

Remarque

Une autre approche du déploiement d’une application iOS .NET MAUI sur un appareil consiste à utiliser le redémarrage à chaud. Le redémarrage à chaud vous permet de déployer une application iOS sur un appareil iOS local 64 bits, à partir de Visual Studio, sans nécessiter d’hôte de build Mac. Pour plus d’informations, consultez Déployer une application iOS à l’aide du redémarrage à chaud.

Résolution des problèmes

• Assurez-vous toujours que votre appareil iOS est connecté au même réseau que votre Mac.
• Vérifiez que votre appareil est approvisionné. Pour plus d’informations sur le provisionnement, consultez Provisionnement des appareils pour iOS.
• Vérifiez que Xcode peut voir l’appareil :
  • Dans Xcode, choisissez Window > Devices and Simulators, puis dans la fenêtre qui s’affiche, cliquez sur Devices. L’appareil doit apparaître sous Connected.
• Effectuez un test ping sur l’appareil :

  • Trouvez l’adresse IP de l’appareil. Dans l’appareil, ouvrez les Paramètres, appuyez sur Wi-Fi, puis sur le bouton d’informations en regard du réseau actif.

  • Sur un Mac, ouvrez Terminal et tapez ping suivi de l’adresse IP de l’appareil. À condition que votre Mac puisse voir l’appareil, vous recevrez un résultat similaire à :

    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
    

    En cas d’erreur, le résultat est Request timeout for icmp_seq 0. Si vous ne pouvez pas effectuer un test ping sur l’appareil, le protocole ICMP (Internet Control Message Protocol) est bloqué ou il existe un autre problème de connectivité.

• Vérifiez que le port 62078 est ouvert.
• Connectez l’appareil au réseau avec un câble Ethernet :
  • Utilisez l’adaptateur pour appareil photo Lightning vers USB et un adaptateur USB vers Ethernet.
• Associez à nouveau l’appareil iOS :
  • Découplez l’appareil. Pour plus d’informations, consultez Découpler un appareil iOS.
  • Associez l’appareil iOS à Xcode. Pour plus d’informations, consultez Associer un appareil iOS.