Share via

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

  • Article

Au lieu d’utiliser un câble USB pour connecter un appareil iOS à votre Mac pour déployer et déboguer une application d’interface utilisateur d’application multiplateforme .NET (.NET MAUI), Visual Studio et Visual Studio pour Mac peuvent déployer des applications iOS MAUI .NET sur des appareils sans fil et les déboguer sans fil. Pour ce faire, vous devez associer votre appareil iOS à Xcode sur votre Mac. Une fois associé, l’appareil peut être sélectionné dans la liste cible de l’appareil dans Visual Studio et Visual Studio pour Mac.

Important

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

Associer un appareil iOS

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

  1. Vérifiez que votre appareil iOS est connecté au même réseau sans fil 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 Approbation dans la boîte de dialogue Approuver cet ordinateur sur votre appareil.

  3. Ouvrez Xcode, puis cliquez sur Appareils et simulateurs de fenêtre>. Dans la fenêtre qui s’affiche, cliquez sur Appareils.

  4. Dans la fenêtre Appareils et simulateurs , dans la colonne de gauche, sélectionnez votre appareil. Ensuite, dans la zone de détails, sélectionnez le Connecter via la zone de case activée réseau :

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

    Paires Xcode avec l’appareil iOS.

  5. Dans la fenêtre Appareils et simulateurs , dans la colonne de gauche, une icône réseau s’affiche en regard d’un appareil connecté associé :

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

  6. Déconnectez le câble USB et case activée que l’appareil reste associé.

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

Annuler lepair un appareil iOS

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

  1. Vérifiez que votre appareil iOS est connecté au même réseau sans fil que votre Mac.

  2. Ouvrez Xcode, puis cliquez sur Appareils et simulateurs de fenêtre>. Dans la fenêtre qui s’affiche, cliquez sur Appareils.

  3. Dans la fenêtre Appareils et simulateurs , dans la colonne de gauche, sélectionnez votre appareil jumelé. Cliquez ensuite avec le bouton droit sur l’appareil, puis sélectionnez l’élément Unpair Device .

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

Déployer sur un appareil

Une fois que vous avez associé votre appareil sans fil à Xcode, les applications iOS .NET MAUI approvisionnées peuvent être déployées sans fil sur l’appareil.

  1. Vérifiez que votre appareil iOS est associé sans fil à votre hôte de build Mac. Pour plus d’informations, consultez Appairer 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 Pair to 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 les appareils distants iOS, puis l’appareil connecté à votre hôte de build Mac :

    Select your remote device in Visual Studio.

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

    Visual Studio iOS device debug target choice.

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 .NET MAUI 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ésoudre les problèmes

  • Vérifiez 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 l’approvisionnement, consultez Provisionnement d’appareils pour iOS.
  • Vérifiez que Xcode peut voir l’appareil :
    • Dans Xcode, choisissez Appareils et simulateurs de > fenêtre, puis dans la fenêtre qui s’affiche, cliquez sur Appareils. L’appareil doit apparaître sous Connecter ed.
  • Effectuez un test ping sur l’appareil :

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

    • Sur un Mac, ouvrez Terminal et tapez ping l’adresse IP de l’appareil. À condition que votre Mac puisse voir l’appareil, vous recevrez une sortie 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, la sortie 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.
  • Connecter l’appareil au réseau à l’aide d’un câble Ethernet :
    • Utilisez l’adaptateur de caméra Lightning vers USB et un adaptateur USB vers Ethernet.
  • Réappariez l’appareil iOS :