Tutoriel complet pour créer de zéro un environnement de développement iOS sur Mac : de Xcode, Homebrew, Git et CocoaPods à la première App

Vous ouvrez un nouveau Mac, mais ne savez pas si vous devez installer Git, Homebrew ou Xcode en premier.

Pour configurer un environnement de développement iOS sur Mac, installez et ouvrez d’abord Xcode, configurez ensuite Homebrew et Git, puis ajoutez CocoaPods uniquement si le projet en a besoin. Créez enfin une app dans Xcode et lancez-la dans un simulateur ou sur un appareil compatible.

Cette semaine : vérifiez d’abord la compatibilité de macOS, puis suivez les étapes dans cet ordre. Ne diagnostiquez pas un échec de compilation avant d’avoir confirmé que les composants de Xcode sont installés et que le projet a résolu ses dépendances.

Ce guide s’adresse à vous si vous débutez le développement iOS sur Mac ou si vous réinstallez votre environnement.
Il convient aussi aux personnes et aux équipes qui doivent compiler et tester un projet sur leur Mac, localement ou à distance.

Avant de commencer : vérifier le Mac plutôt que multiplier les installations

Consultez les exigences système de Xcode avant de télécharger l’outil. Apple y indique les versions de macOS compatibles avec chaque version de Xcode. Vérifiez la correspondance pour la version que vous comptez utiliser, en particulier si vous reprenez un projet existant : le projet et l’outil peuvent imposer des contraintes différentes.

Sur le Mac, relevez la version de macOS dans les réglages système, puis vérifiez l’espace disponible. Xcode et ses composants peuvent occuper une place importante, mais l’espace nécessaire varie avec la version et les composants installés. Ne partez donc pas d’un chiffre trouvé hors contexte : comparez l’espace restant aux informations de téléchargement et au stockage des simulateurs dont vous avez besoin.

Vérifiez aussi le compte utilisé pour l’installation. Vous devez pouvoir installer les applications et accepter les demandes d’autorisation qui s’affichent. Si le Mac est géré par une organisation, une politique informatique peut limiter ces actions ; dans ce cas, demandez l’accès nécessaire avant d’essayer de contourner la restriction.

Un compte Apple n’a pas le même rôle dans tous les scénarios. Vous pouvez apprendre et développer sans publier une app. En revanche, certaines opérations liées à un compte développeur, aux capacités d’une app ou à sa distribution peuvent nécessiter un compte adapté. La documentation Apple sur les comptes développeur détaille les différences. Le simulateur permet de vérifier l’exécution sans appareil physique ; un iPhone ou un iPad devient utile si vous devez tester le comportement matériel ou les interactions propres à l’appareil.

À retenir : si le Mac ne satisfait pas les exigences de la version de Xcode visée, arrêtez-vous avant d’installer des outils annexes. Homebrew et Git ne résolvent pas une incompatibilité entre macOS et Xcode.

Installer Xcode : l’outil principal avant les utilitaires

Téléchargez Xcode depuis la source officielle indiquée sur la page Apple consacrée à Xcode. Choisissez une version compatible avec votre macOS et, si vous rejoignez un projet, avec ses exigences. Une mise à jour récente n’est pas automatiquement le meilleur choix pour un projet qui doit conserver une chaîne de compilation précise.

Après le téléchargement, ouvrez Xcode. L’application peut proposer d’installer des composants supplémentaires ou de valider une licence. Laissez cette première configuration se terminer avant de lancer un projet. Les composants nécessaires ne sont pas tous présents tant que ces demandes restent en attente. Pour ajouter ou gérer des éléments ultérieurement, suivez les instructions Apple relatives aux composants supplémentaires de Xcode.

Vérifiez ensuite que les outils en ligne de commande pointent vers l’installation voulue :

xcode-select -p
xcodebuild -version

La première commande indique le répertoire de développement sélectionné ; la seconde affiche les informations de version disponibles. Si la commande échoue ou signale l’absence d’outils, ne réinstallez pas tout immédiatement. Ouvrez Xcode, regardez si une étape de configuration attend encore votre accord, puis consultez la page Apple sur l’installation des outils de ligne de commande.

Xcode fournit notamment le SDK iOS, les outils de compilation, le simulateur et l’interface de création de projets. Homebrew ne remplace aucun de ces éléments : il sert à gérer d’autres outils installés sur le Mac. Git, lui, suit les modifications du code. Cette distinction évite une erreur fréquente : installer plusieurs utilitaires et supposer que le projet peut compiler sans Xcode opérationnel.

Configurer Homebrew et Git : deux rôles différents

Homebrew simplifie l’installation et la mise à jour de logiciels en ligne de commande. Avant d’utiliser sa commande d’installation, vérifiez les prérequis et la procédure dans sa documentation officielle. La procédure peut évoluer ; reprenez la commande affichée par cette source plutôt qu’une ligne copiée d’un ancien tutoriel.

