Compatibilidad con Windows

App Center admite actualmente diagnósticos para aplicaciones para UWP, WPF y WinForms. En esta sección se explica la nueva experiencia para las aplicaciones para UWP como parte de la versión del SDK 2.5.0. Para obtener más información sobre las aplicaciones WPF y WinForms, consulte características de diagnóstico y SDK de WPF/WinForms.

Plataforma universal de Windows

App Center admite el conjunto completo de características de diagnóstico para aplicaciones UWP descargadas de la Tienda Windows y cargadas de forma manual utilizando el SDK 2.5.0 o versiones posteriores. Para habilitar el diagnóstico de App Center para tu aplicación para UWP, sigue la documentación del SDK para UWP de App Center para integrar el SDK de App Center. Puede obtener más información sobre el conjunto de características completo en la documentación de características de diagnóstico.

Nueva experiencia de diagnóstico

Con la versión 2.5.0 del SDK en octubre de 2019, App Center publicó una nueva experiencia de diagnóstico. En esta sección se detallan las mejoras y la experiencia de transición con la nueva versión.

¿Qué mejoras se realizaron?

La experiencia de diagnóstico nueva y mejorada incluye las siguientes adiciones:

• Una experiencia simbólica completa que le permite cargar símbolos en App Center. Consulte la sección de símbolos siguiente para obtener más detalles.
• Soporte para excepciones controladas
• Número de usuarios afectados por fallo o cada grupo de errores
• Capacidad de agregar anotaciones para cada bloqueo o grupo de errores
• Capacidad de marcar grupos de bloqueos y errores como abiertos, cerrados o ignorados
• Capacidad para descargar informes sobre fallos y errores
• Capacidad de adjuntar, ver y descargar un archivo binario y un archivo adjunto de texto a los informes de bloqueo
• Detalles del informe de bloqueos y errores por cada caso de bloqueo, incluido cuándo se inició la aplicación, cuándo se bloqueó y qué país, región e idioma utiliza el dispositivo.

Puede obtener más información sobre cada característica en la documentación de diagnóstico de App Center.

¿Cuál es la experiencia de transición?

Después de actualizar al SDK de UWP de App Center versión 2.5.0, podrás ver los datos de bloqueo y error que llegan al portal de Diagnósticos de App Center en una interfaz de usuario nueva y mejorada. Para los datos de bloqueo y errores que se muestran en la nueva interfaz de diagnóstico, debe usar las API enumeradas en la sección errores. Obtenga más información sobre cómo las API de bloqueos antiguas se correlacionan con las nuevas API de errores en la documentación de transición de API.

Simbicación

Los informes de bloqueos de UWP muestran la traza de pila del subproceso que provocó el bloqueo. Cuando la aplicación utiliza .NET Native (generalmente en compilaciones de lanzamiento), el seguimiento de la pila puede contener direcciones de memoria en lugar de nombres de clases, métodos, nombres de archivo y números de línea necesarios para leer y comprender los errores.

Bloqueos no simbolizados

Los bloqueos sin simbolizar se muestran en la sección "Diagnósticos" del App Center para que puedas ver algunos detalles incluso antes de cargar símbolos. Los símbolos que faltan de estos bloqueos se mostrarán en la pestaña "sin simbolizar". Si se cargan los símbolos que faltan, el grupo de bloqueos sin simbolizar se reemplazará por un grupo de bloqueos simbolizados.

Cargar símbolos

Para obtener las direcciones de memoria simbolizadas, debe cargar un archivo .appxsym en App Center, que contiene toda la información necesaria para la simbolización.

Generar los símbolos localmente

Para obtener un .appxsym archivo, debe crear una agrupación de aplicaciones como se describe aquí. Una vez que haya creado la agrupación, encontrará el archivo de símbolos como un .appxsym archivo dentro de la carpeta del lote de aplicaciones.

Símbolos para aplicaciones integradas en App Center Build

Los servicios de compilación y distribución de App Center pueden generar automáticamente un archivo de símbolos válido y cargarlo en el servicio diagnostics. Si usa App Center para compilar y distribuir automáticamente la aplicación a los usuarios finales, no es necesario obtener y cargar manualmente los archivos de símbolos en App Center.

Símbolos para aplicaciones publicadas en Microsoft Store

Al publicar la aplicación en el almacén, la compilación de .NET Native se produce en el lado servidor. Por lo tanto, debe descargar los símbolos del Centro de socios.

