Installer les outils de génération pour iOS

Article
06/10/2015

Cet article fait référence à Visual Studio Tools pour Apache Cordova, qui correspond à la version préliminaire du logiciel. Les fonctionnalités décrites sont dans l'aperçu et sont sujettes à modification. Vous pouvez télécharger l'aperçu à partir du Centre de téléchargement Microsoft.

Pour générer et exécuter des applications iOS sur le simulateur iOS ou sur un appareil iOS à l'aide de Visual Studio, vous devez installer et configurer l'agent distant, vs-mda-remote, sur un ordinateur Mac conforme à la configuration requise spécifiée ci-dessous. (Actuellement, les applications iOS ne peut pas être générées sous Windows.) Dans Visual Studio sur votre ordinateur, vous devez aussi configurer l'agent distant, comme décrit dans cette rubrique.

Notes

Si vous exécutez Windows sur un Mac à l'aide d'une technologie de virtualisation, vous pouvez générer et exécuter iOS localement.Pour plus d'informations, consultez Créer une application Cordova pour iOS à l'aide de Parallels.Pour plus d'informations sur l'utilisation des services Mac hébergés dans le cloud à la place d'un Mac, consultez Générer et simuler iOS dans le cloud.

Avant d'installer l'agent distant, assurez-vous d'avoir installé Visual Studio Tools for Apache Cordova.

Installer et configurer l'agent distant pour la génération et la simulation iOS

Vous pouvez configurer l'agent pour gérer les demandes de build, et pour exécuter l'application sur un appareil iOS ou sur le simulateur iOS. Pour héberger l'agent distant, l'ordinateur Mac doit avoir les éléments suivants installés :

