dSYM manquant dans Xcode 27.2 RC : liste de contrôle 2026

Vous recevez un rapport de plantage dont la pile d’appels affiche des adresses ou des noms incomplets, alors que l’app a été distribuée.

Pour un dSYM manquant dans Xcode 27.2 RC, retrouvez d’abord l’Archive de la version concernée, puis comparez l’UUID du binaire avec celui du dSYM. Si les UUID ne correspondent pas, n’utilisez ni les symboles d’une autre version ni ceux d’une nouvelle compilation : si l’Archive d’origine a disparu et qu’aucun symbole correspondant n’est conservé, la symbolisation de cet ancien binaire peut être impossible.

Cet article s’adresse à vous si vous développez seul et devez interpréter un rapport reçu après une distribution par App Store ou TestFlight.
Il concerne aussi les responsables d’une petite équipe qui doivent vérifier le lien entre chaque Archive et ses symboles.
Il est également destiné aux personnes qui administrent un Mac distant ou une chaîne d’intégration et doivent retrouver les fichiers remis après compilation.

Dernière vérification le 1er novembre 2026, à partir de la liste des versions publiée par Apple et de la documentation Apple liée dans cet article. Apple y indique que Xcode 27.2 est disponible en version RC depuis le 19 octobre 2026. Cela ne démontre pas l’existence d’une panne générale des dSYM dans cette version. Traitez donc votre incident comme un problème de correspondance ou de conservation des fichiers tant que des éléments vérifiables ne montrent pas le contraire.

01 Identifier le symptôme avant de chercher un fichier

Un rapport dont les appels apparaissent sous forme d’adresses ne prouve pas, à lui seul, que le dSYM est absent. La symbolisation dépend du binaire concerné, de son UUID et du fichier de symboles approprié. Le rapport de plantage contient des informations permettant d’identifier les images binaires et leurs UUID ; consultez la documentation Apple sur le format JSON des rapports de plantage avant de conclure à une défaillance de Xcode.

Commencez par ouvrir le rapport et relever l’identité de l’app, sa version, le numéro de compilation, le modèle d’appareil et le moment du plantage. Ces éléments servent à retrouver la distribution en cause. Un nom de fichier semblable ou une version affichée dans une interface ne suffit pas à établir une correspondance de symboles.

Distinguez ensuite les situations observées :

  • La pile affiche des adresses à la place des noms de fonctions. Le rapport peut ne pas avoir été symbolisé, ou le symbole correspondant à l’image concernée peut manquer.
  • Xcode signale un fichier de symboles manquant. Cette indication désigne un fichier attendu pour une image ; elle ne dit pas, à elle seule, si le fichier a été supprimé, mal archivé ou remplacé par un fichier d’une autre compilation.
  • Une partie seulement de la pile reste illisible. Les cadres non symbolisés peuvent provenir d’une extension, d’un framework système ou d’une dépendance tierce, alors que le code principal de l’app est correctement interprété.

Où retrouver le dSYM produit par Xcode 27.2 RC ? Commencez par l’Archive qui correspond à la compilation distribuée. Dans l’organiseur de Xcode, recherchez l’Archive de l’app concernée, puis examinez son contenu et le dossier consacré aux dSYM. La documentation Apple décrit la création d’Archives contenant les binaires et les informations de débogage ; le guide sur la génération des informations de débogage précise le rôle des paramètres de compilation associés.

Le chemin exact dépend de l’emplacement où votre équipe a enregistré l’Archive. Si vous ne la voyez pas dans l’organiseur, recherchez les fichiers d’Archive dans les emplacements de travail et de sauvegarde réellement utilisés par votre projet, puis vérifiez les sauvegardes ou les livraisons de compilation. Ne vous contentez pas d’un répertoire de symboles isolé : le but est de retrouver le fichier associé à la compilation distribuée, avec ses binaires et ses métadonnées.

Dans le contenu de l’Archive, vérifiez le dSYM de l’application principale, mais aussi ceux des extensions intégrées et des frameworks que vous avez produits. Un plantage dans une extension peut réclamer ses propres symboles ; le dSYM de l’application principale ne résout pas automatiquement ce cas.

02 Faire correspondre les UUID avant toute symbolisation

Un dSYM n’est pas interchangeable avec un fichier portant le même nom. Le critère de contrôle est l’UUID associé au binaire concerné. Apple explique que les informations de débogage doivent correspondre à l’exécutable compilé ; sa page sur la localisation d’un fichier de symboles manquant décrit la recherche des symboles et la vérification de leur correspondance.

