Otras API de tvOS

Importante

Visual Studio App Center está programado para retirarse 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 y las alternativas de soporte técnico.

• Android
• iOS
• MAUI/Xamarin
• UWP
• WPF/WinForms
• React Native
• macOS
• tvOS
• Unity
• Cordova

Ajuste del nivel de registro

Puede controlar la cantidad de mensajes de registro que se muestran desde App Center en la consola. Use - setLogLevel:API para habilitar el registro adicional durante la depuración. De forma predeterminada, se establece LogLevelAssert en para el entorno de App Store y LogLevelWarning en caso contrario.

Para tener tantos mensajes de registro como sea posible, use MSACLogLevelVerbose/LogLevel.verbose.

[MSACAppCenter setLogLevel:MSACLogLevelVerbose];

AppCenter.logLevel = .verbose

Identificación de las 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 se genera uno nuevo solo cuando se vuelve a instalar la aplicación. La SIGUIENTE API es útil para fines de depuración.

NSUUID *installId = [MSACAppCenter  installId];

var installId = AppCenter.installId

Identificación de usuarios

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

1. Para configurar el SDK de App Center, llame a :start:withServices: como se describe en la guía de introducción del SDK de App Center.
2. Establezca en userID el SDK mediante el código siguiente:

[MSACAppCenter setUserId:@"your-user-id"];

AppCenter.userId = "your-user-id"

Después de establecer un identificador de usuario, puede usar la característica de búsqueda de App Center para buscar informes de bloqueo 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 bloqueo, pero no se usarán para la agregación o recuentos de usuarios afectados. En caso de que establezca el identificador de usuario varias veces, solo se usará el último identificador de usuario. Debe establecer el identificador de usuario usted mismo antes de que se inicie cada aplicación, ya que el SDK no almacena este valor entre los inicios.

Deshabilitación de todos los servicios en tiempo de ejecución

Si desea deshabilitar todos los servicios de App Center a la vez, use la setEnabled API. Cuando está deshabilitado, el SDK no reenviará ninguna información a App Center.

[MSACAppCenter setEnabled:NO];

AppCenter.enabled = false

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

[MSACAppCenter setEnabled:YES];

AppCenter.enabled = true

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

Nota

Este método solo se debe usar después AppCenter de haberse iniciado.

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.

[MSACAppCenter setNetworkRequestsAllowed:false];

AppCenter.networkRequestsAllowed = false

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

[MSACAppCenter setNetworkRequestsAllowed:true];

AppCenter.networkRequestsAllowed = true

Nota

Este valor se conserva entre los inicios.

En cualquier momento, puede comprobar si el envío de datos en el SDK de App Center está permitido o no.

[MSACAppCenter isNetworkRequestsAllowed];

AppCenter.networkRequestsAllowed

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:

[MSACAnalytics setEnabled:NO];

Analytics.enabled = false

Nota

Este método solo se debe usar después Analytics de haberse iniciado.

Comprobación de si App Center está habilitado

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

[MSACAppCenter isEnabled];

AppCenter.enabled

Nota

Este método solo se debe usar después AppCenter de que se haya iniciado, siempre devolverá false antes del inicio.

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.

[MSACAppCenter sdkVersion];

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. También es útil junto con las pause API y resume . Si espera pausarse durante mucho tiempo, puede usar un tamaño de base de datos mayor para almacenar más eventos.

Use la setMaxStorageSize API para establecer el tamaño de la base de datos local. La API es asincrónica y completionHandler se llama al iniciar los servicios de App Center. Por este motivo, setMaxStorageSize se debe llamar a antes de la llamada a AppCenter.start. Solo puede llamar a la API una vez.

// Use 20 MB for storage.
[MSACAppCenter setMaxStorageSize:(20 * 1024 * 1024) completionHandler:^(BOOL success) {
    if (!success) {
        // The success parameter is false when the size can't be honored.
    }
}];
[MSACAppCenter start:@"{Your App Secret}", withServices:@[[MSACAnalytics class]]];

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024, completionHandler: { (success) in
    if !success {
        // The success parameter is false when the size can't be honored.
    }
})
AppCenter.start(withAppSecret: "{Your App Secret}", services:[Analytics.self])

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 se puede establecer es de 20 KB.

Nota

El tamaño de almacenamiento máximo real puede ser ligeramente mayor que el valor elegido. SQLite redondea el tamaño hasta el siguiente múltiplo del tamaño de 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.

Llamadas API incorrectas

Hay muchas razones por las que la completionHandler llamada puede devolver false.

• El tamaño especificado es un valor no válido (menos de 20 KB o superior a 140 TB).
• El tamaño de la base de datos actual es mayor que el tamaño máximo especificado.
• Ya se ha llamado a la API. Puede configurarlo solo una vez por proceso.
• Se ha llamado a la API después AppCenter.start de o AppCenter.configure.

Puede comprobar advertencias y errores en la consola mediante la AppCenter etiqueta de registro para solucionar problemas de configuración.