1. Busque la aplicación en la lista y haga clic en ella.
2. Expanda el menú Administración de productos en el panel izquierdo.
3. Haga clic en Administrar paquetes.
4. Haga clic en Mostrar paquetes en la esquina superior derecha de la versión de envío para la cual desea obtener símbolos.
5. Busque el paquete para la versión para la que necesita símbolos y haga clic en vínculos para todas las arquitecturas admitidas para descargar todos los símbolos (como el vínculo Descargar archivo de símbolos de Windows 10 (x64).

<PackageDependency Name="Microsoft.NET.Native.Framework.2.2" MinVersion="2.2.29512.0" Publisher="CN=Microsoft Corporation, 0=Microsoft Corporation, L=Redmond, S=Washington, C=US"/>
<PackageDependency Name="Microsoft.NET.Native.Runtime.2.2" MinVersion="2 2.28604.0" Publisher="CN=Microsoft Corporation, 0=Microsoft Corporation, L=Redmond, S=Washington, C=US"/>

App Center Portal

1. Inicie sesión en App Center y seleccione la aplicación.
2. En el menú izquierdo, vaya a la sección Diagnósticos y seleccione Símbolos.
3. En la esquina superior derecha, haga clic en Cargar símbolos y cargue el archivo.
4. Una vez que App Center indexe los símbolos, los bloqueos se simbolizarán automáticamente para ti.

App Center API

El proceso para cargar símbolos a través de la API implica una serie de tres llamadas API: una para asignar espacio en nuestro back-end, otra para cargar el archivo y otra para actualizar el estado de la carga. El cuerpo de la primera llamada API debe establecerse symbol_type en UWP.

1. Realice una POST solicitud a la API de Symbol_uploads. Esta llamada asigna espacio en nuestro back-end para el archivo y devuelve una symbol_upload_id propiedad y .upload_url

curl -X POST 'https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/symbol_uploads' \
    -H 'accept: application/json' \
    -H 'X-API-Token: {API TOKEN}' \
    -H 'Content-Type: application/json' \
    -d '{JSON BODY}'

2. Con la upload_url propiedad devuelta desde el primer paso, realice una PUT solicitud con el encabezado : "x-ms-blob-type: BlockBlob" y proporcione la ubicación del archivo en el disco. Esta llamada carga el archivo en nuestras cuentas de almacenamiento de back-end. Obtenga más información sobre los encabezados de solicitud PUT Blob .

curl -X PUT '{upload_url}' \
    -H 'x-ms-blob-type: BlockBlob' \
    --upload-file '{path to file}'

3. Haga una PATCH solicitud a la API de symbol_uploads mediante la symbol_upload_id propiedad proporcionada en el primer paso. En el cuerpo de la solicitud, especifique si desea establecer el estado de la carga en committed (completado correctamente) el proceso de carga o aborted (no se completó correctamente).

curl -X PATCH 'https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/symbol_uploads/{symbol_upload_id}' \
    -H 'accept: application/json' \
    -H 'X-API-Token: {API TOKEN}' \
    -H 'Content-Type: application/json' \
    -d '{ "status": "committed" }'

App Center CLI

También puede usar la CLI para cargar archivos de símbolos:

appcenter crashes upload-symbols --appxsym {symbol file}

Omitir símbolos

Cuando App Center no tiene todos los archivos de símbolos para transformar completamente los informes de bloqueos, los bloqueos se muestran en la pestaña Insimbolicados. Los símbolos necesarios se cargan desde esta página si tiene acceso a ellos.

Si no puede cargar los símbolos, puede marcarlos como Omitir seleccionando filas en la tabla y haciendo clic en el botón Omitir versiones . Este botón indica a App Center que procese los bloqueos e intentará simbolizarlos en la mayor medida posible con los símbolos registrados. Una vez que hayan terminado de procesarse, aparecerán en la pestaña Bloqueos simbolizados parcialmente. Los nuevos bloqueos que también dependen de los mismos identificadores de símbolo marcados como omitidos pasarán por alto la pestaña Sin asignar al entrar y pasar por el sistema.

WinRT, Silverlight y otras plataformas

App Center no admite ninguna otra plataforma de Windows además de UWP, WPF y WinForms. Si tiene una aplicación de Windows con bloqueos nativos de C++, puede cargar estos bloqueos en App Center a través de la API de carga de bloqueos.