Introducción a Android

El SDK App Center usa una arquitectura modular para que pueda usar cualquiera o todos los servicios.

Puede encontrar información sobre los datos recopilados por App Center datos recopiladospor los SDK de App Center, Reglamento general de protección de datos ylas páginas de preguntas más frecuentes.

Vamos a empezar a configurar los App Center Android SDK en la aplicación para usar App Center Analytics y App Center bloqueos. Para agregar App Center Distribute a la aplicación, consulte la documentación de App Center Distribute.

1. Prerrequisitos

Asegúrese de que se cumplen los siguientes requisitos previos antes de empezar:

• El proyecto de Android se configura en Android Studio.
• Tiene como destino dispositivos que ejecutan android versión 5.0 (nivel de API 21) o posterior.

2. Cree la aplicación en App Center Portal para obtener el secreto de la aplicación.

Si ya ha creado la aplicación en el portal App Center, puede omitir este paso.

1. Diríjase a appcenter.ms.
2. Regístrese o inicie sesión y haga clic en el botón Agregar nuevo en la esquina superior derecha de la página y seleccione Agregar nueva aplicación en el menú desplegable.
3. Escriba un nombre y una descripción opcional para la aplicación.
4. Seleccione Android como sistema operativo y Java como plataforma.
5. Haga clic en el botón Agregar nueva aplicación.

Una vez que haya creado una aplicación, puede obtener su secreto de aplicación en la Tareas iniciales en 2. Inicie el SDK. O bien, puede hacer clic Configuración y, en la esquina superior derecha, hacer clic en los puntos verticales triples y seleccionar Copiar secreto de aplicación para obtener el secreto de aplicación.

3. Agregar los módulos App Center SDK

1. Abra el archivo build.gradle del nivel de aplicación del proyecto ( app/build.gradle ) y agregue las siguientes líneas después de apply plugin . Incluya las dependencias que desee en el proyecto. Cada módulo del SDK debe agregarse como una dependencia independiente en esta sección. Si desea usar App Center Analytics y bloqueos, agregue las líneas siguientes:

dependencies {
    def appCenterSdkVersion = '4.1.0'
    implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
    implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
}

2. Asegúrese de desencadenar una sincronización de Gradle en Android Studio.

Ahora que ha integrado el SDK en la aplicación, es el momento de iniciar el SDK y hacer uso de App Center.

3. Si usa la copia de seguridad automática para evitar obtener información incorrecta sobre los dispositivos, siga estos pasos:

a. Cree appcenter_backup_rule.xml archivo en la carpeta res/xml.

b. Abra el archivo de AndroidManifest.xmlproyecto. Agregue el android:fullBackupContent atributo al <application> elemento . Debe apuntar al archivo appcenter_backup_rule.xmlde recursos.

android:fullBackupContent="@xml/appcenter_backup_rule"

c. Agregue las siguientes reglas de copia de seguridad alappcenter_backup_rule.xml de copia de seguridad:

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
    <exclude domain="sharedpref" path="AppCenter.xml"/>
    <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
    <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
    <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
    <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
</full-backup-content>

4. Iniciar el SDK

4.1 Agregar el método start()

Para usar App Center, debe participar en los módulos que desea usar. De forma predeterminada, no se inicia ningún módulo y debe llamar explícitamente a cada uno de ellos al iniciar el SDK.
Inserte la siguiente línea dentro de la devolución de llamada -callback de la clase de actividad principal de la aplicación para usar onCreate App Center Analytics y App Center bloqueos:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);

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

Si necesita iniciar los servicios App Center por separado, debe hacer lo siguiente:

1. Configúrelo o inéntelo con el secreto de la aplicación.
2. Si se puede llamar al código varias veces, compruebe si el App Center ya está configurado.
3. Inicie los servicios necesarios sin el secreto de aplicación.

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics.class);
    AppCenter.start(Crashes.class);
}

AppCenter.configure(application, "{Your App Secret}");
if (AppCenter.isConfigured()) {
    AppCenter.start(Analytics::class.java);
    AppCenter.start(Crashes::class.java);
}

Si tiene más de un punto de entrada a la aplicación (por ejemplo, una actividad de vínculo profundo, un servicio o un receptor de difusión), llame a en la clase personalizada de la aplicación o en cada start punto de entrada. En el último caso, compruebe si App Center ya está configurado antes de la start llamada:

if (!AppCenter.isConfigured())) {
  AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class);
}

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

4.2 Reemplazar el marcador de posición por el secreto de aplicación

Asegúrese de reemplazar el {Your App Secret} texto por el valor real de la aplicación. El secreto de la aplicación se puede encontrar en Tareas iniciales página o Configuración en el portal App Center aplicación.

La Tareas iniciales contiene el ejemplo de código anterior con el secreto de aplicación en él, solo tiene que copiar y pegar el ejemplo completo.

En el ejemplo anterior se muestra cómo usar el método e incluir start() tanto App Center Analytics como App Center bloqueos.

Si no desea usar uno de los dos servicios, quite el parámetro correspondiente de la llamada al método anterior.

A menos que especifique explícitamente cada módulo como parámetros en el método start, no puede usar ese App Center servicio. Además, la API solo se puede usar una vez en el ciclo de vida de la aplicación: todas las demás llamadas registrarán una advertencia en la consola y solo estarán disponibles los módulos incluidos en la primera start() llamada.

Por ejemplo: si solo desea incorporarse a App Center Analytics, debe modificar la llamada start() API de la siguiente manera:

AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class);

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

Android Studio sugiere automáticamente las instrucciones de importación necesarias una vez que se inserta el método , pero si ve un error que indica que los nombres de clase no se reconocen, agregue las siguientes líneas a las instrucciones import de la clase start() de actividad:

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;

import com.microsoft.appcenter.AppCenter
import com.microsoft.appcenter.analytics.Analytics
import com.microsoft.appcenter.crashes.Crashes

Está todo listo para visualizar los datos de Análisis y bloqueos en el portal que el SDK recopila automáticamente.

Consulte la documentación de App Center Analytics y App Center Crashes para aprender a personalizar y usar funcionalidades más avanzadas de ambos servicios.

Para obtener información sobre cómo empezar a trabajar con las actualizaciones desde la aplicación, lea la documentación de App Center Distribute.