Développement Web

Installer Xcode 26 et configurer son environnement Swift sur macOS

11 دقائق للقراءة

Avant d’écrire la moindre ligne de Swift, il faut un environnement de travail fonctionnel. Cette étape ressemble parfois à un détail mais elle conditionne tout le reste : un Xcode mal configuré bloque les builds, les simulateurs absents empêchent de tester, un compte Apple Developer non rattaché interdit le déploiement sur un appareil physique. Ce tutoriel détaille pas à pas l’installation de Xcode 26 sur macOS Tahoe et la préparation du compte Apple Developer, jusqu’à l’exécution d’un premier projet SwiftUI sur le simulateur iOS.

📘 Guide principal de la série : Développer une application iOS avec Swift et SwiftUI : panorama 2026. Cet article fait partie d’une suite progressive sur le démarrage iOS ; il est conseillé de parcourir le guide principal pour situer chaque tutoriel dans le parcours global.

Prérequis

  • Un Mac avec macOS Tahoe 26.2 ou supérieur (pour Xcode 26.4 et ultérieur) — un Mac à processeur Apple Silicon est fortement conseillé.
  • Au minimum 50 Go d’espace libre sur le disque système (Xcode pèse ~15 Go, chaque simulateur ajoute 5 à 10 Go).
  • Un Apple ID actif (l’identifiant utilisé sur iCloud convient).
  • Une connexion internet stable : le téléchargement initial dépasse 8 Go.
  • Niveau : aucun pré-requis Swift ; connaissance basique de macOS recommandée.
  • Temps estimé : 45 à 90 minutes selon la bande passante.

Étape 1 — Vérifier la version de macOS

Xcode 26 refuse de s’installer sur un macOS trop ancien. Avant d’engager un téléchargement de plusieurs gigaoctets, vérifier la version exacte du système évite une déception au bout d’une heure. La commande sw_vers donne l’info en une ligne dans le Terminal.

sw_vers

La sortie ressemble à ProductName: macOS / ProductVersion: 26.4 / BuildVersion: 25E456. La valeur de ProductVersion doit être au moins 26.2 pour installer Xcode 26.4 ou ultérieur. Si la version affichée est inférieure (par exemple 15.6 ou 14.x), il faut passer par Réglages Système > Général > Mise à jour de logiciel pour basculer vers macOS Tahoe. La mise à jour pèse environ 12 Go et dure 30 à 60 minutes.

Étape 2 — Télécharger Xcode depuis le Mac App Store

Apple propose deux chemins de téléchargement officiels. Le Mac App Store est le plus simple et bénéficie des mises à jour automatiques. Le portail Apple Developer permet de récupérer une version précise (utile quand un projet exige Xcode 26.3 alors que 26.5 est disponible). Pour un premier démarrage, le Mac App Store suffit.

# Ouvre le Mac App Store sur la page Xcode
open "macappstore://itunes.apple.com/app/id497799835"

Cette commande lance l’App Store directement sur la fiche Xcode. Cliquer sur le bouton « Obtenir » puis « Installer » lance le téléchargement. La barre de progression apparaît dans le Launchpad sous l’icône Xcode. Sur une connexion à 100 Mbps, comptez 12 à 18 minutes. Le téléchargement peut être mis en pause depuis le Launchpad si nécessaire ; il reprend automatiquement à la session suivante.

Étape 3 — Première ouverture et acceptation de la licence

Une fois Xcode installé, le premier lancement déclenche plusieurs étapes invisibles : acceptation de la licence Apple, installation des composants additionnels (toolchains, plateformes), enregistrement des outils en ligne de commande. L’ouvrir depuis Spotlight ou le Launchpad lance le processus.

open -a Xcode

Au premier lancement, une fenêtre demande l’acceptation de la licence Apple Developer Agreement. Cliquer sur Agree exige le mot de passe administrateur. Une seconde fenêtre propose d’installer les Additional Components : valider sans hésiter. Cette étape installe les toolchains de compilation et représente 3 à 5 Go supplémentaires. À la fin, l’écran Welcome to Xcode apparaît avec trois options : Create New Project, Open Existing Project, Clone Git Repository.

Étape 4 — Installer les simulateurs iOS nécessaires

Par défaut, Xcode 26 embarque uniquement le simulateur iOS 26 le plus récent. Pour tester sur des versions antérieures (iOS 18, iOS 17), il faut télécharger les simulator runtimes additionnels. Ces runtimes pèsent 5 à 8 Go chacun ; ne télécharger que ceux qui sont strictement utiles.

# Lister les runtimes installés
xcrun simctl list runtimes