Une fois l’installation terminée, suivez les indications affichées par le programme d’installation, notamment si elles vous demandent d’ajouter Homebrew au chemin de recherche du shell. Fermez puis rouvrez le Terminal si nécessaire, puis vérifiez :

brew --version
brew doctor

Une version qui s’affiche confirme que la commande est accessible. Le diagnostic peut signaler des problèmes sans empêcher tous les usages : lisez les avertissements avant de modifier des fichiers ou de supprimer des éléments. Les emplacements d’installation dépendent notamment de l’architecture du Mac ; ne copiez pas un chemin trouvé sur une autre machine sans vérifier ce que votre installation indique.

Pour Git, vérifiez d’abord si la commande existe :

git --version

Si Git est absent ou si vous voulez choisir une méthode d’installation, consultez la page officielle d’installation de Git pour macOS. Après installation, définissez l’identité qui apparaîtra dans vos commits :

git config --global user.name "Votre nom"
git config --global user.email "vous@example.net"

Remplacez les valeurs d’exemple par celles que vous souhaitez associer à vos modifications. Contrôlez les réglages avec :

git config --global --list

Git ne sauvegarde pas automatiquement votre travail à distance et ne gère pas les dépendances iOS. Il enregistre l’historique des modifications lorsque vous créez des commits. Homebrew installe des outils ; Git versionne les fichiers ; Xcode construit et exécute l’application. Cette séparation est utile quand un collègue vous demande de « réinstaller l’environnement » : vous pouvez vérifier chaque maillon au lieu de chercher un outil unique censé tout faire.

Choisir CocoaPods seulement si le projet le demande

Un projet peut employer CocoaPods, Swift Package Manager ou une autre méthode déjà documentée dans son dépôt. Regardez d’abord les consignes du projet et les fichiers de configuration présents. Apple documente l’ajout de dépendances avec Swift Package Manager dans Xcode ; CocoaPods est donc une option parmi les gestionnaires possibles, pas une étape obligatoire pour toute app.

Si les instructions du projet mentionnent un Podfile, utilisez le guide officiel de prise en main de CocoaPods pour installer et employer l’outil selon les exigences indiquées. Dans le dossier du projet, vérifiez que le fichier de configuration est bien présent avant de lancer la résolution des dépendances prévue par le projet. Après cette opération, examinez les changements produits et suivez les consignes du dépôt pour ouvrir le projet généré. Ne supprimez pas de fichiers de verrouillage pour « repartir proprement » sans comprendre leur rôle : ils participent à la cohérence des versions de dépendances entre machines.

Cas de blocage : si une installation échoue avec une erreur liée à Ruby ou à une version de dépendance, conservez le message complet. Comparez les prérequis du projet et ceux de la documentation CocoaPods avant de mettre à niveau Ruby, de changer de gestionnaire ou de supprimer des fichiers.

FAQ : les choix qui changent selon votre situation

Dans quel ordre installer les outils iOS sur un Mac neuf ?
Vérifiez macOS, installez et ouvrez Xcode, puis configurez Homebrew et Git. Ajoutez CocoaPods uniquement si les instructions du projet le demandent. Enfin, créez une app de test et lancez-la dans un simulateur ou sur un appareil compatible. Un outil installé mais jamais utilisé dans un projet ne suffit pas à confirmer que la chaîne fonctionne.

Comment savoir si Xcode et ses outils de ligne de commande sont prêts ?
Ouvrez Xcode et terminez toute installation de composants ou demande de licence. Dans le Terminal, utilisez xcode-select -p et xcodebuild -version. Si une commande indique que les outils manquent, consultez la procédure Apple d’installation des outils de ligne de commande avant de modifier le chemin de développement sélectionné.

CocoaPods est-il nécessaire à chaque nouveau projet iOS ?
Non. Le projet choisit son mode de gestion des dépendances. S’il contient un Podfile et demande CocoaPods, suivez ses instructions et vérifiez le résultat de la résolution. S’il utilise Swift Package Manager, n’ajoutez pas CocoaPods par principe : un gestionnaire supplémentaire peut compliquer la configuration sans apporter de bénéfice à ce projet.

Comment confirmer qu’une première app fonctionne réellement ?
Créez un projet iOS dans Xcode, choisissez une destination disponible et lancez la compilation. Ensuite, ouvrez l’app dans le simulateur ou sur un appareil configuré. Vous devez obtenir un résultat de compilation réussi et voir l’app démarrer. Si l’une de ces étapes échoue, notez la phase concernée avant de chercher un correctif.

Créer et lancer la première app dans Xcode

Dans Xcode, créez un projet et choisissez un modèle d’application destiné à iOS. Les modèles proposent des fichiers de départ adaptés à différents usages. Pour valider l’environnement, choisissez une app simple plutôt qu’un modèle qui dépend immédiatement de services ou de bibliothèques externes. Apple décrit le parcours dans son guide pour créer un projet Xcode pour une app.

