• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Télécharger les fichiers dSYM

|View as Markdown (English)

Xcode stocke les fichiers dSYM de votre application dans le dossier du chemin d’archive dSYM. Il s’agit du dossier dans lequel l’agent iOS récupère les fichiers dSYM qu’il utilise 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 mappage de New Relic et téléverse les fichiers nécessaires à la symbolisation des plantages vers New Relic.

scriptautomatique

L’agent iOS inclut run-symbol-tool, un script shell que vous exécutez à partir d’une phase de build Run Script dans Xcode. Après chaque build, il exécute run-symbol-tool.swift en arrière-plan, qui convertit vos fichiers dSYM au format de fichier map de New Relic et les télécharge 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.

Important

Agent iOS version 7.4.8 a supprimé les scripts de téléversement Python (generateMap.py, generateMapPython2.py, et newrelic_postbuild.sh). Si votre phase de compilation Run script appelle toujours newrelic_postbuild.sh, remplacez-la par le script run-symbol-tool ci-dessous.

Ajoutez la phase de construction Run Script

  1. Dans Xcode, sélectionnez votre projet dans le navigateur, puis sélectionnez la cible de votre application.

  2. Sélectionnez l’onglet Build Phases .

  3. Cliquez sur + et choisissez New Run Script Phase.

  4. Ajoutez les lignes suivantes à la nouvelle phase. Remplacez APP_TOKEN par votre jeton d’application de New Relic.

    bash
    $
    ARTIFACT_DIR="${BUILD_DIR%Build/*}"
    $
    SCRIPT=`/usr/bin/find "${SRCROOT}" "${ARTIFACT_DIR}" -type f -name run-symbol-tool | head -n 1`
    $
    /bin/sh "${SCRIPT}" "APP_TOKEN"

Dans Xcode 15.3 ou supérieur, définissez User Script Sandboxing sur No afin que le script puisse lire vos fichiers dSYM et écrire son log. Consultez Échecs de téléchargement automatique de dSYM.

Arguments facultatifs

Ajoutez des arguments facultatifs après le jeton d’application, dans n’importe quel ordre :

Argument

Description

--debug

Écrit des détails supplémentaires dans upload_dsym_results.log, tels que les chemins dSYM, l’URL de téléchargement et les commandes de téléchargement. La sortie de débogage inclut votre jeton d’application.

-appVersion <version>

Définit la version de l’application qui est signalée avec les symboles téléversés. Le script accepte également --appVersion et --app-version. Nécessite la version 7.7.5 ou supérieure de l’agent iOS. Voir Version de l’application.

Par exemple:

bash
$
ARTIFACT_DIR="${BUILD_DIR%Build/*}"
$
SCRIPT=`/usr/bin/find "${SRCROOT}" "${ARTIFACT_DIR}" -type f -name run-symbol-tool | head -n 1`
$
/bin/sh "${SCRIPT}" "APP_TOKEN" -appVersion "1.4.2" --debug

Version de l'application

New Relic associe les symboles téléversés à vos builds par version de l’application. Le script utilise la première valeur non vide de cette liste :

  1. L'argument -appVersion
  2. La variable d’environnement NEWRELIC_APP_VERSION
  3. Le paramètre de build MARKETING_VERSION
  4. L’espace réservé 1.2.3

Lorsque le script utilise l'espace réservé, il enregistre un avertissement dans upload_dsym_results.log.

Certains projets ne définissent pas MARKETING_VERSION, comme les applications versionnées avec agvtool ou les applications multi-cibles qui utilisent GENERATE_INFOPLIST_FILE = YES. Pour ces projets, transmettez -appVersion ou définissez NEWRELIC_APP_VERSION afin que vos symboles correspondent à vos builds.

Variables d'environnement

Vous n’avez pas besoin de définir ces variables pour un envoi standard. Pour en définir une, ajoutez une ligne export au-dessus du script dans la même phase Run script :

bash
$
export NEWRELIC_APP_VERSION="1.4.2"
$
ARTIFACT_DIR="${BUILD_DIR%Build/*}"
$
SCRIPT=`/usr/bin/find "${SRCROOT}" "${ARTIFACT_DIR}" -type f -name run-symbol-tool | head -n 1`
$
/bin/sh "${SCRIPT}" "APP_TOKEN"

Le script prend en charge ces variables d’environnement :

Variable

Description

NEWRELIC_APP_VERSION

Version de l’application indiquée avec les symboles téléversés. Nécessite la version 7.7.5 ou supérieure de l’agent iOS. Voir Version de l’application.

