Dans la documentation Apple, le panneau Components sert à gérer les composants optionnels de Xcode, dont les environnements d’exécution du simulateur (instructions Apple). Cette distinction donne le premier geste utile : repérez si le blocage survient pendant le téléchargement, l’installation ou la reconnaissance du runtime, puis intervenez uniquement sur cette étape. Ne supprimez pas d’abord des dossiers système et ne réinstallez pas Xcode sans avoir relevé les éléments qui permettront d’identifier la cause.
Repères de la semaine : commencez par noter le Xcode actif, le chemin de ses outils et le message exact. Vérifiez ensuite le statut du runtime dans Components ; si le problème ne concerne que le Mac distant, effectuez ces contrôles sur la machine qui exécute réellement le projet.
Ce guide s’adresse aux développeurs indépendants qui ne peuvent pas lancer leur projet faute de runtime iOS 27 disponible. Il aide aussi les petites équipes qui exécutent des tests sur un Mac distant ou dans une chaîne d’intégration continue, ainsi que celles qui voient encore une liste de simulateurs vide après avoir changé de version de Xcode.
SECTION 01 Quelle étape est réellement en échec ?
Un téléchargement interrompu, une installation inachevée et un runtime installé mais absent des destinations de lancement ne désignent pas le même problème. Avant de relancer quoi que ce soit, consignez le texte complet de l’erreur, l’état affiché dans Components, le Xcode ouvert et le chemin des outils de développement sélectionnés.
Dans Terminal, ces commandes donnent un premier état sans modifier l’installation :
xcodebuild -version
xcode-select -p
xcrun simctl list runtimes
xcodebuild -version indique la version et la compilation de l’outil accessible par la ligne de commande ; xcode-select -p montre le répertoire de développement actif. La commande simctl interroge les environnements et appareils connus de l’outil sélectionné. Pour vérifier l’usage et les options des outils Apple, appuyez-vous sur la référence officielle des outils en ligne de commande Xcode.
| Point de contrôle | Indice à relever | Action suivante | Arrêtez-vous si… |
|---|---|---|---|
| Téléchargement | Composant absent, en cours, interrompu ou signalé en échec | Vérifier l’état dans Components et la disponibilité proposée par ce Xcode | L’interface indique toujours un téléchargement actif |
| Installation | Téléchargement terminé, mais installation en échec ou état incomplet | Conserver le message, puis examiner l’outil et le répertoire de développement actifs | Vous ne savez pas quel Xcode a lancé l’installation |
| Reconnaissance | Runtime présent, mais destination absente dans Xcode ou simctl |
Comparer le Xcode actif, le schéma et la liste de destinations | Le projet n’a pas de schéma iOS valide |
Cette lecture évite une confusion fréquente : l’environnement d’exécution, l’appareil simulé et la destination de lancement sont des éléments distincts. L’environnement fournit le système simulé ; l’appareil représente une configuration de simulateur ; la destination est le choix proposé pour lancer le projet. Une absence à ce dernier niveau ne prouve donc pas, à elle seule, que la compilation du code a échoué.
SECTION 02 Le téléchargement n’avance pas dans Xcode 27
Si le runtime n’apparaît pas ou si le téléchargement est indiqué comme interrompu, commencez dans Xcode > Settings > Components. Vérifiez que vous regardez la plateforme attendue et que le composant est proposé par l’installation de Xcode que vous utilisez. Apple décrit la gestion des composants facultatifs dans sa documentation sur le téléchargement et l’installation des composants Xcode.
L’intitulé et les versions proposées dépendent de Xcode et de la documentation en vigueur : ne déduisez pas qu’un runtime donné est disponible simplement parce que votre projet cible iOS 27. Consultez les exigences système et informations de compatibilité publiées par Apple, puis confrontez-les à ce que votre installation affiche réellement. Si Components ne propose pas le runtime attendu, arrêtez les tentatives de téléchargement et vérifiez d’abord la prise en charge de votre version de Xcode.
Pour un téléchargement en ligne de commande, utilisez uniquement les options qu’Apple documente pour votre version de Xcode. La documentation des composants présente aussi une voie avec xcodebuild pour télécharger une plateforme ; consultez-la avant de lancer la commande, au lieu de reprendre une syntaxe trouvée pour une autre version. Selon le contexte, cette méthode est utile lorsqu’une installation doit être faite sans passer par l’interface graphique ou lorsque vous devez diagnostiquer l’accès aux composants depuis un environnement de construction.
Un téléchargement toujours actif n’est pas nécessairement bloqué. Regardez son état dans Components et laissez l’opération se terminer si l’interface l’indique comme en cours. Si elle signale un échec, notez le message avant de réessayer. Un second essai a du sens lorsque le premier s’est arrêté ou a échoué ; il ne constitue pas une solution démontrée lorsque Xcode ne propose pas le composant ou que le compte rendu signale une erreur d’installation.
Pour que le contrôle soit utile, gardez ensemble le message original, l’heure approximative de l’échec et la version de Xcode relevée. Sans ces éléments, une nouvelle tentative peut effacer l’indice le plus parlant : l’endroit précis où l’opération a cessé de progresser.
Comment confirmer quel runtime la commande en ligne de commande voit-elle ?
La sortie de xcrun simctl list runtimes vous indique les runtimes reconnus par l’outillage actif ; elle ne prouve pas que chaque Xcode installé sur la machine les reconnaît tous. Comparez cette sortie avec xcode-select -p et l’installation ouverte dans l’interface. Pour connaître la liste des environnements iOS disponibles pour un projet précis, la référence de xcodebuild documente aussi les commandes permettant d’inspecter les destinations d’un schéma ; leurs résultats dépendent du projet et de l’installation sélectionnée (référence des outils Xcode).
SECTION 03 L’installation échoue après le téléchargement
Quand le téléchargement semble terminé, mais que l’installation ne l’est pas, séparez les indices. Un composant téléchargé peut ne pas avoir été installé correctement ; l’installation peut avoir échoué avant sa finalisation ; ou la vérification peut porter sur un autre Xcode que celui qui a réalisé l’opération. Le message affiché et le chemin renvoyé par xcode-select -p vous aident à différencier ces cas.
Avant de relancer l’installation, conservez le message complet et, si vous en avez, les journaux de l’opération. Notez également si Components indique le composant comme disponible, en cours ou en échec. Ne considérez pas un fichier téléchargé comme une preuve que le runtime est prêt : la vérification décisive est qu’il soit reconnu par le Xcode attendu et qu’une destination de simulateur soit proposée pour le projet.
Si le Xcode actif n’est pas celui qui doit servir au projet, commencez par identifier le bon répertoire dans Xcode et confrontez-le à la sortie de xcode-select -p. Apple explique comment choisir les outils en ligne de commande avec les réglages des outils de développement. Un changement de sélection affecte les commandes de développement qui s’appuient sur ces outils : consignez la sélection initiale et ne la modifiez que si vous avez établi qu’elle ne correspond pas à l’installation visée.
Avant de supprimer un runtime ou de toucher aux répertoires de données de Xcode, sauvegardez les messages et les journaux accessibles, puis vérifiez la portée de l’action dans la documentation Apple. Si vous ne pouvez pas confirmer quel composant sera supprimé ni comment revenir à l’état précédent, arrêtez-vous et demandez au responsable de l’environnement.
Évitez de supprimer des actifs système au hasard ou d’effacer des caches comme première mesure. Ces opérations peuvent toucher plusieurs projets ou installations, et leur effet n’est pas équivalent à un nouvel essai depuis Components. De même, ne réinstallez pas tout Xcode tant qu’une sélection de mauvais répertoire, une compatibilité non établie ou une installation simplement inachevée restent des hypothèses plausibles.
SECTION 04 Le runtime est là, mais aucun appareil n’est proposé
Si la commande de consultation des runtimes affiche un environnement iOS, mais que Xcode ne propose aucune destination, vérifiez le projet plutôt que de recommencer immédiatement le téléchargement. Confirmez que le schéma actif concerne bien une application iOS, que le projet est ouvert dans l’installation attendue et que le runtime est associé aux outils sélectionnés. Une configuration macOS ou une destination incompatible ne produira pas la liste que vous attendez pour un lancement iOS.
Dans Xcode, regardez le menu des destinations de lancement pour le schéma concerné. Comparez ce résultat à celui de simctl, puis, lorsque le projet et le schéma sont connus, interrogez les destinations prises en charge par xcodebuild. Apple décrit le parcours de lancement sur simulateur ou appareil dans son guide pour exécuter une application sur des appareils simulés ou physiques. Il explique également la gestion des appareils simulés dans sa page consacrée à l’ajout de simulateurs.
Si les outils en ligne de commande voient le runtime mais que la liste Xcode ne le propose pas, consignez le schéma, le Xcode ouvert et le chemin des outils avant de modifier quoi que ce soit. Si aucune des deux interfaces ne le voit, revenez au diagnostic d’installation : le projet ne peut pas sélectionner un runtime qui n’est pas reconnu par le Xcode actif. Dans les deux cas, l’absence d’une destination de lancement n’est pas une preuve d’échec de compilation. Examinez séparément le résultat de construction et la disponibilité de la destination.
Pourquoi le runtime installé ne crée-t-il pas automatiquement un appareil utilisable ?
La présence d’un environnement ne garantit pas qu’un appareil correspondant soit déjà créé ou proposé dans le menu du projet. Vérifiez d’abord les appareils simulés connus, puis le choix du schéma et la plateforme ciblée. Si le besoin est de créer ou de gérer un simulateur, suivez les indications Apple sur les appareils simulés ; ne supprimez pas un runtime pour corriger une simple absence de destination.
SECTION 05 Le Mac distant ou le CI utilise un autre Xcode
Un contrôle effectué sur l’ordinateur depuis lequel vous ouvrez une connexion à distance ne décrit pas l’environnement qui construit l’application. Les commandes doivent être exécutées sur le Mac qui exécute effectivement Xcode, xcodebuild ou les tests. À défaut, vous risquez de confirmer la présence du runtime sur votre poste alors que le Mac distant ou l’agent d’intégration utilise un autre Xcode.
Sur la machine d’exécution, relevez xcodebuild -version, xcode-select -p et la sortie de xcrun simctl list runtimes. Comparez ces informations avec le Xcode demandé par le projet et les destinations proposées par son schéma. Un fichier de configuration ou un script peut sélectionner un autre chemin que celui choisi dans l’interface ; vérifiez donc aussi la commande réellement lancée par la tâche de construction.
Pour une équipe, conservez ces éléments dans le compte rendu d’échec avec le nom du schéma et l’étape de la chaîne qui échoue. L’administrateur de l’environnement doit intervenir si le runtime est absent de l’hôte, si le Xcode attendu n’est pas sélectionné ou si le téléchargement de composants est administré hors du compte de l’équipe. Le développeur du projet peut agir sur le schéma ou la destination si les runtimes sont bien disponibles sur cet hôte.
Sur un Mac distant, le diagnostic dépend aussi de l’accès que vous avez au système d’exécution : l’écran de la machine ne remplace pas une vérification du terminal sur l’hôte. Si vous n’avez pas les droits nécessaires pour consulter les outils ou les journaux, transmettez les commandes attendues et leurs résultats manquants à la personne qui administre le Mac, sans tenter de contourner les restrictions du compte.
SECTION 06 Validation avant de reprendre les tests
Une fois le runtime reconnu, validez la chaîne complète plutôt que de vous fier à la seule disparition du message d’erreur. La liste des runtimes doit montrer celui qui est attendu dans le Xcode sélectionné ; le projet doit proposer une destination iOS compatible ; enfin, un lancement doit aboutir sur le simulateur choisi. Apple distingue l’exécution sur simulateur de celle sur appareil physique dans son guide consacré aux appareils simulés ou physiques.
- [ ] La version de Xcode et le chemin des outils actifs correspondent à l’environnement prévu.
- [ ] Le statut dans Components ne signale plus un téléchargement ou une installation en échec.
- [ ] Le runtime attendu apparaît dans la sortie de
xcrun simctl list runtimes. - [ ] Le schéma iOS affiche une destination de simulateur adaptée au projet.
- [ ] La construction aboutit et l’application démarre sur cette destination.
- [ ] Si l’échec survient en CI ou à distance, les mêmes contrôles ont été faits sur l’hôte qui exécute réellement les tests.
Si la construction réussit mais que l’application ne démarre pas, passez au diagnostic d’exécution du projet ; ne reprenez pas le téléchargement du runtime sans nouvel indice. Si le runtime est listé mais que l’appareil ne figure pas parmi les destinations, poursuivez du côté du schéma et des appareils simulés. Enfin, une validation sur simulateur ne remplace pas un essai sur iPhone réel : les fonctions dépendantes du matériel, des capteurs, des périphériques ou des conditions de réseau doivent être vérifiées séparément.
Sur un poste personnel, les limites peuvent être le manque d’espace pour les outils et les simulateurs, l’indisponibilité de la machine lorsque vous êtes hors ligne ou l’absence de macOS sur votre environnement habituel ; Apple publie les exigences de Xcode pour vérifier la compatibilité du système hôte (exigences système de Xcode). Si vos tests doivent s’exécuter sur une machine macOS distincte, vous pouvez comparer cette approche à un Mac distant. VPSNIX propose la location d’un Mac accessible à distance ; consultez la présentation des environnements Mac et les offres et modalités tarifaires pour vérifier si cette formule répond à votre besoin. Elle n’est pas forcément adaptée à une charge lourde et permanente, ni à un test nécessitant un branchement physique local : dans ces cas, un Mac acheté et maintenu sur place peut être plus cohérent.