Comment installer hors ligne le runtime du simulateur Xcode 27.2 RC ? Guide 2026

Le journal de publication Apple répertorie Xcode 27.2 RC. Pour une installation hors ligne, téléchargez le runtime du simulateur avec la procédure xcodebuild documentée, transférez le paquet vers le Mac cible, puis vérifiez sa disponibilité avec le Xcode sélectionné et un test réel du projet. Une importation réussie ne signifie pas, à elle seule, que la CI est prête.

Cet article s’adresse aux ingénieurs CI qui entretiennent des agents macOS soumis à des restrictions réseau, aux équipes qui gèrent plusieurs Mac de construction et aux développeurs qui exécutent des tests de simulateur sur un Mac distant. Nous distinguons le transfert du paquet, son importation et son acceptation par le projet : ces opérations répondent à des problèmes différents.

Dernière mise à jour : 29 octobre 2026. Les informations sur Xcode et la procédure d’installation ont été vérifiées dans les publications Apple consacrées à Xcode, les notes de version et la documentation des composants. Les plateformes réellement téléchargeables et leur compatibilité doivent être confirmées au moment de l’intervention.

Le diagnostic avant le téléchargement hors ligne

Un téléchargement différé n’est utile que si le blocage concerne l’accès au runtime. Avant de préparer un paquet, identifiez lequel de ces cas décrit la situation :

• Le runtime est absent du Mac : il faut le télécharger ou l’importer.
• Le téléchargement échoue à cause des règles réseau du Mac cible : un transfert depuis un Mac autorisé peut contourner ce blocage d’accès, mais ne dispense pas d’importer le runtime sur la machine cible.
• Le runtime semble présent, mais le projet ne s’exécute pas : il faut vérifier le Xcode sélectionné, l’appareil simulé, les réglages du projet et le résultat des tests.

Commencez par relever la version du Xcode que le travail CI doit réellement utiliser. Les notes de version de Xcode 27.2 RC et les exigences système publiées par Apple sont les références à consulter pour établir si cette version et le Mac cible forment une combinaison prise en charge. Si la version de Xcode prévue ne convient pas, télécharger un runtime supplémentaire ne corrigera pas le problème initial.

Il est également important de ne pas confondre trois éléments. Le SDK fournit les éléments nécessaires à la compilation pour une plateforme. Le runtime permet au système simulé de démarrer. L’appareil simulé représente la cible choisie pour exécuter l’application. La présence d’un fichier sur le disque ne prouve donc ni que le runtime est reconnu par le Xcode choisi ni qu’un appareil adapté aux tests est disponible.

Pour approfondir les conditions d’une validation sur Mac distant, vous pouvez consulter nos guides d’utilisation d’un environnement Mac. Pour l’installation en cours, gardez toutefois une règle simple : vérifiez d’abord la version de Xcode, puis décidez si le paquet hors ligne traite bien la cause observée.

Préparer le téléchargement avec xcodebuild

Apple documente le téléchargement et l’importation de composants supplémentaires au moyen de xcodebuild. La disponibilité d’une plateforme ou d’une version donnée peut évoluer : ne présumez pas qu’un runtime précis apparaît dans tous les environnements. Confirmez les options et les plateformes offertes par la commande sur le Mac connecté, puis recoupez-les avec la documentation Apple sur le téléchargement et l’installation de composants Xcode.

Le principe opérationnel est de demander le téléchargement de la plateforme voulue et de choisir un chemin d’exportation local. La forme générale de la commande est :

xcodebuild -downloadPlatform iOS -exportPath /chemin/vers/les-composants

Cette commande illustre la procédure, mais ne garantit ni que chaque révision de runtime sera proposée ni que le téléchargement aboutira dans un réseau donné. Vérifiez les options prises en charge à l’aide de xcodebuild -help et de la référence Apple des commandes Xcode. Si la plateforme ou une option de sélection de version n’est pas proposée, arrêtez-vous et vérifiez les instructions en vigueur plutôt que d’inventer un paramètre.