DSYM_UPLOAD_URL

Hôte de téléversement. La valeur par défaut est https://mobile-symbol-upload.newrelic.com. Le script ignore cette variable, lorsque votre jeton d'application a un préfixe de région, comme les jetons EU, ou JP. Ces jetons utilisent toujours leur hôte régional.

NEWRELIC_SYMBOL_ENDPOINT

Chemin pour les téléversements de fichiers de mappage. La valeur par défaut est map.

NEWRELIC_DSYM_ENDPOINT

Chemin pour les téléversements de dSYM. La valeur par défaut est symbol.

NEWRELIC_SYMBOL_POST_KEY

Nom du champ de formulaire pour les téléchargements de fichiers de mappage. La valeur par défaut est upload.

NEWRELIC_DSYM_POST_KEY

Nom du champ de formulaire pour les téléversements dSYM. La valeur par défaut est dsym.

Comment fonctionne le script

Lorsqu’il s’exécute, le script effectue les opérations suivantes :

  • Le téléversement s’exécute en arrière-plan, de sorte que votre build n’attend pas qu’il se termine. Le script écrit les résultats dans upload_dsym_results.log.
  • Le script ignore les compilations du simulateur iOS (EFFECTIVE_PLATFORM_NAME est -iphonesimulator).
  • Les builds avec Bitcode activé (ENABLE_BITCODE = YES) se terminent sans envoi et sans faire échouer le build.
  • Le script convertit chaque dSYM dans DWARF_DSYM_FOLDER_PATH en fichier de mappage, compresse les fichiers de mappage, et téléverse le zip vers le point de terminaison /map.
  • Si un dSYM ne peut pas être converti, le script compresse ce dSYM et le téléverse plutôt vers le point de terminaison /symbol. Si le téléversement de la map lui-même échoue, le script enregistre le code d’état HTTP et ne se rabat pas sur un téléversement de dSYM. Dans ce cas, téléversez le dSYM manuellement.
  • Dans la version 7.7.2 et supérieure de l’agent iOS, si un fichier de mappage compressé est supérieur à 200 Mo, le script ne le téléverse pas. Il envoie uniquement la taille du fichier et la version de l’application à New Relic. New Relic ne peut pas symboliquer les plantages de ce build à moins que vous ne téléversiez son dSYM manuellement.
  • Le script choisit la région de téléchargement (US, EU, ou JP) à partir de votre jeton d’application. Ce sont les mêmes hôtes utilisés dans les commandes de téléchargement manuel.

Identifier les dSYM manquants

Lorsqu’une application avec Bitcode activé est envoyée à Apple pour évaluation sur l’App Store ou pour une distribution ad hoc, les dSYM doivent être téléchargés manuellement depuis Apple et envoyés à New Relic pour permettre aux rapports de plantage mobile d’être correctement symboliqués. Ces dSYM peuvent être téléchargés via l’organiseur d’archives dans Xcode dans les minutes qui suivent l’envoi 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éverser vos fichiers dSYM directement depuis l’UI de New Relic. Pour les limites de taille, voir Limitations. Pour téléverser vos fichiers dSYM :

  1. Aller à one.newrelic.com > All capabilities > Mobile. Sélectionnez ensuite votre application dans la liste.
  2. Voir Crashes.
  3. Sélectionnez un crash spécifique à partir du Total crashes dans les crashes de groupe.
  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éversement automatique des fichiers dSYM par New Relic peut échouer. Par exemple, s’il y a une panne de réseau et que le téléversement n’est pas terminé, upload_dsym_results.log enregistre ce qui s’est mal passé. Pour plus d’informations sur la façon dont New Relic gère les téléversements de 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 fichier zip. Pour les limites de taille, consultez les Limitations. 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).

Dans les commandes ci-dessous, utilisez des chemins d’accès complets ou $HOME. Le shell ne développe pas ~ entre guillemets.

Pour télécharger manuellement vos fichiers dSYM :

Dépannage

Le script run-symbol-tool écrit upload_dsym_results.log dans le répertoire racine de votre projet à chaque build, que le téléchargement réussisse ou échoue. Chaque build écrase le log précédent. Pour écrire plus de détails dans le log, ajoutez l’ argument --debug .

Si votre log de build indique upload_dsym_results.log: Operation not permitted, consultez Échecs de téléversement automatique de dSYM.

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

Tenez compte de ces limites de taille :

Droits d'auteur © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.