Compartir a través de

Compatibilidad con Windows

  • Artículo

Importante

Visual Studio App Center está programado para su retirada el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.

Obtenga más información sobre las escalas de tiempo de soporte técnico y las alternativas.

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 para UWP de la Tienda Windows y de la Tienda Windows con 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.
  • Compatibilidad con excepciones controladas
  • Número de usuarios afectados por bloqueo o grupo de errores
  • Capacidad de agregar anotaciones por bloqueo o grupo de errores
  • Capacidad de marcar grupos de bloqueos y errores como abiertos, cerrados o omitido
  • Capacidad de descargar informes de bloqueos 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 instancia de bloqueo, incluido cuándo se inició la aplicación, cuándo se bloqueó y qué país o región e idioma usó 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, verás los datos de bloqueo y error que entran en el portal de Diagnósticos de App Center en una interfaz de usuario nueva y mejorada. Para los datos de bloqueo y error que se muestran en la nueva interfaz de usuario 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 asignan a las nuevas API de errores en la documentación de transición de API.

Simbólica

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

Bloqueos sin formato

Los bloqueos sin asignar se muestran en la sección Diagnósticos de App Center para que pueda 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 asignar". Si se cargan los símbolos que faltan, el grupo de bloqueos sin asignar se reemplazará por un grupo de bloqueo simbólico.

Cargar símbolos

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

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 partners.

  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 para el envío (versión) para el que desea 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).

Nota:

La aplicación debe declarar una dependencia en cualquier versión de .NET Native para generar símbolos de depuración. Esta declaración debe incluirse en la <Dependencies> sección de AppxManifest.xml. Ejemplo:

<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 símbolorán automáticamente.

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. Desencadene 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}'
  1. 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}'
  1. Realice una PATCH solicitud a la API de symbol_uploads mediante la symbol_upload_id propiedad devuelta desde 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" }'

Nota:

La API de carga de símbolos no funciona para archivos de más de 256 MB. Use la CLI de App Center para cargar estos archivos. Puede instalar la CLI de App Center siguiendo las instrucciones del repositorio de la CLI de App Center.

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 los informes de bloqueos totalmente simbólicos, los bloqueos se muestran en la pestaña Sin formato . 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 y los símbolos lo más completo posible con los símbolos del archivo. Una vez que hayan terminado de procesarse, aparecerán en la pestaña Bloqueos parcialmente simbólicos. Los nuevos bloqueos que también dependen de los mismos identificadores de símbolo marcados como omitido omitirán la pestaña Sin asignar a medida que entran y fluyen a través del 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 bloqueos de carga.