Télécharger les fichiers dSYM

Les fichiers dSYM de votre application sont stockés dans le dossier du chemin d'archive dSYM de Xcode. Il s’agit du dossier dans lequel l’agent iOS obtient les fichiers dSYM utilisés pour symboliser vos rapports de plantage. New Relic fournit un script post-build dans le cadre du processus d'installation de l'agent iOS. Ce script convertit automatiquement votre dSYM au format de fichier de carte New Relic et télécharge les fichiers nécessaires à la symbologie des plantages sur New Relic.

scriptautomatique

Un script Swift est inclus avec l'agent iOS qui est destiné à être exécuté à partir d'un script de build dans les phases de build de votre cible dans Xcode. Le script télécharge automatiquement les fichiers dSYM en arrière-plan (ou convertit votre dSYM au format de fichier de carte New Relic), puis effectue un téléchargement en arrière-plan des fichiers nécessaires à la symbolisation des plantages vers New Relic.

Dans Xcode 14, Apple a modifié le paramètre par défaut des projets nouvellement créés pour désactiver le bitcode. L'App Store accepte désormais uniquement les soumissions d'applications avec le bitcode désactivé. Voir les notes de sortie de Xcode 14. Si votre projet a toujours le bitcode activé, vous devez le désactiver. Le script automatique nécessite que le bitcode soit désactivé.

Apple génère des fichiers dSYM pour les applications compatibles Bitcode. Vous devez télécharger les fichiers dSYM pour les applications compatibles Bitcode depuis Apple et les télécharger sur New Relic via l'interface utilisateur des applications mobilesmonitoring .

Si vous voyez un code machine illisible sur la pageCrashes , il se peut que vos fichiers dSYM ne soient pas téléchargés correctement. Dans certains cas, vous devrez peut-être télécharger manuellement les fichiers dSYM.

Dans la version 7.4.0 de l'agent iOS New Relic nous avons introduit un nouveau script de téléchargement de symboles qui utilise Swift. La version Python du script de téléchargement de symboles est toujours disponible mais sera supprimée lors d'une prochaine sortie. Avec la version 7.3.8 de l'agent iOS New Relic, la version Python du script automatique utilise Python 3. Si vous utilisez macOS 12.3 macOS 12.3 (Monterey), Python 3 sera installé par défaut avec Xcode. Mais si vous utilisez le script automatique Python sur macOS 12.2 ou avant, vous devrez peut-être installer manuellement Python 3.

Identifier les dSYM manquants

Lorsqu'une application compatible Bitcode est téléchargée sur Apple pour un examen dans l'App Store ou une distribution ad hoc, les dSYM doivent être téléchargés manuellement depuis Apple et téléchargés sur New Relic pour permettre aux rapports de plantage mobiles d'être correctement symbolisés. Ces dSYM peuvent être téléchargés via l'organisateur d'archives dans Xcode quelques minutes après le téléchargement de l'application. Dans cette situation, suivez les procédures pour trouver l'archive et télécharger les dSYM.

Si une application ne dispose pas d'un fichier dSYM, vous verrez trois indicateurs dans l'interface utilisateur des applications mobiles monitoring :

• Banner notification:Une bannière d'avertissement apparaît sur la pageCrash report . L'avertissement dit :

We were unable to locate your dsym.

• Upload prompt:À partir de la page Crash type summary , vous serez automatiquement invité à télécharger un fichier dSYM s'il est manquant.
• Machine code:La trace de crash d'appels sur la page Crash report affiche du code machine et non un message d'erreur lisible par l'homme.

Télécharger des fichiers dSYM via l'interface utilisateur des applications mobiles monitoring

Vous pouvez facilement télécharger vos fichiers dSYM directement depuis l'interface utilisateur de New Relic. La taille maximale du fichier est de 600 Mo. Pour télécharger vos fichiers dSYM :

1. Aller à one.newrelic.com > All capabilities > Mobile. Sélectionnez ensuite votre application dans la liste.
2. Voir Crash analysis.
3. Sélectionnez un crash spécifique dans la liste Crash types .
4. Cliquez sur Upload dSYM. Vous pouvez soit glisser-déposer vos dSYM directement, soit sélectionner le fichier depuis votre ordinateur.

Télécharger manuellement les fichiers dSYM

Dans certaines circonstances, le téléchargement automatique des fichiers dSYM par New Relic peut échouer. Si le téléchargement dSYM échoue, il crée un fichier upload_dsym_results . Par exemple, s'il y a une panne de réseau et que le téléchargement dSYM n'est pas terminé, upload_dsym_results contiendra un log de ce qui s'est mal passé. Pour plus d'informations sur la manière dont New Relic gère les téléchargements dSYM, consultez la communauté technique en ligne de New Relic.

Si le téléchargement automatique échoue, vous pouvez télécharger manuellement votre fichier dSYM. Si vous avez plusieurs fichiers dSYM, ils peuvent être dans un seul zip avec une taille de fichier maximale de 600 Mo. La valeur YOUR_NEW_RELIC_APPLICATION_TOKEN dans les commandes ci-dessous est la même clé utilisée pour +[NewRelic startWithApplicationToken:] (en Objective-C) ou NewRelic.start(withApplicationToken:) (en Swift).

Pour télécharger manuellement vos fichiers dSYM :

$
NewRelicAgent.framework/Resources/generateMap.py "DSYM_ARCHIVE_PATH" "YOUR_NEW_RELIC_APPLICATION_TOKEN"

Dépannage

Le script automatique créera un fichier upload_dsym_results.log dans le répertoire racine de votre projet, qui contient des informations sur les échecs qui se produisent lors du téléchargement du symbole.

dSYM manquants

Si les fichiers dSYM sont manquants, vous devrez peut-être vérifier les paramètres de construction de Xcode pour vous assurer que le fichier est généré. les frameworks construits localement ont des paramètres de construction distincts et peuvent également nécessiter d'être mis à jour.

Paramètres de construction :

Debug Information Format : Dwarf with dSYM File
Deployment Postprocessing: Yes
Strip Linked Product: Yes
Strip Debug Symbols During Copy : Yes

Limites

Les fichiers dSYM sont limités en taille à 1 Go chacun.