Otras API de Android

Ajuste del nivel de registro

Puede controlar la cantidad de mensajes de registro App Center que se muestran en LogCat. Use la AppCenter.setLogLevel() API para habilitar el registro adicional durante la depuración. Los niveles de registro corresponden a los definidos en android.util.Log . De forma predeterminada, se establece en para aplicaciones no ASSERT depurables y WARN para aplicaciones depurables. Puede establecer el nivel de registro en cualquier momento que desee.

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

AppCenter.setLogLevel(Log.VERBOSE);

AppCenter.setLogLevel(Log.VERBOSE)

Identificación de instalaciones

El App Center SDK 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 la aplicación se vuelve a instalar o el usuario elimina manualmente todos los datos de la aplicación. La SIGUIENTE API es útil para fines de depuración.

AppCenter.getInstallId();

AppCenter.getInstallId()

Esta API es asincrónica, puede leer más sobre esto en nuestra guía App Center API asincrónicas.

Identificación de usuarios

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

1. Configure el SDK App Center mediante una llamada a como se describe en la guía de introducción App Center AppCenter.start(...) SDK de App Center.
2. Establezca un userID en el SDK con el código siguiente:

AppCenter.setUserId("your-user-id");

AppCenter.setUserId("your-user-id")

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

Deshabilitar todos los servicios en tiempo de ejecución

Si desea deshabilitar todos los servicios App Center a la vez, use la setEnabled() API . Cuando se deshabilita, el SDK no reenvía ninguna información a App Center.

AppCenter.setEnabled(false);

AppCenter.setEnabled(false)

Para habilitar todos los servicios a la vez, use la misma API, pero pase true como parámetro.

AppCenter.setEnabled(true);

AppCenter.setEnabled(true)

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

Esta API es asincrónica, puede leer más sobre esto en nuestra guía App Center API asincrónicas.

No permitir solicitudes de red

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

AppCenter.setNetworkRequestsAllowed(false);

AppCenter.setNetworkRequestsAllowed(false)

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

AppCenter.setNetworkRequestsAllowed(true);

AppCenter.setNetworkRequestsAllowed(true)

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

AppCenter.isNetworkRequestsAllowed();

AppCenter.isNetworkRequestsAllowed()

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

Analytics.setEnabled(false)

Compruebe si App Center está habilitado

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

AppCenter.isEnabled();

AppCenter.isEnabled()

Esta API es asincrónica, puede leer más sobre esto en nuestra guía App Center API asincrónicas.

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

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

AppCenter.getSdkVersion();

AppCenter.getSdkVersion()

Establezca propiedades personalizadas llamando a la setCustomProperties() API. Una clave válida para la propiedad personalizada debe coincidir con el patrón de expresión regular ^[a-zA-Z][a-zA-Z0-9]*$ . El valor de una propiedad personalizada puede ser uno de los siguientes tipos de Java: String Number , y boolean Date .

CustomProperties properties = new CustomProperties();
properties.set("color", "blue").set("score", 10);
AppCenter.setCustomProperties(properties);

val properties = CustomProperties()
properties.set("color", "blue").set("score", 10)
AppCenter.setCustomProperties(properties)

Puede quitar cualquier propiedad personalizada llamando a la clear() API. Esto solo quita el valor de la propiedad para un dispositivo. No quitará el nombre de propiedad del App Center portal.

CustomProperties properties = new CustomProperties();
properties.clear("score");
AppCenter.setCustomProperties(properties);

val properties = CustomProperties()
properties.clear("score")
AppCenter.setCustomProperties(properties)

Tamaño de almacenamiento

Cuando se usa App Center SDK, los registros se almacenan localmente en el dispositivo. Los registros grandes pueden ocupa 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 resume API y . Si espera que se pause durante mucho tiempo, puede usar un tamaño de base de datos mayor para almacenar más eventos.

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

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024L).thenAccept(new AppCenterConsumer<Boolean>() {

    @Override
    public void accept(Boolean success) {
        // The success parameter is false when the size can't be honored.
    }
});
AppCenter.start("{Your App Secret}", Analytics.class);

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024).thenAccept {
    // The success parameter (it) is false when the size can't be honored.
}

AppCenter.start(application, "{Your App Secret}", Analytics::class.java)

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

Agregar almacenes de distribución

De forma predeterminada, las actualizaciones desde la aplicación funcionan para las aplicaciones instaladas desde la lista definida de tiendas. Si desea distribuir la aplicación a través de almacenes que no están incluidos en la lista predefinida de almacenes, puede agregar el instalador de paquetes necesario mediante la API siguiente antes de App Center inicio:

    Set<String> stores = new HashSet<String>();
    stores.add("com.store1.packageinstaller");
    stores.add("com.store2.packageinstaller");
    Distribute.addStores(stores);

Llamadas API incorrectas

Hay muchas razones por las que la devolución de llamada puede producir un error.

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

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

API asincrónicas en el Android SDK

[! INCLUDE [API asincrónicas de Android]