Mac OS X Mavericks
Xcode 6
Outils en ligne de commande Xcode (depuis l'application Terminal, utilisez xcode-select --install)
Node.js

Vous devez aussi disposer des éléments suivants :

un compte de programme développeur iOS actif auprès d'Apple ;
un profil de mise en service iOS configuré dans Xcode (téléchargez le profil de mise en service et exécutez le fichier *.cer téléchargé) ;

Notes

Pour plus d'informations, consultez Gestion de vos identités de signature et de vos certificats dans la bibliothèque du développeur iOS.
une identité de signature configurée dans Xcode (choisissez XCode, Préférences).

Pour télécharger et installer l'agent distant

À partir de l'application Terminal sur votre Mac, tapez :
```
sudo npm install -g vs-mda-remote --user=$USER
```
où $USER sera remplacé par votre nom d'utilisateur sur le Mac. Quand vous exécutez cette commande, vous êtes invité à entrer également votre mot de passe.

Le commutateur d'installation globale (-g est recommandé mais pas obligatoire.

Au cours de l'installation, vs-mda-remote est installé et le mode développeur est activé sur votre Mac. Homebrew et deux packages npm sont également installés.

Avertissement

Pour installer Homebrew, vous avez besoin d'un accès sudo (administrateur).Si vous avez besoin d'installer vs-mda-remote sans sudo, vous pouvez installer Homebrew manuellement dans un emplacement usr/local et ajouter son dossier bin à votre chemin d'accès.Pour plus d'informations, reportez-vous à la documentation Homebrew.Si vous avez besoin d'activer manuellement le mode développeur, tapez ce qui suit dans l'application Terminal : DevToolsSecurity –enable

Si vous avez mis à jour votre ordinateur vers une nouvelle version de Visual Studio, vous devez aussi mettre à jour l'agent distant vers la version actuelle.

Pour mettre à jour l'agent distant

Répétez l'étape d'installation de la section précédente.

Pour démarrer l'agent distant

À partir de l'application Terminal sur votre Mac, tapez :
```
vs-mda-remote
```
Ceci démarrera l'agent avec le répertoire de build par défaut ~/remote-builds. Des options de configuration supplémentaires pour l'agent sont décrites ultérieurement dans cette rubrique.

La première fois que vous démarrerez l'agent, les informations requises pour configurer l'agent dans Visual Studio vous seront fournies, y compris l'hôte, le port et le code PIN de sécurité.

Important

Dans cette version, vs-mda-remote a été conçu pour transférer de manière sécurisée les charges utiles de la build en direction et à partir de Visual Studio à l'aide d'un code PIN.
Si vous envisagez de configurer l'agent distant dans Visual Studio à l'aide du nom d'hôte, envoyez une requête ping au Mac en utilisant le nom d'hôte pour vérifier qu'il est accessible. Dans le cas contraire, vous pouvez être amené à utiliser l'adresse IP à la place.

Avant de pouvoir utiliser l'agent distant, vous devez spécifier la configuration à distance dans Visual Studio.

Pour configurer l'agent distant à partir de Visual Studio

Si l'agent n'est pas encore en cours d'exécution sur votre Mac, démarrez l'agent distant.
Sur votre Mac, obtenez le nom d'hôte ou l'adresse IP de votre Mac.

Vous pouvez obtenir l'adresse IP à l'aide de la commande ifconfig.
Dans la barre de menus de Visual Studio, sélectionnez Outils, Options.
Dans la boîte de dialogue Options, ouvrez Tools for Apache Cordova, puis choisissez Remote Agent Configuration.
Affectez à Enable remote iOS processing la valeur True.
Dans les champs Host, Port et Security PIN, tapez les valeurs spécifiées par l'agent distant quand vous l'avez démarré pour la première fois. L'hôte peut être le nom ou l'adresse IP de votre Mac. Le numéro de port par défaut est 3000.

Notes

Si vous ne pouvez pas envoyer une requête ping au Mac en utilisant le nom d'hôte, vous pouvez être amené à utiliser l'adresse IP.

Quand vous cliquez sur OK, Visual Studio se connecte à l'agent distant (l'agent doit être en cours d'exécution pour cela).

Si vous souhaitez désactiver le mode sécurisé et activer les connexions HTTP simples, tapez la commande suivante dans l'application Terminal :
```
vs-mda-remote --secure false
```
Ensuite, vous pouvez laisser le champ Code PIN de sécurité vide pendant la configuration de l'agent dans Visual Studio.

Pour arrêter l'agent

Dans l'application Terminal sur votre Mac, appuyez sur Ctrl+C.

Quand vous démarrez l'agent pour la première fois, le code PIN généré est valide pendant une période limitée (par défaut, 10 minutes). Si vous ne vous connectez pas à l'agent avant l'expiration de ce délai, vous devrez générer un nouveau code PIN.

Pour générer un nouveau code PIN de sécurité

Arrêtez l'agent (ou ouvrez une deuxième fenêtre d'application Terminal sur votre Mac et utilisez-la pour entrer la commande).
À partir de l'application Terminal sur votre Mac, tapez :
```
vs-mda-remote generateClientCert
```

Pour des raisons de sécurité, les certificats de serveur qui associent Visual Studio à l'agent distant sont liés au nom d'hôte ou à l'adresse IP de votre Mac. Si ces valeurs ont changé, vous devez générer un nouveau certificat de serveur et reconfigurer Visual Studio avec les nouvelles valeurs.

Pour générer un nouveau certificat de serveur

Arrêtez l'agent.
À partir de l'application Terminal sur votre Mac, tapez :
```
vs-mda-remote resetServerCert
```
Quand vous y êtes invité, tapez « O » et appuyez sur Entrée.
À partir de l'application Terminal sur votre Mac, tapez :
```
vs-mda-remote generateClientCert
```
Suivez les instructions ci-dessus pour entrer le nouveau code PIN de sécurité, ainsi que les informations d'hôte ou IP.

Vous pouvez configurer l'agent distant à l'aide de diverses options de ligne de commande. Par exemple, vous pouvez spécifier le port où écouter les demandes de build et spécifier le nombre maximal de builds à conserver sur le système de fichiers. (Par défaut, cette limite est 10.) L'agent supprimera les builds dépassant ce maximum lors de l'arrêt.)

Avertissement

Certaines de ces options ont changé depuis la version 0.2 de vs-mda-remote.Le changement le plus important est que l'option --buildDir a été renommée --serverDir.

Pour configurer l'agent distant

