Recuperar dSYM para aplicaciones Bitcode

Importante

Con Xcode 14 y versiones posteriores, la App Store ya no acepta envíos de códigos de bits desde Xcode 14. Si un proyecto habilita explícitamente el código de bits, Xcode generará un mensaje de advertencia que dice: "La compilación con código de bits está obsoleta. Actualice la configuración de su proyecto y/o objetivo para deshabilitar el código de bits”. Las notas de la versión de Xcode 14 continúan diciendo que "la capacidad de crear aplicaciones con código de bits se eliminará en una actualización futura".

Si usa Xcode 14 o posterior, en lugar de usar código de bits para capturar la pila de fallas simbolizadas de sus compilaciones de lanzamiento, le recomendamos usar el script de carga automática de símbolos para cargar los símbolos de su compilación.

Bitcode es una característica que le da a Apple la capacidad de volver a compilar aplicaciones iOS y tvOS para el hardware de un usuario específico. Esto proporciona un tamaño de descarga más pequeño para el usuario final. Para obtener más información sobre este proceso, consulte la documentación de Bitcode y reducción de aplicaciones de Apple. Cuando Apple compila una aplicación, los archivos dSYM también se compilan. Para que New Relic pueda simbolizar fallas de su aplicación habilitada para Bitcode, estos archivos dSYM deben descargarse de Apple y luego cargarse en New Relic.

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áginaCrash 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.

Descargue archivos dSYM usando iTunes Connect

Para descargar los archivos dSYM que necesita para su aplicación:

log sesión en Apple App Store Connect.
Seleccione
Apps > (select an app) > TestFlight
.
De la lista de compilaciones para su aplicación, seleccione el número de compilación que necesita para dSYM.
En la pestaña
Build Metadata
, seleccione
Download dSYM
.

Luego, para cargar el archivo zip resultante directamente en New Relic:

Siga las instrucciones para cargar dSYM manualmente y omita el paso 1.
Descomprima un dSYM contenido en este archivo zip para recuperar un UUID de compilación que pueda cargar. (Siga el último paso de las instrucciones de carga manual).

Una vez que New Relic reciba el archivo zip, se identificarán los UUID de compilación para todos los demás dSYM contenidos en ese archivo zip.

Descargue archivos dSYM usando el archivo de aplicaciones de Xcode

Utilice la versión de la aplicación y el número de compilación para identificar el archivo de la aplicación correspondiente en Xcode Organizer y descargue los dSYM.

Download dSYMs for mobile app version/build

Using Xcode to download dSYMs: En la pestaña Archives , seleccione la aplicación y la versión/compilación y luego seleccione Download dSYMs.

Abra Xcode
Organizer
: en el menú
Xcode
, seleccione
Window > Organizer > Archives > (select a mobile app)
.
En
Version
, seleccione el archivo que coincida con la versión de la aplicación (enumerada primero) y el número de compilación (después de la versión de la aplicación entre paréntesis).
Seleccione
Download dSYMs
.

Los dSYM se descargarán de Apple si están disponibles y si los nombres de los archivos contienen una serie de letras y números. Si los archivos dSYM llevan el nombre de la dependencia de su proyecto, la descarga no se realizará correctamente.

Subir dSYM

Una vez que haya localizado los dSYM, siga las instrucciones para cargar un dSYM para cada dSYM comprimido.