Partager via


Simulateur iOS distant pour Windows

Le simulateur iOS distant pour Windows vous permet de tester vos applications sur un simulateur iOS affiché dans Windows en même temps que Visual Studio 2022.

Démarrer

Le simulateur iOS distant pour Windows est installé automatiquement dans le cadre de la charge de travail de développement de l’interface utilisateur d’application multiplateforme .NET dans Visual Studio 2022. Pour l’utiliser, procédez comme suit :

  1. Lancez Visual Studio 2022 et créez ou chargez un projet d’application .NET MAUI.

  2. Dans Visual Studio 2022, associez l’IDE à un hôte de build Mac si vous ne l’avez pas déjà fait. Pour plus d’informations, consultez Connexion à un Mac pour le développement d'applications iOS.

  3. Dans la barre d’outils Visual Studio, utilisez la liste déroulante Déboguer la cible pour sélectionner simulateurs iOS, puis un simulateur iOS spécifique :

    cibles de débogage pour simulateurs iOS de Visual Studio.

  4. Dans la barre d’outils Visual Studio, appuyez sur le bouton Démarrer vert pour votre simulateur iOS choisi :

    choix de la cible du simulateur iOS de Visual Studio.

    Visual Studio génère l’application, démarre le simulateur iOS distant pour Windows et déploie l’application sur le simulateur :

    Simulateur distant iOS de Visual Studio exécutant une application.

Activer le simulateur iOS distant pour Windows

Le simulateur iOS distant pour Windows est activé par défaut. Toutefois, s’il a été précédemment désactivé, il peut être activé dans Visual Studio en accédant à Outils > Options > Xamarin > Paramètres iOS et en veillant à ce que Simulateur distant vers Windows soit coché :

case à cocher dans Visual Studio pour activer le simulateur iOS distant.

Note

Lorsque le simulateur distant est désactivé dans Visual Studio, le débogage d’une application iOS .NET MAUI ouvre le simulateur iOS sur l’hôte de build Mac connecté.

Barre d’outils de la fenêtre simulateur

La barre d’outils située en haut de la fenêtre du simulateur affiche cinq boutons :

simulateur distant Visual Studio iOS pour la barre d’outils Windows.

Les boutons sont les suivants :

  • Accueil : simule le bouton Accueil sur un appareil iOS.
  • Verrouillage : verrouille le simulateur (balayez pour déverrouiller).
  • Prendre la capture d’écran : enregistre une capture d’écran du simulateur dans \Users\{User}\Pictures\Xamarin\iOS Simulator.
  • Paramètres : affiche le clavier et d’autres paramètres.
  • Autres options : affiche différentes options de simulateur telles que la rotation et le mouvement de secouement.

Cliquez sur le bouton Paramètres de la barre d’outils (icône d’engrenage) pour ouvrir la fenêtre Paramètres :

paramètres du simulateur distant iOS.

Ces paramètres vous permettent d’activer le clavier matériel et de réinitialiser le contenu et les paramètres du simulateur.

En cliquant sur le bouton d'autres options (l'icône de points de suspension) de la barre d'outils, des boutons supplémentaires tels que la rotation, les gestes de secouement et le redémarrage s'affichent :

paramètres supplémentaires pour le simulateur distant iOS.

Note

Le fait de cliquer avec le bouton droit n’importe où dans la fenêtre du simulateur iOS distant affiche tous les boutons de barre d’outils sous la forme d’un menu contextuel.

Prise en charge de l’écran tactile

De nombreux ordinateurs Windows ont des écrans tactiles. Étant donné que le simulateur iOS distant pour Windows prend en charge les interactions tactiles, vous pouvez tester votre application avec les mêmes gestes de pincement, balayage et gestes tactiles à plusieurs doigts que vous utiliseriez avec des appareils iOS physiques.

De même, le simulateur iOS distant pour Windows traite l’entrée de stylet Windows comme entrée Apple Pencil.

Gestion du son

Les sons joués par le simulateur proviennent des haut-parleurs du Mac hôte. Les sons iOS ne sont pas entendus sur Windows.

Dépannage

Dans certaines circonstances, un problème de configuration Xcode peut entraîner le simulateur iOS distant pour Windows à se bloquer dans une boucle de connexion à Mac... vérification du serveur... connecté... Lorsque cela se produit, vous devez supprimer et réinitialiser les simulateurs sur votre hôte de build Mac :

  • Vérifiez que l’agent Xamarin Mac (XMA) et Xcode ne sont pas en cours d’exécution.
  • Supprimez votre dossier ~/Library/Developer/CoreSimulator/Devices.
  • Exécutez killall -9 com.apple.CoreSimulator.CoreSimulatorService.
  • Exécutez xcrun simctl list devices.

Dans certains cas, Xcode a peut-être généré des appareils de simulateur qui peuvent également empêcher le simulateur iOS distant pour Windows de lire correctement ses propriétés, car il tente de vérifier les éléments sur lesquels il peut être déployé, ce qui provoque une boucle de démarrage.

Vous pouvez contourner ce problème en supprimant et en créant de nouveaux simulateurs sur lesquels vous pouvez effectuer le déploiement :

  • Vérifiez que l’agent Xamarin Mac (XMA) et Xcode ne sont pas en cours d’exécution.
  • Exécutez xcrun simctl list | grep -w "Shutdown" | grep -o "([-A-Z0-9]*)" | sed 's/[\(\)]//g' | xargs -I uuid xcrun simctl delete uuid.
  • Exécutez xcrun simctl list devices. Vous ne devriez voir aucun appareil répertorié.
  • Ouvrez Xcode sur votre Mac connecté.
  • Ouvrez Windows > Appareils & Simulateurs.
  • Sélectionnez Simulateurs.
  • Créez un simulateur sur lequel vous souhaitez effectuer le déploiement.

Journaux

Si vous rencontrez des problèmes avec le simulateur iOS distant, vous pouvez afficher les journaux aux emplacements suivants :

  • Mac~/Library/Logs/Xamarin/Simulator.Server
  • Windows%LOCALAPPDATA%\Xamarin\Logs\Xamarin.Simulator