Avant le transfert, contrôlez le résultat de la commande, l’emplacement où elle a exporté le composant et l’intégrité du fichier selon les règles de votre organisation. Consignez la provenance, la version de Xcode utilisée pour préparer le téléchargement et la plateforme demandée. Cette trace aide à différencier un fichier incomplet d’un problème d’importation et évite qu’un paquet non vérifié soit distribué aux agents CI.

Le transfert lui-même ne rend pas le runtime utilisable. Il déplace les données vers un emplacement accessible au Mac cible ; l’installation reste à effectuer sur ce Mac avec le Xcode auquel le runtime doit être associé. Pour une équipe qui maintient plusieurs machines, la préparation centralisée peut éviter de répéter les téléchargements lorsque le réseau des agents est limité. Elle ne crée pas pour autant un cache universel compatible avec toutes les versions de Xcode.

Importer sur le Mac cible et vérifier l’association

Sur le Mac isolé, sélectionnez d’abord le Xcode destiné au travail concerné. Contrôlez le chemin de l’outil actif et sa version avant l’importation. Une commande lancée dans un terminal peut utiliser un Xcode différent de celui prévu par l’agent CI ; cette divergence suffit à rendre trompeuse une vérification effectuée dans une autre session ou sous un autre compte.

Lorsque le paquet est accessible, suivez la procédure d’importation indiquée par Apple pour le composant téléchargé. La forme générale de l’importation en ligne de commande est :

xcodebuild -importPlatform /chemin/vers/le/composant

Le chemin exact dépend du résultat exporté. Ne le remplacez pas par un chemin supposé et ne lancez pas l’importation avant d’avoir identifié le paquet fourni par le téléchargement. La documentation Apple sur les composants Xcode additionnels décrit la procédure à utiliser ; l’aide de la commande sur le Mac cible permet de confirmer que les options correspondent à la version de Xcode sélectionnée.

Une fois l’importation terminée, inspectez les runtimes connus du simulateur, par exemple avec :

xcrun simctl list runtimes

Puis examinez les appareils simulés disponibles et assurez-vous que la cible choisie convient à l’application. La documentation Apple sur l’ajout de simulateurs aide à distinguer la disponibilité d’un runtime de celle des appareils associés. Enfin, faites construire ou tester l’application selon le flux de travail habituel. Apple décrit les principes d’exécution d’une app sur un appareil simulé ou physique dans son guide d’exécution sur simulateur ou appareil.

Un runtime visible dans la liste est une vérification nécessaire, pas une preuve que tous les tests fonctionneront. Le lancement d’un appareil cible, la compilation du projet et l’exécution du test doivent être contrôlés séparément.

Déploiement selon les responsabilités de l’équipe

Pour un développeur indépendant, l’objectif est de lever un blocage précis sans transformer l’installation hors ligne en détour inutile. Si le runtime est déjà reconnu et que l’échec survient pendant la compilation, examinez d’abord le projet et sa destination de test. Si le runtime manque et que le Mac ne peut pas le télécharger, préparez le paquet sur un Mac autorisé, puis réalisez l’importation et le test sur la machine qui exécutera le travail.

Pour un ingénieur CI, l’acceptation doit se faire dans le contexte de l’agent réel, et non dans une session graphique différente. Vérifiez le Xcode sélectionné par le processus CI, les runtimes que ce processus peut énumérer et l’appareil demandé par la tâche. Exécutez ensuite une construction ou un test du projet. Si une vérification manuelle réussit mais que l’agent échoue, comparez les chemins d’outils, le compte de service, les droits d’accès au paquet et les journaux de commande avant de réimporter.

Pour l’équipe qui entretient plusieurs Mac, traitez le paquet comme un composant versionné et traçable, pas comme un cache commun présumé. Distribuez-le aux machines concernées selon les règles internes, importez-le sur chacune, puis enregistrez le résultat propre à chacune. Un succès sur un Mac ne prouve pas que les autres ont la même sélection de Xcode, les mêmes autorisations ou le même état des appareils simulés.

Enfin, lorsqu’une équipe conserve plusieurs versions de Xcode, établissez explicitement laquelle doit être active pendant chaque opération. Apple publie les exigences système et les notes de version ; confrontez-les au résultat observé sur l’hôte. Si une combinaison n’est ni documentée ni reconnue par la commande, ne la déclarez pas compatible en vous fondant uniquement sur la présence des fichiers.

