Compartir a través de

Otras API de UWP y WinUI

Importante

Visual Studio App Center se retiró el 31 de marzo de 2025, excepto las características de análisis y diagnóstico, que seguirán siendo compatibles hasta el 30 de junio de 2026. Más información.

Ajuste el nivel de registro

Puede controlar la cantidad de mensajes de registro que aparecen desde App Center en la consola. Utiliza la API LogLevel para habilitar el registro adicional durante la depuración. De forma predeterminada, se establece en ASSERT para los entornos de App Store, y en WARN para otros casos.

Para tener tantos mensajes de registro como sea posible, use LogLevel.Verbose.

AppCenter.LogLevel = LogLevel.Verbose;

Identificación de instalaciones

El SDK de App Center crea un UUID para cada dispositivo una vez instalada la aplicación. Este identificador sigue siendo el mismo para un dispositivo cuando se actualiza la aplicación y solo se genera uno nuevo cuando se vuelve a instalar la aplicación. La SIGUIENTE API es útil para fines de depuración.

System.Guid? installId = await AppCenter.GetInstallIdAsync();

Identificación de usuarios

El SDK de App Center admite la configuración de un identificador de usuario que se usa para mejorar los informes de fallos. Para usar esta funcionalidad:

  1. Configure el SDK de App Center llamando a AppCenter.Start(...) como se describe en la guía introducción del SDK de App Center.
  2. Establezca un userID elemento en el SDK mediante el código siguiente:
AppCenter.SetUserId("your-user-id");

Después de establecer un identificador de usuario, puede usar la función de búsqueda de App Center para buscar informes de fallos específicos para el identificador. Obtenga más información en la documentación de búsqueda de App Center.

Nota:

El valor del identificador de usuario está limitado a 256 caracteres. Se mostrará con los informes de errores, pero no se usará para la agregación ni para los recuentos de usuarios afectados. En caso de establecer el identificador de usuario varias veces, solo se usará el último identificador de usuario. Debe establecer el identificador de usuario usted mismo antes de iniciar cada aplicación, ya que el SDK no almacena este valor entre inicios.

Deshabilitar todos los servicios en tiempo de ejecución

Si desea deshabilitar todos los servicios de App Center a la vez, use la Enabled propiedad . Cuando se deshabilita, el SDK no reenvía ninguna información a App Center.

AppCenter.SetEnabledAsync(false);

Para habilitar todos los servicios de una vez más, use la misma API, pero pase true como parámetro.

AppCenter.SetEnabledAsync(true);

No es necesario esperar esta llamada para que otras llamadas API (como IsEnabledAsync) sean coherentes.

El estado se conserva en el almacenamiento del dispositivo en los inicios de la aplicación.

Cambio del estado del servicio en tiempo de ejecución

Habilite o deshabilite los servicios en tiempo de ejecución con el código siguiente:

Analytics.SetEnabledAsync(false);

No permitir solicitudes de red

En el SDK de App Center, las solicitudes de red se permiten de forma predeterminada. Si desea enviar datos que el SDK de App Center recopila por el usuario, puede impedir el envío automático de datos.

AppCenter.IsNetworkRequestsAllowed = false;

En este caso, el SDK de App Center continúa recopilando datos, pero solo se enviará cuando se permitan las solicitudes de red.

AppCenter.IsNetworkRequestsAllowed = true;

Nota:

Este valor se conserva entre los reinicios.

En cualquier momento, puede comprobar si se permiten o no el envío de datos en el SDK de App Center.

AppCenter.IsNetworkRequestsAllowed;

Comprobación de si App Center está habilitado

También puede comprobar si App Center está habilitado o no.

bool enabled = await AppCenter.IsEnabledAsync();

Comprobación de la versión del SDK de App Center en tiempo de ejecución

Puede obtener la versión del SDK de App Center que está usando actualmente.

AppCenter.SdkVersion;

Tamaño de almacenamiento

Al usar el SDK de App Center, los registros se almacenan localmente en el dispositivo. Los registros grandes pueden ocupar mucho espacio, por lo que puede optar por limitar el tamaño de la base de datos local.

Puede usar la SetMaxStorageSizeAsync API para establecer el tamaño de la base de datos local. La API es asincrónica y se invoca la devolución de llamada cuando se inician los servicios de App Center. Por este motivo, se debe llamar a SetMaxStorageSizeAsync antes de la llamada a AppCenter.Start(...). Solo puede llamar a la API una vez.

// Use 20 MB for storage.
AppCenter.SetMaxStorageSizeAsync(20 * 1024 * 1024).ContinueWith((storageTask) => {
    // The storageTask.Result is false when the size cannot be honored.
});
AppCenter.Start("{Your App Secret}", typeof(Analytics));

Si no establece el tamaño máximo de almacenamiento, el SDK usa un tamaño máximo predeterminado de 10 MB. El tamaño mínimo que puede establecer es de 20 KB.

Nota:

El tamaño de almacenamiento máximo real puede ser mayor que el valor que ha elegido. SQLite redondea el tamaño hasta el siguiente múltiplo de la página. El SDK de App Center usa un tamaño de página de 4 KB.

Nota:

Los registros anteriores a 25 días se descartarán.