Otras API de React Native

  • Artículo

Importante

Visual Studio App Center está programado para la 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.

Ajuste del nivel de registro

Puede controlar la cantidad de mensajes de registro que se muestran desde App Center. Los mensajes de registro se muestran en la consola en iOS y LogCat en Android. Use la API para habilitar el registro adicional durante la setLogLevel depuración. El nivel predeterminado es LogLevel.ASSERT para el entorno de iOS App Store y las compilaciones de versión de Android. De lo contrario, se establece en LogLevel.WARNING.

Para generar todos los mensajes de registro, use LogLevel.VERBOSE.

import AppCenter from 'appcenter';

await AppCenter.setLogLevel(AppCenter.LogLevel.VERBOSE);

Nota

La API de JavaScript setLogLevel no puede aumentar el registro para el código de inicio de la aplicación, antes de cargar JavaScript.

Si desea aumentar el registro para el inicio de la aplicación, use las API nativas setLogLevel de App Center.

En iOS, llame [MSACAppCenter setLogLevel: MSACLogLevelVerbose]; a antes de cualquier llamada a [AppCenterReactNative register]; (o AppCenterReactNativeAnalytics o AppCenterReactNativeCrashesAppCenterReactNativePush) en appDelegate.m del proyecto. Debe agregar @import AppCenter; si falta en ese archivo.

En Android, llame AppCenter.setLogLevel(android.util.Log.VERBOSE); a antes SoLoader.init en la onCreate devolución de llamada en MainApplication.java.

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 se genera uno nuevo solo cuando la aplicación se vuelve a instalar o el usuario elimina manualmente todos los datos de la aplicación en Android. La SIGUIENTE API es útil para fines de depuración.

import AppCenter from 'appcenter';

const installId = await AppCenter.getInstallId();   // Returned as a string

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. Configure el SDK de App Center como se describe en la guía de introducción del SDK de App Center.
  2. Establezca un userID elemento en el SDK con el código siguiente:
AppCenter.setUserId("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á para la agregación o 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 que se inicie 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 setEnabled() API. Cuando se deshabilita, el SDK no reenvía ninguna información a App Center.

import AppCenter from 'appcenter';

await AppCenter.setEnabled(false);

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

await AppCenter.setEnabled(true);

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

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.

await AppCenter.setNetworkRequestsAllowed(false);

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

await AppCenter.setNetworkRequestsAllowed(true);

Nota

Este valor se conserva entre los inicios.

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

await AppCenter.isNetworkRequestsAllowed();

Nota

El valor guardado en SharedPreferences se omite hasta AppCenter que se inicia en la plataforma Android. Devolverá el último valor establecido con setNetworkRequestsAllowed o true si el valor no se cambió antes de que Se inicie AppCenter.

Cambio del estado del servicio en tiempo de ejecución

Puede habilitar o deshabilitar el servicio en tiempo de ejecución con el código siguiente:

await AppCenter.Analytics.setEnabled(false);

Comprobación de si App Center está habilitado

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

const enabled = await AppCenter.isEnabled();

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.getSdkVersion();