# Télécharger une plateforme depuis la CLI (alternative à l'UI)
xcodebuild -downloadPlatform iOS

La commande xcrun simctl list runtimes affiche chaque runtime disponible avec son statut (Ready, Downloading, Not Installed). La commande xcodebuild -downloadPlatform iOS télécharge le simulateur iOS le plus récent depuis la ligne de commande, utile pour les pipelines CI. Pour l’installation interactive, ouvrir Xcode puis Settings > Components > Platforms et cocher les versions souhaitées.

Étape 5 — Créer un compte Apple Developer (option gratuite ou payante)

Pour exécuter une app sur le simulateur, aucun compte Apple Developer n’est nécessaire — l’Apple ID utilisé sur le Mac suffit. Pour la déployer sur un iPhone physique avec une validité de sept jours, le même Apple ID gratuit fonctionne via Free Provisioning. Pour publier sur l’App Store ou utiliser TestFlight, un abonnement annuel à 99 USD est requis.

L’inscription au programme payant s’effectue sur developer.apple.com/programs/enroll/. Apple demande une pièce d’identité, valide ensuite l’enrôlement sous 24 à 72 heures, et facture le compte par carte bancaire ou Apple Pay. Pour un premier projet d’apprentissage, l’option gratuite est suffisante ; passer à l’abonnement payant peut attendre la phase de distribution.

Étape 6 — Configurer le compte Apple ID dans Xcode

Xcode doit connaître au moins un Apple ID pour gérer la signature des builds. Sans cette étape, lancer une app sur un iPhone physique échoue avec un message « No signing certificate found ». La configuration se fait depuis les préférences.

# Ouvrir directement les préférences Xcode > Accounts
open -a Xcode --args -ApplePersistenceIgnoreState YES

Une fois Xcode ouvert, naviguer dans Xcode > Settings > Accounts et cliquer sur le bouton + en bas à gauche, choisir Apple ID, puis saisir l’identifiant et le mot de passe. Apple envoie un code de vérification à deux facteurs sur les autres appareils du compte ; le saisir valide l’ajout. Une fois le compte rattaché, la colonne de droite affiche les teams auxquelles l’Apple ID appartient (personnal team pour le free provisioning, ou la team payante).

Étape 7 — Créer un projet « Hello SwiftUI »

Le moment est venu de vérifier que toute la chaîne fonctionne. Un projet de démonstration vide se génère depuis le menu de bienvenue de Xcode et permet de valider rapidement la configuration.

Depuis l’écran Welcome to Xcode, cliquer sur Create New Project. Dans le sélecteur de template, choisir iOS > App puis cliquer sur Next. Renseigner les champs :

  • Product Name : HelloSwiftUI
  • Team : sélectionner le team personnel rattaché à l’Apple ID
  • Organization Identifier : com.example (ou un domaine inversé qu’on contrôle)
  • Interface : SwiftUI
  • Language : Swift
  • Storage : None
  • Include Tests : coché (utile pour la suite)

Cliquer sur Next, choisir un dossier de destination (par exemple ~/Developer), décocher Create Git repository si Git n’est pas souhaité, puis Create. Xcode ouvre le projet sur le fichier ContentView.swift qui contient une vue minimale.

Étape 8 — Lancer le projet sur le simulateur

Cette étape clôt l’installation : si le projet s’affiche sur le simulateur, l’environnement est opérationnel. La barre du haut de Xcode contient un menu déroulant qui sélectionne la destination de build.

Cliquer sur le menu à droite du nom du projet (par défaut affiche Any iOS Device ou My Mac) et choisir iPhone 16 Pro (iOS 26.5) ou n’importe quel simulateur iOS récent listé. Puis cliquer sur le bouton triangulaire Run (ou raccourci ⌘R).

Le simulateur démarre dans une nouvelle fenêtre. Le premier démarrage prend 1 à 3 minutes — le temps que iOS s’initialise dans le simulateur. Aux lancements suivants il sera quasi-instantané. Une fois l’écran d’accueil affiché, l’app HelloSwiftUI apparaît et présente le texte « Hello, world! » centré dans la vue. Si cette image apparaît, l’installation est validée.

Étape 9 — Vérifier les outils en ligne de commande

Xcode installe une suite d’outils CLI utilisés par les pipelines de build, les gestionnaires de paquets et les outils tiers. Vérifier leur présence évite des surprises au moment d’ajouter une dépendance Swift Package ou de lancer un script de build automatisé.

xcode-select -p
swift --version
swiftc --version
xcodebuild -version