Pour afficher la liste complète des commandes de l'agent, tapez :
```
vs-mda-remote --help
```
Pour désactiver le mode sécurisé et activer les connexions HTTP simples, tapez :
```
vs-mda-remote --secure false
```
Quand vous utilisez cette option, laissez le champ du code PIN vide pendant la configuration de l'agent dans Visual Studio.
Pour spécifier un emplacement pour les fichiers de l'agent distant, tapez :
```
vs-mda-remote --serverDir <directory>
```
où <directory> est l'emplacement sur votre Mac où les fichiers journaux, les builds et les certificats de serveur seront placés. Par exemple, l'emplacement pourrait être /Users/nom_utilisateur/builds. (Les builds seront organisées par numéro de build à cet emplacement.)
Pour utiliser un processus en arrière-plan pour capturer stdout et stderr dans un fichier (server.log), tapez :
```
vs-mda-remote > server.log 2>&1 &
```
Le fichier server.log peut aider à la résolution des problèmes de génération.
Pour exécuter l'agent en utilisant un fichier de configuration au lieu de paramètres de ligne de commande, tapez :
```
vs-mda-remote --config <path-to-config-file>
```
Le fichier de configuration doit être au format JSON. Les options de démarrage et leurs valeurs ne doivent pas inclure de tirets. Pour voir un exemple de fichier de configuration, regardez dans le dossier vs-mda-remote/examples/exampleConfig.json, dans le répertoire d'installation de l'agent distant. Par exemple, le chemin d'accès peut être /usr/local/lib/node_modules/vs-mda-remote/examples/exampleConfig.json.

Pour vérifier la configuration de l'agent distant

Pendant l'exécution de l'agent distant, ouvrez une deuxième fenêtre d'application Terminal (choisissez Shell, Nouvelle fenêtre).
Dans la deuxième fenêtre de l'application Terminal sur votre Mac, tapez :
```
vs-mda-remote test
```
Important

Cette commande échoue si l'agent n'est pas en cours d'exécution dans une deuxième fenêtre.

Cette commande lance une génération de test. La sortie de la commande doit afficher le numéro de la build et d'autres informations sur cette build, comme sa progression.

Après avoir démarré une build de test, vérifiez la build.
Si vous avez démarré le serveur sur un port autre que 3 000, utilisez à la place la commande suivante pour démarrer une génération de test :
```
vs-mda-remote test https://localhost:<portNumber>
```
Pour vérifier que votre identité de signature de développeur est configurée correctement pour les builds d'appareil (en utilisant les configurations Debug et Release de Visual Studio), tapez :
```
vs-mda-remote test --device
```
Pour vérifier que votre identité de signature de distribution est configurée correctement pour les builds d'appareil (en utilisant la configuration Distribution dans Visual Studio), tapez :
```
vs-mda-remote test --device --cfg distribution
```
Pour plus d'informations sur la mise en service d'une application et les identités de signature de certificat, consultez Créer un package pour votre application générée à l'aide de Visual Studio Tools for Apache Cordova.

Dans certains cas, vous pouvez avoir besoin d'obtenir l'accès au projet Xcode généré pour résoudre un problème natif. Heureusement, vous pouvez rapidement accéder au projet qui a servi à générer votre application.

Pour accéder à un projet Xcode généré

Générez votre application à l'aide d'un simulateur iOS ou d'un appareil cible.
Une fois la génération terminée, accédez à la fenêtre Sortie et sélectionnez Afficher la sortie à partir de : Build.

Les entrées finales de la sortie de génération doivent être similaires à :
```
1>  ** BUILD SUCCEEDED **
1>  
1>  Command finished with error code 0: /Users/<username>/remote-builds/builds/8382/cordovaApp/platforms/ios/cordova/build --debug
```
Sur votre Mac, accédez au dossier ios correspondant au chemin d'accès spécifié dans la sortie de génération. Dans l'exemple ci-dessus, il s'agit de /Users/<nom_utilisateur>/remote-builds/builds/8382/cordovaApp/platforms/ios

Important

Quand l'agent vs-mda-remote est arrêté, la build (y compris le projet xcode généré) est supprimée à moins que vous ayez démarré vs-mda-remote avec la commande suivante : --deleteBuildsOnShutdown false.
Double-cliquez sur le fichier .xcodeproj dans ce dossier et le projet s'ouvrira dans Xcode.

Voir aussi

Concepts

Installer Visual Studio Tools for Apache Cordova

Exécuter votre application Apache Cordova sur iOS

Partager via