Appairer avec un Mac pour le développement Xamarin.iOS

Ce guide décrit comment utiliser Appairer avec un Mac pour connecter Visual Studio 2019 à un hôte de build Mac. Les mêmes instructions s’appliquent à Visual Studio 2017.

Vue d’ensemble

La génération d’applications iOS natives nécessite l’accès aux outils de génération d’Apple, qui s’exécutent seulement sur un Mac. Pour cette raison, Visual Studio 2019 doit se connecter à un Mac accessible par le biais du réseau pour générer des applications Xamarin.iOS.

La fonctionnalité Appairer avec un Mac de Visual Studio 2019 permet de découvrir les hôtes de build Mac, de s’y connecter, de s’authentifier auprès d’eux et de les mémoriser afin que les développeurs iOS Windows puissent travailler de manière productive.

Avec Appairer avec un Mac, le flux de travail de développement est le suivant :

• Les développeurs peuvent écrire du code Xamarin.iOS dans Visual Studio 2019.

• Visual Studio 2019 ouvre une connexion réseau à un hôte de build Mac et utilise les outils de génération sur cet ordinateur pour compiler et signer l’application iOS.

• Il est inutile d’exécuter une application distincte sur le Mac : Visual Studio 2019 appelle les builds Mac de manière sécurisée via SSH.

• Visual Studio 2019 est averti des modifications dès qu’elles se produisent. Par exemple, quand un appareil iOS est branché sur le Mac ou devient disponible sur le réseau, la barre d’outils iOS est instantanément mise à jour.

• Plusieurs instances de Visual Studio 2019 peuvent se connecter simultanément au Mac.

• Il est possible d’utiliser la ligne de commande Windows pour générer des applications iOS.

Activer la session à distance sur le Mac

Pour configurer l’hôte de build Mac, activez tout d’abord la session à distance :

1. Sur le Mac, ouvrez les préférences système et accédez au volet Partage.

2. Cochez Session à distance dans la liste Service.

   

   Assurez-vous qu’il est configuré pour autoriser l’accès à Tous les utilisateurs, ou que votre nom d’utilisateur ou groupe Mac est inclus dans la liste des utilisateurs autorisés.

3. Si vous y êtes invité, configurez le pare-feu macOS.

   Si le pare-feu macOS est défini pour bloquer les connexions entrantes, vous devrez peut-être autoriser mono-sgen à les recevoir. Une alerte s’affiche pour vous demander si c’est le cas.

4. S’il se trouve sur le même réseau que l’ordinateur Windows, le Mac doit maintenant pouvoir être découvert par Visual Studio 2019. Dans le cas contraire, essayez d’ajouter manuellement un Mac ou examinez le guide de résolution des problèmes.

Se connecter au Mac à partir de Visual Studio 2019

Maintenant que la session à distance est activée, connectez Visual Studio 2019 au Mac.

1. Dans Visual Studio 2019, ouvrez un projet iOS existant ou créez-en un en choisissant Fichier > Nouveau > projet , puis en sélectionnant un modèle de projet iOS.

2. Ouvrez la boîte de dialogue Appairer avec un Mac.

   • Utilisez le bouton Appairer avec un Mac de la barre d’outils iOS :

     

   • Vous pouvez également sélectionner Outils > paire iOS > à Mac.

   • La boîte de dialogue Appairer avec un Mac affiche une liste de tous les hôtes de build Mac précédemment connectés et actuellement disponibles :

     

3. Sélectionnez un Mac dans la liste. Cliquez sur Connexion.

4. Entrez votre nom d'utilisateur et votre mot de passe.

   • La première fois que vous vous connectez à un Mac spécifique, il vous est demander d’entrer votre nom d’utilisateur et votre mot de passe pour cet ordinateur :

     

     Conseil

     Lors de la connexion, utilisez votre nom d’utilisateur système plutôt que votre nom complet.

   • Appairer avec un Mac utilise ces informations d’identification pour créer une connexion SSH au Mac. En cas de réussite, une clé est ajoutée au fichier authorized_keys sur le Mac. Les connexions ultérieures au même Mac seront établies automatiquement.

5. Appairer avec un Mac configure automatiquement le Mac.

   À compter de Visual Studio 2019 version 15.6, Visual Studio 2019 installe ou met à jour Mono et Xamarin.iOS sur un hôte de build Mac connecté si nécessaire (notez que Xcode doit néanmoins être installé manuellement). Pour plus d’informations, consultez Provisionnement Mac automatique.

6. Recherchez l’icône d’état de connexion.

   • Quand Visual Studio 2019 est connecté à un Mac, l’élément de ce Mac dans la boîte de dialogue Appairer avec un Mac affiche une icône indiquant qu’il est actuellement connecté :

     

     Il ne peut y avoir qu’un seul Mac connecté à la fois.

     Conseil

     Un clic droit sur n’importe quel Mac dans la liste Appairer avec un Mac permet d’afficher un menu contextuel dans lequel vous pouvez choisir Se connecter..., Oublier ce Mac ou Se déconnecter :

     

     Si vous choisissez Oublier ce Mac, vos informations d’identification pour le Mac sélectionné seront oubliées. Pour vous reconnecter à ce Mac, vous devez entrer à nouveau vos nom d’utilisateur et mot de passe.

Si vous vous êtes correctement associé à un hôte de build Mac, vous êtes prêt à générer des applications Xamarin.iOS dans Visual Studio 2019. Examinez le guide Introduction à Xamarin.iOS pour Visual Studio.