Liste de contrôle d’acceptation

Avant d’intégrer le Mac dans le flux de construction, cochez les vérifications qui ont effectivement été réalisées sur l’hôte cible :

• [ ] La version de Xcode prévue pour le projet est sélectionnée et son chemin est consigné.
• [ ] Le téléchargement provient d’une procédure Apple documentée et la commande s’est achevée sans erreur.
• [ ] Le paquet transféré a une provenance vérifiable et son accès est limité selon les règles de l’équipe.
• [ ] L’importation a été effectuée sur le Mac cible avec le Xcode prévu.
• [ ] La liste des runtimes affiche la plateforme attendue dans le contexte de l’agent concerné.
• [ ] Un appareil simulé adapté au projet est disponible.
• [ ] Une compilation ou un test du projet a abouti sur cet agent.
• [ ] Les journaux de téléchargement, d’importation et de test sont conservés pour faciliter un diagnostic ultérieur.

Si un point échoue, isolez la couche concernée avant de recommencer : paquet absent ou incomplet, outil Xcode inattendu, runtime non reconnu, appareil indisponible ou erreur propre au projet. Cette séparation évite de répéter un téléchargement lorsque le défaut vient d’une sélection d’outil ou d’une cible de test.

Choisir la méthode adaptée au contexte

Cette comparaison ne promet pas qu’un même téléchargement fonctionnera avec toutes les installations. Elle indique quelle voie examiner selon la contrainte réelle et quel résultat doit autoriser la mise en service.

Questions fréquentes sur l’installation hors ligne

Téléchargement du runtime iOS

Sur le Mac connecté, sélectionnez le Xcode destiné au téléchargement et consultez xcodebuild -help pour confirmer les options présentes. Utilisez la procédure Apple de téléchargement de plateforme avec un chemin d’exportation local, puis vérifiez le résultat avant de déplacer le paquet. La disponibilité effective dépend des composants proposés par Apple et doit être contrôlée au moment de l’opération.

Importation sur un Mac sans réseau

Transférez le composant vérifié vers un emplacement autorisé sur le Mac cible. Sélectionnez le Xcode attendu, puis utilisez la procédure xcodebuild d’importation décrite par Apple. Après l’importation, énumérez les runtimes et les appareils disponibles sur cette machine. Terminez par une compilation ou un test réel : la seule présence des fichiers ne valide pas le parcours CI.

Réutilisation avec plusieurs versions de Xcode

Ne considérez pas le paquet comme un composant universel. Vérifiez les notes de version et les exigences système des versions de Xcode concernées, puis observez si le runtime est reconnu lorsque chaque version prévue est sélectionnée. Si une association n’est pas documentée ou n’apparaît pas dans l’énumération, ne la mettez pas en production sans validation par le projet.

Vérification de l’aptitude à la CI

L’agent doit sélectionner le Xcode attendu, reconnaître le runtime et proposer l’appareil de test choisi par le projet. Faites ensuite exécuter une construction ou le test représentatif dans le contexte réel de la CI. Conservez les sorties des commandes et les journaux : ils permettent de séparer un défaut de composant d’une erreur de compilation, de configuration ou de test.

Pour une CI à réseau restreint, le téléchargement préalable suivi d’une importation contrôlée peut être plus adapté que de laisser chaque agent récupérer ses composants séparément. Cela implique néanmoins du travail de transfert, de suivi des versions et de validation sur les hôtes ; les restrictions réseau, les différences de sélection Xcode et les erreurs d’accès ne disparaissent pas à l’importation. Si le projet doit exécuter régulièrement des tests sur une machine macOS accessible à distance, vous pouvez examiner les modalités d’accès à un Mac distant et comparer cette option à l’entretien de votre propre hôte. Une location peut convenir à un besoin temporaire ou à un environnement de test ; pour une charge lourde, durable ou dépendante d’interfaces physiques, un Mac dédié reste à évaluer. Avant tout déploiement, gardez la même exigence : runtime reconnu, appareil disponible et test du projet accepté.

Questions fréquentes