Desofuscación o simbolización de seguimientos de pila de fallas

Para desofuscar los seguimientos de pila de Java, primero debes generar un archivo de asignación de ProGuard. A fin de obtener información para hacerlo, visita el sitio de Google Developers.

Complemento de Android para Gradle versión 4.1 y posteriores

Si tu proyecto involucra la compilación de un Android App Bundle, puedes incluir el archivo de símbolos de depuración automáticamente. Para ello, agrega lo siguiente al archivo build.gradle de la app:

• android.defaultConfig.ndk.debugSymbolLevel = 'FULL'

Nota: El límite del archivo de símbolos de depuración es de 800 MB. Si la huella de tus símbolos de depuración es demasiado grande, usa SYMBOL_TABLE en lugar de FULL para reducir el tamaño del archivo.

Si tu proyecto involucra la creación de un APK, usa la configuración de compilación build.gradle anterior para generar el archivo de símbolos de depuración por separado. Sube manualmente el archivo de símbolos de depuración a Google Play Console como se describe a continuación en el Paso 2: Sube un archivo de desofuscación o de simbolización. Como parte del proceso de compilación, el complemento de Gradle para Android genera este archivo en la siguiente ubicación del proyecto:

• app/build/outputs/native-debug-symbols/variant-name/native-debug-symbols.zip

Complemento de Android para Gradle versión 4.0 y anteriores (y otros sistemas de compilación)

Como parte del proceso de compilación de un paquete de aplicación o APK, el complemento de Android para Gradle conserva una copia de las bibliotecas sin extraer en un directorio de proyecto. Este directorio sigue una estructura similar a la que se muestra a continuación:

app/build/intermediates/cmake/universal/release/obj

├── armeabi-v7a/

│   ├── libgamenegine.so

│   ├── libothercode.so

│   └── libvideocodec.so

├── arm64-v8a/

│   ├── libgamenegine.so

│   ├── libothercode.so

│   └── libvideocodec.so

├── x86/

│   ├── libgamenegine.so

│   ├── libothercode.so

│   └── libvideocodec.so

└── x86_64/

    ├── libgameengine.so

    ├── libothercode.so

    └── libvideocodec.so

Nota: Si usas un sistema de compilación diferente, puedes modificarlo para almacenar bibliotecas sin extraer en un directorio que cumpla con la estructura que se indicó más arriba.

1. Comprime el contenido de este directorio:
   • $ cd app/build/intermediates/cmake/universal/release/obj
   • $ zip -rmbols.zip .
2. Sube manualmente el archivo symbols.zip a Play Console como se describe a continuación en el Paso 2: Sube un archivo de desofuscación o de simbolización.

El archivo de símbolos de depuración tiene un límite de 800 MB. Si tu archivo es demasiado grande, es posible que se deba a que los archivos .so contienen una tabla de símbolos (nombres de funciones) además de información de depuración DWARF (nombres de archivos y líneas de código). Estos elementos no son necesarios para simbolizar el código y se pueden quitar mediante la ejecución del siguiente comando:

• $OBJCOPY --strip-debug lib.so lib.so.sym

Nota: $OBJCOPY apunta a la versión específica de la ABI que estás quitando. Por ejemplo: ndk-bundle/toolchains/aarch64-linux-android-4.9/prebuild/linux-x86_64/bin/aarch64-linux-android-objcopy

Para subir un archivo de desofuscación o simbolización, sigue estos pasos:

1. Abre Play Console.
2. Selecciona una app.
3. En el menú de la izquierda, selecciona Prueba y lanza > Explorador de paquete de aplicación.
4. En la esquina superior derecha, usa el selector para elegir el artefacto pertinente.
5. Selecciona la pestaña Descargas y desplázate hacia abajo hasta la sección "Recursos".
6. Haz clic en la flecha de carga del archivo de asignación o en los símbolos de depuración según corresponda para subir el archivo de desofuscación o de simbolización para la versión de la app.

Para subir archivos mediante la API de Google Play Developer, ve al sitio de Google Developers.