Repérez l’image binaire liée aux cadres encore illisibles dans le rapport. Dans un rapport JSON, examinez les informations d’image et son UUID ; les formats lisibles par l’humain présentent également des données d’identification des binaires. La documentation Apple sur les noms de symboles dans un rapport de plantage explique comment les symboles identifiables permettent d’interpréter les appels.

Vous pouvez comparer les UUID du binaire et du dSYM avec les outils disponibles dans votre environnement de développement, notamment la commande dwarfdump --uuid appliquée au fichier concerné. Vérifiez le résultat pour chaque architecture présente, puis comparez-le avec l’UUID du binaire indiqué dans le rapport. Une similitude de nom de produit, de version commerciale ou de date ne remplace pas cette vérification.

Que faire si l’UUID du dSYM ne correspond pas à celui du rapport ? Arrêtez d’essayer ce fichier. Revenez à l’Archive de la compilation distribuée et recherchez le dSYM correspondant à l’image précise qui pose problème. Si l’UUID reste différent, le candidat n’est pas le symbole recherché, même si son nom semble juste.

Une recompilation peut produire une nouvelle Archive et de nouveaux dSYM, mais elle ne recrée pas automatiquement les symboles correspondant à un binaire déjà distribué. Les paramètres, le code et les dépendances doivent produire le même binaire pour que les UUID concordent ; une compilation ultérieure ne remplace donc pas les informations de débogage perdues d’une ancienne version. La règle opérationnelle est simple : conservez ensemble l’Archive, les dSYM et l’identifiant de la compilation remise.

Est-il encore possible de symboliser un ancien plantage sans l’Archive correspondante ? Cela dépend de ce qui a été conservé. Si vous retrouvez un dSYM dont l’UUID correspond au binaire du rapport, vous pouvez encore disposer du fichier nécessaire même si l’Archive complète a été supprimée. Si l’Archive et le dSYM correspondant ont tous deux disparu, et qu’aucune copie de sauvegarde n’existe, une nouvelle compilation ne constitue pas une méthode de récupération fiable.

03 Séparer les symboles de l’app, du système et des dépendances

Quand seule une partie du rapport reste illisible, attribuez d’abord les cadres concernés à leur image binaire. Ne concluez pas qu’une absence de symboles pour un composant implique que tous les symboles de la distribution sont défectueux.

  • Pour le code de l’app principale ou d’une extension, vérifiez le dSYM de la cible correspondante dans l’Archive d’origine.
  • Pour un framework système, vérifiez que l’environnement de symbolisation dispose des symboles d’appareil adaptés au système concerné. Les fichiers de l’app ne remplacent pas les symboles du système.
  • Pour une dépendance intégrée, vérifiez si le fournisseur fournit un dSYM et si celui-ci correspond au binaire inclus dans votre distribution. Le nom du framework ne prouve pas que son fichier de symboles est le bon.
  • Pour un composant dont vous ne contrôlez pas la compilation, consignez l’image et l’UUID, puis demandez le symbole correspondant au fournisseur plutôt que de substituer un fichier d’une version voisine.

Cette séparation évite une recherche sans fin dans les Archives de l’application lorsque le cadre non symbolisé appartient en réalité à une dépendance. Elle aide aussi à formuler une demande exploitable : transmettez le nom de l’image, l’UUID observé et la version distribuée, sans présenter un fichier simplement similaire comme une preuve de correspondance.

04 Distinguer l’Archive locale des informations de distribution

La présence d’une compilation dans App Store Connect ne signifie pas que votre équipe possède encore l’Archive locale complète. La plateforme permet de consulter des informations sur les compilations et leurs métadonnées, mais cette visibilité n’est pas équivalente à la conservation du paquet original et de tous les dSYM sur votre poste ou dans votre stockage de compilation. Consultez la documentation Apple sur la consultation des compilations et de leurs métadonnées dans App Store Connect pour vérifier ce que l’interface permet de retrouver.

Pour une app distribuée, examinez les informations de compilation dans App Store Connect afin de confirmer quelle version a été remise et de rapprocher les références de distribution de vos enregistrements internes. Puis vérifiez séparément l’Archive conservée par votre équipe et les fichiers de symboles associés. Une compilation visible dans la plateforme ne prouve pas, à elle seule, que le dSYM requis est disponible localement ni que le fichier retrouvé a le bon UUID.

La comparaison suivante vous aide à choisir la prochaine action, plutôt qu’à répéter la symbolisation avec des fichiers non vérifiés.