Si vous n’avez pas réussi à vous associer à un Mac, essayez d’ajouter manuellement un Mac ou examinez le guide de résolution des problèmes.

Ajouter manuellement un Mac

Si vous ne voyez pas un Mac particulier répertorié dans la boîte de dialogue Appairer avec un Mac, ajoutez-le manuellement :

1. Recherchez l’adresse IP de votre Mac.

   • Ouvrez Préférences > système Partage de > la connexion à distance sur votre Mac :

     

   • Vous pouvez également utiliser la ligne de commande. Dans Terminal, exécutez cette commande :

     $ ipconfig getifaddr en0
     196.168.1.8
     

     Selon votre configuration réseau, vous devrez peut-être utiliser un nom d’interface autre que en0. Par exemple : en1, en2, etc.

2. Dans la boîte de dialogue Appairer avec un Mac de Visual Studio 2019, sélectionnez Ajouter un Mac... :

   

3. Entrez l’adresse IP du Mac et cliquez sur Ajouter :

   

4. Entrez vos nom d’utilisateur et mot de passe pour le Mac :

   

   Conseil

   Lors de la connexion, utilisez votre nom d’utilisateur système plutôt que votre nom complet.

5. Cliquez sur Connexion pour connecter Visual Studio 2019 au Mac par le biais de SSH et l’ajouter à la liste des ordinateurs connus.

Provisionnement Mac automatique

À compter de Visual Studio 2019 version 15.6, Coupler à Mac approvisionne automatiquement un Mac avec les logiciels nécessaires à la création d’applications Xamarin.iOS : Mono, Xamarin.iOS (l’infrastructure logicielle, pas l’IDE Visual Studio pour Mac) et divers outils Xcode (mais pas Xcode lui-même).

Appairer avec un Mac effectue les installations/mises à jour de logiciels nécessaires quand Visual Studio 2019 se connecte au Mac.

Mono

Appairer avec un Mac vérifie que Mono est installé. S’il n’est pas installé, Appairer avec un Mac télécharge et installe la dernière version stable de Mono sur le Mac.

La progression est indiquée par différentes invites, comme illustré par les captures d’écran suivantes (cliquez pour effectuer un zoom) :

Mono	Vérification de l’installation	Downloading	Installation de

Xamarin.iOS

Appairer avec un Mac met à niveau Xamarin.iOS sur le Mac pour correspondre à la version installée sur l’ordinateur Windows.

La progression est indiquée par différentes invites, comme illustré par les captures d’écran suivantes (cliquez pour effectuer un zoom) :

Xamarin.iOS	Vérification de l’installation	Downloading	Installation de

Licence et outils Xcode

Appairer avec un Mac vérifie également si Xcode a été installé et sa licence acceptée. Même si Appairer avec un Mac n’installe pas Xcode, il demande l’acceptation de la licence, comme illustré par les captures d’écran suivantes (cliquez pour effectuer un zoom) :

Xcode	Vérification de l’installation	Acceptation de la licence

En outre, Appairer avec un Mac installe ou met à jour différents packages distribués avec Xcode. Par exemple :

• MobileDeviceDevelopment.pkg
• XcodeExtensionSupport.pkg
• MobileDevice.pkg
• XcodeSystemResources.pkg

L’installation de ces packages se produit rapidement et sans invite.

Résolution des problèmes de provisionnement Mac automatique

Si vous rencontrez des problèmes avec le provisionnement Mac automatique, examinez les journaux IDE Visual Studio 2019, stockés dans %LOCALAPPDATA%\Xamarin\Logs\16.0. Ces journaux peuvent contenir des messages d’erreur pour vous aider à mieux diagnostiquer l’échec ou obtenir un support technique.

Générer des applications iOS à partir de la ligne de commande Windows

Appairer avec un Mac prend en charge la génération d’applications Xamarin.iOS à partir de la ligne de commande. Par exemple :

C:\samples\App1>msbuild App1.sln /p:ServerAddress=10.211.55.2 /p:ServerUser=xamUser /p:Platform=iPhoneSimulator /p:ServerPassword=mypassword

Les paramètres transmis à msbuild dans l’exemple ci-dessus sont :

• ServerAddress : adresse IP de l’hôte de build Mac.
• ServerUser : nom d’utilisateur à employer lors de la connexion à l’hôte de build Mac. Utilisez votre nom d’utilisateur système plutôt que votre nom complet.
• ServerPassword : mot de passe à utiliser lors de la connexion à l’hôte de build Mac.

La première fois que la fonctionnalité Appairer avec un Mac se connecte à un hôte de build Mac particulier à partir de Visual Studio 2019 ou de la ligne de commande, elle configure les clés SSH. Avec ces clés, les connexions ultérieures ne nécessitent pas de nom d’utilisateur ni de mot de passe. Les clés nouvellement créées sont stockées dans %LOCALAPPDATA%\Xamarin\MonoTouch.

Si le paramètre ServerPassword est omis à partir d’un appel de build de ligne de commande, Appairer avec un Mac tente de se connecter à l’hôte de build Mac à l’aide des clés SSH enregistrées.

Résumé

Cet article a décrit comment utiliser Appairer avec un Mac pour connecter Visual Studio 2019 à un hôte de build Mac, ce qui permet aux développeurs Visual Studio 2019 de générer des applications iOS natives avec Xamarin.iOS.

Étapes suivantes

• Résolution des problèmes de connexion
• Vidéo sur l’agent de build Mac Xamarin
• Introduction à Xamarin.iOS pour Visual Studio
• Remoted iOS Simulator pour Windows
• Déploiement sans fil