Sube archivos dSYM

Los archivos dSYM de su aplicación se almacenan en la carpeta de ruta del archivo dSYM de Xcode. Esta es la carpeta donde el agente de iOS obtiene los archivos dSYM que se utilizan para simbolizar sus informes de fallos. New Relic proporciona un script posterior a la compilación como parte del proceso de instalación del agente iOS. Este script convierte automáticamente su dSYM al formato de archivo de mapa de New Relic y carga los archivos necesarios para la simbolización del accidente en New Relic.

scriptautomático

Se incluye un script Swift con el agente de iOS que debe ejecutarse desde un script de compilación en las fases de compilación de su objetivo en Xcode. El script carga automáticamente archivos dSYM en segundo plano (o convierte su dSYM al formato de archivo de mapa de New Relic) y luego realiza una carga en segundo plano de los archivos necesarios para la simbolización del fallo en New Relic.

En Xcode 14, Apple cambió la configuración predeterminada en proyectos recién creados para deshabilitar el código de bits. La App Store ahora solo acepta envíos de aplicaciones con el código de bits desactivado. Consulte las notas de la versión de Xcode 14. Si su proyecto todavía tiene el código de bits habilitado, debe desactivarlo. El script automático requiere que el código de bits esté deshabilitado.

Apple genera archivos dSYM para aplicaciones habilitadas para Bitcode. Debe descargar los archivos dSYM para aplicaciones habilitadas con Bitcode de Apple y cargarlos en New Relic a través de la UI de monitoreo de móviles.

Si ve un código de máquina ilegible en la páginaCrashes , es posible que sus archivos dSYM no se hayan cargado correctamente. En algunos casos, es posible que necesites cargar archivos dSYM manualmente.

En la versión 7.4.0 del agente iOS de New Relic Presentamos un nuevo script de carga de símbolos que utiliza Swift. La versión Python del script de carga de símbolos todavía está disponible, pero se eliminará en una versión futura. Con la versión 7.3.8 del agente iOS de New Relic, la versión Python del script automático usa Python 3. Si usa macOS 12.3 macOS 12.3 (Monterey), Python 3 se instalará de forma predeterminada con Xcode. Pero si usa el script automático de Python en macOS 12.2 o anterior, es posible que necesite instalar Python 3 manualmente.

Identificar dSYM faltantes

Cuando se carga una aplicación habilitada para Bitcode en Apple para su revisión en la App Store o distribución ad hoc, los dSYM deben descargarse manualmente desde Apple y cargarse en New Relic para permitir que los informes de fallas móviles se simbolicen adecuadamente. Estos dSYM se pueden descargar a través del organizador de archivos en Xcode a los pocos minutos de cargar la aplicación. En esta situación, siga los procedimientos para encontrar el archivo y descargar dSYM.

Si a una aplicación le falta un archivo dSYM, verá tres indicadores en la UI de monitoreo de móviles:

• Banner notification

  : Aparece un banner de advertencia en la página

  Crash report

  . La advertencia dice:

We were unable to locate your dsym.

• Upload prompt

  : Desde la página

  Crash type summary

  se le indicará automáticamente que cargue un archivo dSYM si falta.

• Machine code

  : El rastreo del bloqueo de la pila en la página

  Crash report

  muestra código de máquina y no un mensaje de error legible por humanos.

Cargar archivos dSYM a través de la UI de monitoreo de móviles

Puede cargar fácilmente sus archivos dSYM directamente desde la UI de New Relic. El tamaño máximo de archivo es 600 MB. Para cargar sus archivos dSYM:

1. Vaya a

   one.newrelic.com > All capabilities > Mobile

   . Luego seleccione su aplicación de la lista.

2. Ver

   Crash analysis

   .

3. Seleccione un bloqueo específico de la lista

   Crash types

   .

4. Haga clic en

   Upload dSYM

   . Puede arrastrar y soltar sus dSYM directamente o seleccionar el archivo desde su computadora.

Cargar archivos dSYM manualmente

En algunas circunstancias, la carga automática de archivos dSYM de New Relic puede fallar. Si la carga dSYM falla, crea un archivo upload_dsym_results . Por ejemplo, si hay una falla en la red y la carga de dSYM no se completa, upload_dsym_results contendrá un log de lo que salió mal. Para obtener información adicional sobre cómo New Relic maneja las cargas dSYM, consulte la Comunidad técnica en línea de New Relic.

Si la carga automática falla, puede cargar manualmente su archivo dSYM. Si tiene varios archivos dSYM, pueden estar dentro de un único zip con un tamaño de archivo máximo de 600 MB. El valor YOUR_NEW_RELIC_APPLICATION_TOKEN en los siguientes comandos es la misma clave utilizada para +[NewRelic startWithApplicationToken:] (en Objective-C) o NewRelic.start(withApplicationToken:) (en Swift).

Para cargar manualmente sus archivos dSYM:

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

Resolución de problemas

La script automática creará un archivo upload_dsym_results.log en el directorio raíz de su proyecto, que contiene información sobre cualquier falla que ocurra durante la carga de símbolos.

dSYM faltantes

Si faltan archivos dSYM, es posible que deba verificar la configuración de compilación de Xcode para asegurarse de que se esté generando el archivo. El marco que se construye localmente tiene configuraciones de compilación separadas y es posible que también deban actualizarse.

Configuración de compilación:

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