Situation constatée Vérification décisive Action adaptée
Archive d’origine disponible UUID du binaire et du dSYM Comparer les UUID, puis symboliser avec le fichier correspondant
Archive absente, dSYM conservé UUID du dSYM et UUID du rapport Utiliser le dSYM uniquement si les UUID concordent
Archive et dSYM introuvables Existence d’une sauvegarde ou d’une remise de compilation Chercher une copie conservée ; ne pas compter sur une recompilation pour recréer l’ancien symbole
Seuls certains cadres sont illisibles Image binaire à l’origine des cadres Vérifier séparément l’app, le système ou la dépendance tierce
Compilation visible dans App Store Connect Archive et fichiers présents dans vos propres dépôts Traiter la visibilité de la compilation comme une preuve de distribution, pas comme une preuve d’archivage local

Comment vérifier que la bonne symbolisation a été envoyée avec une distribution App Store ? Rapprochez la compilation distribuée de vos enregistrements, puis contrôlez l’Archive et les UUID des dSYM qu’elle contient. Les informations d’App Store Connect aident à identifier la compilation visible sur la plateforme ; elles ne remplacent pas cette vérification du fichier de symboles associé au binaire. Pour un problème limité à des cadres appartenant à un composant tiers, demandez au fournisseur le dSYM correspondant à la version réellement intégrée.

05 Liste de contrôle pour les prochaines compilations

Appliquez cette procédure à chaque remise destinée à une distribution, qu’elle soit effectuée depuis votre poste ou un Mac distant. Le but est de pouvoir retrouver les fichiers d’origine sans dépendre de la mémoire d’une personne ni du seul historique de la plateforme.

  • [ ] Associez la remise à une version, à un numéro de compilation et à un identifiant interne vérifiables.
  • [ ] Conservez l’Archive produite par cette compilation dans un emplacement défini par votre équipe.
  • [ ] Vérifiez que les dSYM de l’app principale et de ses extensions se trouvent dans les éléments archivés attendus.
  • [ ] Relevez les UUID des binaires et des dSYM, puis gardez ce relevé avec l’Archive ou sa fiche de remise.
  • [ ] Pour chaque framework tiers, consignez si son dSYM est fourni, où il est conservé et à quelle version de dépendance il correspond.
  • [ ] Après le transfert depuis un Mac distant ou une chaîne d’intégration, vérifiez que l’Archive et les symboles peuvent être retrouvés depuis l’espace auquel l’équipe a réellement accès.
  • [ ] Avant de supprimer un espace de travail temporaire, contrôlez que les éléments nécessaires ont été copiés et qu’ils ne sont pas restés uniquement sur la machine de compilation.
  • [ ] Lors d’un incident, partez du rapport reçu, identifiez l’image concernée et comparez les UUID avant toute nouvelle tentative de symbolisation.

Cette procédure est aussi une manière de repérer tôt les lacunes de remise : un lien vers un résultat de compilation, sans Archive ni dSYM accessible, ne suffit pas pour traiter un futur rapport. Si vous faites compiler l’app sur un Mac distant, définissez qui récupère les fichiers, où ils sont déposés et comment vous vérifiez leur présence après la fin de la tâche. Ne présumez pas qu’une conservation automatique ou une durée de rétention donnée existe sans l’avoir vérifiée dans votre propre environnement.

Un Mac local reste pertinent si vous compilez régulièrement, si vous devez intervenir sur des périphériques physiques ou si vous avez besoin d’un accès direct et permanent à la machine. À l’inverse, réinstaller l’environnement ou recompilier sur votre poste ne réparera pas la perte d’un dSYM ancien dont l’UUID ne correspond plus. Une compilation confiée à un environnement distant peut séparer les ressources de compilation de votre poste de travail, mais elle ne dispense pas d’organiser la récupération et la conservation des Archives. Avant de choisir, examinez les conditions présentées sur la page tarifs de CALMVPS et vérifiez si le mode d’accès convient à votre chaîne de remise.

Quand une Archive manque, les pistes réalistes sont donc limitées : rechercher une sauvegarde, vérifier les copies transmises à l’équipe et demander les symboles nécessaires au fournisseur d’une dépendance. L’information visible dans App Store Connect peut aider à retrouver la compilation, mais elle ne recrée pas les fichiers locaux manquants. Pour éviter que le même incident se reproduise, votre procédure de publication doit relier chaque binaire distribué à son Archive, à ses dSYM et à des éléments permettant de les retrouver.

Si vous n’avez pas besoin d’acheter un Mac pour un usage permanent et souhaitez plutôt évaluer un environnement de compilation distant, comparez d’abord les accès, les modalités de livraison des fichiers et votre propre procédure d’archivage. La location ne constitue pas une garantie de sauvegarde automatique : vous devez vérifier vous-même que l’Archive et les symboles ont bien été remis et qu’ils restent consultables. Vous pouvez examiner les modalités de commande d’un Mac auprès de CALMVPS, puis décider si cette option correspond à votre rythme de publication ; pour un travail continu exigeant un accès physique, une machine locale peut rester le choix le plus adapté.