Obtenez des rapports de plantage désobscurcis avec le SDK Firebase Crashlytics

Par défaut, Firebase Crashlytics traite automatiquement vos fichiers de symboles de débogage (dSYM) pour vous fournir des rapports de plantage désobscurcis 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 pouvant 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 quelques moyens de résoudre les problèmes lorsque Crashlytics ne peut pas localiser le dSYM de votre application.

Vérifiez si Xcode produit des dSYM

Le plus souvent, les fichiers dSYM disparaissent car 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 :

  1. Ouvrez votre projet dans Xcode et sélectionnez le fichier de projet dans le navigateur Xcode.

  2. Sélectionnez votre cible de build principale.

  3. Ouvrez l'onglet Paramètres de compilation de la cible, puis cliquez sur Tous.

  4. Recherchez "format des informations de débogage".

  5. Définir le format d' informations de débogage à NAIN avec dSYM fichier pour tous vos types de construction.

  6. Reconstruisez votre application.

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

Localisez vos dSYM

Parfois, Crashlytics ne peut pas localiser le dSYM de votre application en raison de configurations de bitcode ou de la connectivité de la console. Lorsque cela se produit, il existe deux manières supplémentaires de résoudre les problèmes :

Téléchargez vos dSYM

En tant que back-up, Crashlytics comprend un upload-symbols script que vous pouvez appeler à partir de n'importe où dans votre processus de construction de télécharger manuellement vos dSYMs. Le script fournit plus d' informations sur le processus de téléchargement et de messagerie d'erreur plus robuste (pour les notes d'utilisation et des instructions supplémentaires, vous devez exécuter upload-symbols sans aucun paramètre).

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

  1. 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 \{\}
  2. 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