Au moment de la configuration, donnez au projet un nom compréhensible et renseignez les identifiants demandés par l’interface. L’identifiant de paquet distingue l’app ; choisissez une valeur cohérente avec le projet, particulièrement si vous comptez la partager avec une équipe. La signature peut dépendre du compte et de la destination choisie. Pour un premier essai dans un simulateur, sélectionnez une destination disponible et évitez d’introduire des réglages de distribution qui ne sont pas nécessaires au test.

Lancez la compilation depuis Xcode. Si elle réussit, démarrez l’app sur le simulateur choisi. Une fenêtre du simulateur qui s’ouvre ne suffit pas : attendez que votre application démarre et vérifiez qu’elle affiche bien l’écran attendu. Si vous utilisez un appareil réel, connectez-le, sélectionnez-le comme destination et suivez les demandes de confiance ou de signature affichées par Xcode.

Pour un projet créatif, ce premier lancement peut ensuite servir à contrôler une fonction concrète : lecture d’un son, affichage d’une image, aperçu vidéo ou mise en page sur une taille d’écran différente. Gardez toutefois l’app de validation minimale au départ. Si un projet de montage, d’audio ou de design mobilise déjà des ressources importantes, distinguez le problème de performance de l’app du problème d’installation de l’environnement.

Contrôler chaque étape avant de chercher un correctif

Cochez les vérifications dans cet ordre. Elles isolent les causes les plus courantes sans vous faire réinstaller tous les outils.

• [ ] Compatibilité : la version de macOS correspond aux exigences de la version de Xcode que vous utilisez.
• [ ] Installation : Xcode s’ouvre et ses éventuelles étapes de configuration sont terminées.
• [ ] Outils : xcode-select -p et xcodebuild -version renvoient des informations cohérentes.
• [ ] Homebrew : brew --version fonctionne dans un nouveau Terminal et les avertissements de diagnostic ont été examinés.
• [ ] Git : git --version fonctionne et les informations d’identité sont celles que vous souhaitez associer à vos commits.
• [ ] Dépendances : le projet utilise le gestionnaire indiqué par ses fichiers et sa documentation ; la résolution ne s’est pas arrêtée sur une erreur.
• [ ] Compilation : Xcode termine la construction du projet sans erreur.
• [ ] Lancement : l’app démarre dans le simulateur ou sur une destination physique configurée.

Si la compilation échoue, identifiez d’abord le premier message d’erreur pertinent, plutôt que la dernière ligne affichée. Une destination indisponible ne se corrige pas en réinstallant CocoaPods ; une dépendance non résolue ne se corrige pas en changeant les réglages de signature. Reproduisez l’erreur après avoir vérifié le maillon concerné et notez les étapes qui la déclenchent.

Si vous reprenez un dépôt existant, comparez aussi vos réglages aux instructions de l’équipe : version de Xcode attendue, gestionnaire de dépendances, fichiers de verrouillage et destination de test. Une configuration qui fonctionne pour une app neuve peut ne pas correspondre à un projet maintenu depuis longtemps. Pour une question concernant l’environnement de service, consultez le centre d’aide Hashvps ; pour vérifier les conditions générales applicables, reportez-vous aux informations de service Hashvps.

Choisir entre votre Mac et un environnement Mac à distance

Un Mac déjà disponible est souvent le choix le plus direct si vous voulez apprendre, travailler hors ligne ou connecter régulièrement un appareil physique. Il évite la dépendance à une connexion réseau, mais vous devez gérer vous-même l’espace disque, les mises à jour, les sauvegardes et les éventuelles incompatibilités entre outils.

Un environnement Mac à distance peut convenir si vous n’avez pas de Mac adapté sous la main ou si votre équipe a besoin d’un environnement de compilation séparé. Avant de vous engager, vérifiez qu’il permet les opérations réellement prévues dans ce guide : installer ou ouvrir la version de Xcode requise, accéder au simulateur, transférer le projet et récupérer les résultats. Une connexion fluctuante peut gêner les interactions graphiques, et un accès distant ne remplace pas toujours le test sur un appareil physique.

En pratique, votre Mac local devient pénible si son système ne prend plus en charge la version de Xcode exigée, si son stockage est déjà saturé ou si vous devez partager une configuration isolée avec une équipe. Dans ce cas, plutôt que d’installer des outils au hasard ou de déplacer le projet entre plusieurs configurations, vérifiez si une location de Mac chez Hashvps répond à vos besoins d’installation et de test. Les détails disponibles sont indiqués sur la page des offres Hashvps. Si vous disposez déjà d’un Mac compatible, avez besoin d’un accès matériel particulier ou effectuez des compilations lourdes de façon continue, conserver votre propre machine peut rester plus adapté.

Avant votre prochain essai, reprenez la liste de contrôle : Xcode prêt, dépendances résolues, compilation réussie et app démarrée. C’est ce résultat observable — et non le simple nombre d’outils installés — qui confirme que votre environnement iOS sur Mac est opérationnel.