Cette page a été traduite par l'API Cloud Translation.

Obtenez des rapports de plantage lisibles dans le tableau de bord Crashlytics

Par défaut, Firebase Crashlytics traite automatiquement vos fichiers de symboles de débogage (dSYM) pour vous fournir des rapports de plantage clairs et lisibles par l'homme. Ce comportement est défini lorsque vous ajoutez un script d'exécution qui initialise Crashlytics à la phase de génération de votre application.

Malheureusement, il existe quelques cas qui pourraient entraîner l'échec de votre téléchargement dSYM, tels que le bitcode dans votre application ou d'autres configurations de projet uniques. Ce guide fournit des moyens de résoudre les problèmes lorsque Crashlytics ne parvient pas à localiser le dSYM de votre application.

Vérifiez si Xcode produit des dSYM

Le plus souvent, les fichiers dSYM disparaissent parce que Xcode ne les produit tout simplement pas. Lorsqu'un téléchargement échoue, Crashlytics affiche une alerte "Missing dSYM" dans la console Firebase. Si vous recevez cette alerte, vérifiez d'abord que Xcode produit le bon dSYM pour chaque build :

Ouvrez votre projet dans Xcode et sélectionnez le fichier de projet dans le navigateur Xcode.
Sélectionnez votre cible de construction principale.
Ouvrez l'onglet Build Settings de la cible, puis cliquez sur All .
Recherchez "format d'informations de débogage".
Définissez le format d'informations de débogage sur DWARF avec le fichier dSYM pour tous vos types de construction.
Reconstruisez votre application.

Vos rapports de plantage devraient maintenant apparaître dans la console Firebase. Si le problème persiste ou si vous rencontrez d'autres erreurs, essayez de localiser votre dSYM et de le télécharger manuellement sur Crashlytics.

Localisez vos dSYM

Parfois, Crashlytics ne peut pas localiser le dSYM de votre application en raison de configurations de code binaire ou de la connectivité de la console. Lorsque cela se produit, vous pouvez résoudre le problème de deux manières supplémentaires :

Téléchargez les dSYM bitcode depuis l'App Store

Apple génère de nouveaux dSYM pour les versions compatibles avec le bitcode qui ont été publiées sur l'App Store ou soumises à TestFlight. Si l'un de ces éléments s'applique à votre application, téléchargez un nouveau dSYM pour celle-ci depuis l'App Store :

Connectez-vous à App Store Connect, puis cliquez sur Mes applications > Activité .
Sélectionnez la version pour laquelle vous souhaitez télécharger un dSYM.
Cliquez sur Détails de build > Télécharger dSYM .

Trouver des dSYM sur une machine locale

Exécutez ce qui suit pour afficher tous les UUID de vos dSYM sur votre machine, puis recherchez le dSYM manquant :

mdfind -name .dSYM | while read -r line; do dwarfdump -u "$line"; done

Une fois que vous avez trouvé le dSYM, téléchargez-le sur Crashlytics. Si la commande mdfind ne renvoie aucun résultat, vous pouvez regarder dans le répertoire Products où se trouve votre .app (par défaut, le répertoire Products se trouve dans Derived Data ). Si votre application est lancée en production, vous pouvez également rechercher son dSYM dans le répertoire .xcarchive sur le disque :

Dans Xcode, ouvrez la fenêtre Organisateur et sélectionnez votre application dans la liste. Xcode affiche une liste d'archives pour votre projet.
Cliquez sur une archive tout en maintenant la touche Contrôle enfoncée pour l'afficher dans le Finder. Ensuite, faites un nouveau contrôle-clic dessus et cliquez sur Afficher le contenu du paquet .

Dans .xcarchive se trouve un répertoire dSYMs qui contient des dSYM générés dans le cadre du processus d'archivage de Xcode. Les dSYM de code binaire recompilés sont également téléchargés dans ce dossier lorsque vous utilisez l'outil Télécharger les dSYM... dans la fenêtre Organisateur.

Téléchargez vos dSYM

Pour télécharger manuellement vos dSYM, vous pouvez utiliser l'option "Glisser-déposer" basée sur la console pour télécharger une archive zip contenant vos fichiers dSYM (accédez à la console Firebase > Crashlytics > onglet dSYM ).

Alternativement, en tant que sauvegarde, Crashlytics inclut un script upload-symbols que vous pouvez appeler de n'importe où dans votre processus de construction pour télécharger manuellement vos fichiers dSYM. Le script fournit plus d'informations sur le processus de téléchargement et des messages d'erreur plus complets (pour les notes d'utilisation et des instructions supplémentaires, exécutez upload-symbols sans aucun paramètre).

Lors du téléchargement de fichiers dSYM bitcode, il peut être utile de supprimer tous les fichiers d'icônes dans l'archive zip en exécutant :

unzip appDsyms.zip
cd appDsyms rm -rf $(find . | grep Icon)
# Enumerate all the dSYMs
upload-symbols ... $(ls)

Pour exécuter le script upload-symbols , utilisez l'une des options suivantes :

Incluez la ligne suivante dans votre processus de génération :

find dSYM_DIRECTORY -name "*.dSYM" | xargs -I \{\} $PODS_ROOT/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p PLATFORM \{\}

Exécutez le script directement depuis votre terminal :

/PATH/TO/PODS/DIRECTORY/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p ios /PATH/TO/dSYMs