La commande xcode-select -p doit retourner le chemin /Applications/Xcode.app/Contents/Developer. swift --version affiche par exemple Apple Swift version 6.3.2 (swiftlang-6.3.2.x.x clang-1700.x.x.x). Si la commande retourne « xcrun: error: invalid active developer path », exécuter sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer pour pointer la CLI vers la bonne installation.

Erreurs fréquentes au moment de l’installation

Erreur Cause Solution
« Xcode requires macOS 26.2 or later » Tentative d’installation sur macOS Sequoia ou antérieur Mettre à jour macOS depuis Réglages Système > Général > Mise à jour de logiciel
Téléchargement bloqué à 50 % puis échec Connexion instable ou App Store nécessitant une reconnexion Se déconnecter puis reconnecter à l’Apple ID dans App Store > Compte ; relancer le téléchargement
« No simulator runtime available » Aucun runtime iOS téléchargé en plus de Xcode Settings > Components > Platforms > bouton Get à côté de iOS 26.x
« Cannot find Developer Disk Image » iPhone connecté tourne une iOS plus récent que la version Xcode supporte Mettre à jour Xcode vers la dernière version stable
« Could not launch HelloSwiftUI » sur simulateur Cache de build corrompu Menu Product > Clean Build Folder (⇧⌘K) puis relancer
« This Mac is not registered with this Apple Developer team » Premier déploiement sur appareil sans free provisioning configuré Settings > Accounts > Manage Certificates > ajouter un Apple Development certificate
« unable to verify app » Sur iPhone physique avec free provisioning, le profil doit être approuvé manuellement Sur l’iPhone, Réglages > Général > Gestion des appareils et VPN > faire confiance au certificat

Foire aux questions

Combien d’espace disque Xcode 26 consomme-t-il vraiment ?

L’app Xcode pèse environ 15 Go après installation. Chaque simulator runtime ajoute 5 à 10 Go. Les Derived Data (caches de build) grossissent rapidement et peuvent dépasser 20 Go sur un projet actif. Un total réaliste à prévoir est 50 à 80 Go pour un usage régulier.

Faut-il payer 99 USD pour apprendre Swift ?

Non. Le simulateur iOS et le free provisioning suffisent largement pour apprendre, prototyper et même montrer son app à des amis (en l’installant sur leur appareil pour sept jours). L’abonnement payant devient utile au moment de distribuer via TestFlight ou de publier sur l’App Store.

Puis-je installer plusieurs versions de Xcode côte à côte ?

Oui. Renommer une version installée en Xcode-26.3.app avant d’installer une nouvelle permet de garder les deux dans le dossier Applications. La commande xcode-select --switch /Applications/Xcode-26.3.app/Contents/Developer bascule entre versions pour les builds CLI. C’est utile pour maintenir un projet qui n’a pas encore migré vers la dernière Xcode.

L’installation a échoué et l’App Store ne propose plus le bouton « Installer »

Aller dans le Launchpad, repérer l’icône Xcode (souvent grise et étiquetée « En attente »), faire un clic long puis cliquer sur la croix pour annuler. Retourner sur la fiche App Store, le bouton réapparaît. Si ce n’est pas le cas, redémarrer le Mac résout généralement le blocage.

Le simulateur est très lent au premier démarrage, est-ce normal ?

Oui. iOS s’initialise dans le simulateur (premier boot, indexation Spotlight, services système). Ce premier démarrage prend 2 à 4 minutes. Les démarrages suivants sont quasi-instantanés grâce au snapshot de boot.

Mon projet ne compile plus après une mise à jour Xcode

C’est fréquent à chaque saut majeur (par exemple Xcode 26.3 → 26.4). Trois actions résolvent 90 % des cas : Clean Build Folder avec ⇧⌘K ; supprimer le dossier ~/Library/Developer/Xcode/DerivedData ; vérifier la version Swift exigée par le projet dans Build Settings > Swift Language Version.

Quelle différence entre Apple ID et Apple Developer Account ?

L’Apple ID est l’identifiant général (iCloud, App Store, achats). L’Apple Developer Account est un rôle additionnel attaché à un Apple ID qui ouvre l’accès aux ressources développeur (téléchargements, beta SDK, App Store Connect). On peut être Apple ID sans être développeur ; on ne peut pas être développeur sans Apple ID.

Tutoriels suivants conseillés

Une fois l’environnement opérationnel, deux directions s’ouvrent : se familiariser avec le langage avant d’attaquer l’interface, ou commencer immédiatement par SwiftUI.

Ressources officielles

Service ITSkillsCenter

Site ou application web sur mesure

Conception Pro + Nom de domaine 1 an + Hébergement 1 an + Formation + Support 6 mois. Accès et code livrés. À partir de 350 000 FCFA.

Demander un devis
Publicité