Play Console usa ndk-stack para simbolizar los seguimientos de pila en las apps nativas y ReTrace para las fallas de Java. Si eliges no compartir tus archivos de desofuscación, puedes copiar las pilas de fallas ofuscadas desde Play Console y usar la herramienta adecuada sin conexión para simbolizarlas. Sin embargo, este proceso debe realizarse de forma manual en cada pila de fallas, por lo que es lento y requiere mucho tiempo. Si proporcionas los archivos de desofuscación, Play Console podrá hacerlo por ti.

Después de que subas un archivo de asignación ProGuard o un archivo de símbolos de depuración para una versión de la app, solo se desofuscarán las fallas y los ANR que ocurran posteriormente. Para ver las fallas y los ANR desofuscados en Play Console, deberás esperar un tiempo hasta que los dispositivos de los usuarios envíen los informes correspondientes.

Esto se debe a que subiste un archivo de desofuscación o simbolización incompleto. Asegúrate de incluir los archivos de simbolización de toda la app, especialmente si usas un proceso de compilación complejo o de varias etapas. Uno de los motivos más comunes de la desofuscación parcial es el uso de bibliotecas de terceros. En esos casos, es posible que el proveedor de la biblioteca pueda proporcionar los archivos de desofuscación.

Sin los archivos de desofuscación, se mostrarán por separado la misma falla o ANR, ya sea que ocurran en dispositivos de 32 y 64 bits o en dispositivos Intel y ARM. Si proporcionas archivos de desofuscación, podemos agrupar las fallas, lo que te brinda una mejor perspectiva de las fallas y los ANR de mayor impacto para la app.

Si olvidas subir el archivo para una nueva versión de la app, volverán a ofuscarse las fallas y los ANR. Sigue las instrucciones que se detallaron arriba para subirlo ahora. Después de que subas un archivo de asignación ProGuard o un archivo de símbolos de depuración para una versión de la app, solo se desofuscarán las fallas y los ANR que ocurran posteriormente. Para ver las fallas y los ANR desofuscados en Play Console, deberás esperar un tiempo hasta que los dispositivos de los usuarios envíen los informes correspondientes.

Para evitar el riesgo de que se te olvide subir el archivo, considera cambiar el proceso de compilación para usar paquetes de aplicaciones con el complemento de Gradle para Android 4.1 o versiones posteriores. En este caso, puedes seguir las instrucciones que aparecen en el sitio para desarrolladores de Android para incluir automáticamente el archivo de símbolos de depuración en el paquete de aplicación.

Si subes un archivo incorrecto para una versión de la app, volverán a ofuscarse las fallas y los ANR. Para subir una versión corregida, sigue estos pasos:

1. Abre Play Console.
2. Selecciona una app.
3. En el menú de la izquierda, selecciona Prueba y lanza > Explorador de paquete de aplicación.
4. En la esquina superior derecha, usa el selector para elegir el artefacto pertinente.
5. Selecciona la pestaña Descargas y desplázate hacia abajo hasta la sección "Recursos".
6. Haz clic en el ícono de borrar junto al archivo de desofuscación o de simbolización incorrecto.
7. Una vez que se borre la versión incorrecta, haz clic en el ícono de carga y sube el archivo correcto para la versión de la app.

Luego de que subas el archivo correcto de asignación ProGuard o de símbolos de depuración para una versión de la app, solo se desofuscarán las fallas y los ANR que ocurran posteriormente. Para ver las fallas y los ANR desofuscados en Play Console, deberás esperar un tiempo hasta que los dispositivos de los usuarios envíen los informes correspondientes.

Sugerencia: Para evitar el riesgo de subir una versión incorrecta del archivo, considera cambiar el proceso de compilación para usar paquetes de aplicaciones con el complemento de Gradle para Android 4.1 o versiones posterior. En este caso, puedes seguir las instrucciones que aparecen en el sitio para desarrolladores de Android para incluir automáticamente el archivo de símbolos de depuración en el paquete de aplicación.

Para comenzar, visita el sitio para desarrolladores de Android.

Sí.

En ocasiones, el sistema encuentra un error de ANR, pero no puede recopilar el seguimiento de pila. Cuando eso ocurre, se muestra el error de ANR para brindarte una vista más completa de la estabilidad de tu app, pero no se puede mostrar el seguimiento de pila en sí. Los ANR sin seguimientos de pila se agrupan por tipo y actividad, por lo que revisar y corregir ANR similares puede ayudar a reducir la cantidad sin seguimientos de pila.