Codelab: Alerta a los verificadores sobre las nuevas versiones de tu app con el SDK de Android para Firebase App Distribution

1. Descripción general

Te damos la bienvenida al codelab Cómo integrar el SDK de Firebase App Distribution en tu app para Android. En este codelab, agregarás el SDK de App Distribution para Android a tu app para mostrar alertas en la app a los verificadores cuando haya compilaciones nuevas disponibles para descargar. Aprenderás a usar una configuración básica y una personalizada para que los verificadores accedan y reciban actualizaciones. Luego, enviarás una nueva versión a App Distribution y activarás una alerta de compilación nueva directamente en la app.

Qué aprenderás

• Cómo usar App Distribution para distribuir una app previa al lanzamiento a los verificadores
• Cómo integrar el SDK de Android para App Distribution en tu app
• Cómo alertar a un verificador cuando hay una nueva compilación previa al lanzamiento lista para instalar
• Cómo personalizar el SDK para que se adapte a tus necesidades de pruebas

Requisitos

• La versión más reciente de Android Studio
• Código de muestra.
• Un dispositivo de prueba con Android 4.4 o versiones posteriores y los Servicios de Google Play 9.8 o versiones posteriores, o un emulador con Servicios de Google Play 9.8 o versiones posteriores
• Si usas un dispositivo, un cable de conexión.

2. Obtén el código de muestra

Clona el repositorio de GitHub desde la línea de comandos.

$ git clone https://github.com/FirebaseExtended/codelab-appdistribution-android.git

Si no tienes Git instalado, también puedes descargar el proyecto de muestra desde su página de GitHub o haciendo clic en este vínculo.

3. Importa la app de partida

En Android Studio, selecciona el directorio codelab-appdistribution-android/start () de la descarga del código de muestra (File > Open > …/codelab-appdistribution-android/start).

Ahora deberías tener el proyecto de partida abierto en Android Studio.

4. Crea un proyecto de Firebase console

Agregar un proyecto de Firebase nuevo

1. Abre Firebase console.
2. Selecciona Agregar proyecto y asígnale el nombre “Firebase Codelab”.

No es necesario que habilites Google Analytics en este proyecto.

3. Haz clic en Crear proyecto.

Cómo agregar una app a Firebase

Registra tu app con Firebase. Usa “com.google.firebase.appdistributioncodelab” como nombre del paquete.

Agrega el archivo google-services.json a tu app

Después de agregar el nombre del paquete y seleccionar Registrar, sigue estos pasos para agregar google-services.json a tu app:

1. Haz clic en Descargar google-services.json para obtener el archivo de configuración de Firebase para Android.
2. Copia el archivo google-services.json en el directorio app de tu proyecto.
3. Una vez que se descargue el archivo, puedes omitir los siguientes pasos que aparecen en la consola (ya se realizaron automáticamente en el proyecto build-android-start).

Actualiza el ID de aplicación para que coincida con tu app de Firebase

1. En el menú de la izquierda (pestaña Project), asegúrate de estar en la sección "Android". Visualiza y ubica "Gradle Scripts" y abre el archivo Gradle (generalmente app/build.gradle.kts) de tu módulo (al nivel de la app).
2. Cambia la propiedad applicationId para que coincida con el ID de aplicación de tu app de Firebase. Debe ser "com.google.firebase.appdistributioncodelab".

Sincroniza tu proyecto con archivos Gradle

Para asegurarte de que todas las dependencias estén disponibles para tu app, sincroniza tu proyecto con archivos Gradle y selecciona File > Sync Project with Gradle Files en la barra de herramientas de Android Studio

5. Configura alertas de compilación nuevas en la app con el SDK de Android para App Distribution

En este paso, agregarás el SDK de Firebase App Distribution para Android a tu app y mostrarás alertas en la app a los verificadores cuando haya nuevas compilaciones de tu app disponibles para instalar. Para ello, asegúrate de haber habilitado la API de Firebase App Testers para tu proyecto "Firebase Codelab" (en la consola de Google Cloud). Debes acceder con la misma cuenta y seleccionar el proyecto correcto en el menú desplegable de la parte superior.

Cómo configurar alertas en la app

El SDK de Android para App Distribution ofrece dos formas de configurar las alertas de compilación en la app para los verificadores:

• Una configuración básica de alertas, que incluye un diálogo compilado previamente para mostrar a los verificadores.
• Una configuración de alertas avanzada, que te permite personalizar tu interfaz de usuario (IU).

Comenzaremos con la configuración básica de alertas. Puedes usar updateIfNewReleaseAvailable para mostrar un diálogo de habilitación de alertas compilado previamente a los verificadores que aún no las hayan habilitado y, luego, verificar si hay una compilación nueva disponible. Los verificadores habilitan las alertas accediendo a una cuenta que tenga acceso a la app en App Distribution. Cuando se llama al método, este invoca la siguiente secuencia:

1. Comprueba si un verificador habilitó las alertas. De lo contrario, el método muestra un diálogo compilado previamente que les solicita a los verificadores que accedan a App Distribution con su Cuenta de Google.

La habilitación de alertas es un proceso único en el dispositivo de prueba que persiste en todas las actualizaciones de tu app. Las alertas permanecen habilitadas en el dispositivo de prueba hasta que se desinstala la app o se llama al método signOutTester.

2. Busca compilaciones disponibles recientemente para que las instale el verificador.
3. Muestra una alerta compilada previamente que le solicita al verificador que descargue la versión más reciente.
4. Verifica el nuevo tipo de compilación antes de continuar con la actualización:
5. Si la compilación nueva es un paquete de aplicación (AAB), redirecciona al verificador a Play Store para completar el proceso de actualización.
6. Si la compilación nueva es un APK, el SDK la descarga en segundo plano y le solicita al verificador que la instale cuando finalice la descarga. El SDK envía notificaciones de progreso de descarga al usuario con NotificationManager.. Puedes agregar tu propio indicador de progreso si adjuntas un controlador onProgressUpdate a la tarea updateIfNewReleaseAvailable.

Puedes llamar a updateIfNewReleaseAvailable() en cualquier momento de tu app. Por ejemplo, puedes llamar a updateIfNewReleaseAvailable() durante el método onResume() de MainActivity:

Abre MainActivity.kt y crea el método onResume() de la siguiente manera:

MainActivity.kt

override fun onResume() {
    super.onResume()
    checkForUpdate()
}

Ahora, implementemos el método checkForUpdate().

MainActivity.kt

   private fun checkForUpdate() {
        firebaseAppDistribution.updateIfNewReleaseAvailable()
            .addOnProgressListener { updateProgress ->
                // (Optional) Implement custom progress updates in addition to
                // automatic NotificationManager updates.
            }
            .addOnFailureListener { e ->
                if (e is FirebaseAppDistributionException) {
                    // Handle exception.
                }
            }
    }

6. Compila e invita a verificadores para que descarguen tu app

En este paso, compilarás la app y probarás la implementación distribuyendo la compilación a los verificadores con Firebase console.

Crea tu app

Cuando tengas todo listo para distribuir una versión previa al lanzamiento de tu app a los verificadores, compila el APK con el proceso normal. Debes firmar el APK con tu clave de depuración o la clave de firma de la app.

Distribuye tu app a los verificadores

Para distribuir tu app a los verificadores, sube el archivo APK con Firebase console:

1. Abre la página App Distribution de Firebase console. Selecciona tu proyecto de Firebase cuando se te solicite.
2. En la página Lanzamientos, selecciona la app que quieras distribuir desde el menú desplegable.

3. Haz clic en Comenzar.

4. Arrastra el archivo APK a la consola para subirlo.
5. Cuando la carga finalice, especifica los grupos de verificadores y los verificadores individuales que quieres que reciban la compilación. (Agrega tu correo electrónico para recibir la invitación). Luego, agrega las notas de la versión de la compilación. Para obtener más información sobre cómo crear grupos de verificadores, consulta Agrega y quita verificadores.

6. Haz clic en Distribuir a fin de hacer que la compilación esté disponible para los verificadores.

En Firebase console, ahora puedes ver a los verificadores que agregaste en la versión de tu app.

Dado que incluiste tu dirección de correo electrónico, recibirás un mensaje de Firebase App Distribution en el que se te invitará a probar la app. Ya eres el primer verificador. Sigue las instrucciones de Acepta la invitación para configurarte como verificador en tu dispositivo de prueba.

Acepta la invitación

Para descargar y probar la versión, primero debes aceptar la invitación.

1. En tu dispositivo de prueba para Android, abre el correo electrónico que se envió desde Firebase App Distribution y presiona Comenzar.
2. En la app web de verificadores de Firebase App Distribution que aparece, accede con tu Cuenta de Google y presiona Aceptar invitación. Ahora puedes ver la versión que tienes la invitación para probar.

Descarga la versión desde el dispositivo de prueba

Cuando navegues a la app del codelab de AppDistribution, verás que la versión está lista para descargarse.

1. Presiona Descargar y, luego, instala y ejecuta la app.
2. Cuando se inicia la app, se te solicita que habilites las alertas de compilación nuevas. Presiona Activar.

3. Accede con tu cuenta de verificador.

Volverás a la app. La próxima vez que la ejecutes, no necesitarás acceder ni aceptar alertas.

Distribuye una actualización a los verificadores

1. Actualiza tu versionName a “1.1” y versionCode a 2 en el archivo Gradle (generalmente app/build.gradle) de tu módulo (nivel de app).
2. Compila el APK con el proceso normal. Debes firmar el APK con tu clave de depuración o la clave de firma de la app.
3. Sube este APK nuevo a Firebase console, vuelve a agregar tu correo electrónico como verificador y haz clic en Distribuir.

Cómo probar alertas de compilación

1. Asegúrate de haber cerrado la app si estaba abierta.
2. Reinicia la app.
3. Cuando se reinicie la app, recibirás una alerta de nueva versión disponible.

4. Para recibir la versión más reciente, haz clic en Actualizar.
5. Si se te solicita, elige la opción para habilitar las instalaciones desde fuentes desconocidas.
6. En la siguiente pantalla, haz clic en Install (o Update).

7. ¡Felicitaciones! Pudiste actualizar tu app con las alertas integradas.

7. Personaliza el acceso de los verificadores

Los métodos signInTester/signOutTester y isTesterSignedIn te ofrecen más flexibilidad para personalizar la experiencia de acceso de los verificadores a fin de que coincida mejor con el estilo de la app.

En el siguiente ejemplo, se comprueba si el verificador ya accedió a su cuenta de verificador de Firebase App Distribution, de modo que puedas mostrar la IU de acceso solo a los verificadores que aún no accedieron. Después de que el verificador haya accedido, puedes llamar a checkForUpdate para comprobar si tiene acceso a una compilación nueva.

Inhabilitamos la verificación de actualizaciones automáticamente en onResume. Para ello, comentamos la llamada a checkForUpdate().

MainActivity.kt

override fun onResume() {
        super.onResume()
        //checkForupdate()
    }

En su lugar, checkForUpdate() ya se agregó en el OnClickListener de updatebutton.

Ahora, implementemos nuestro método signIn(), que hará que el usuario acceda si sale de su cuenta o que lo hará si ya accedió.

MainActivity.kt

    private fun signIn() {
        if (isTesterSignedIn()) {
            firebaseAppDistribution.signOutTester()
            configureUpdateButton()
            configureSigninButton()
        } else {
            firebaseAppDistribution.signInTester()
        }
    }

Por último, implementemos el método isTesterSignedIn.

MainActivity.kt

    private fun isTesterSignedIn() : Boolean {
        return firebaseAppDistribution.isTesterSignedIn
    }

Compila y prueba tu implementación

8. ¡Felicitaciones!

Compilaste la "pantalla de alertas en la app" en una app con el SDK de Android para Firebase App Distribution.

Temas abordados

• Firebase App Distribution
• SDK de Android para las alertas nuevas de Firebase App Distribution

Próximos pasos

• Usa el complemento Fastlane
• Cómo usar las herramientas de la CLI
• Cómo usar Gradle

Más información

• Firebase.google.com

¿Tienes alguna pregunta?

• Stack Overflow “firebase-app-distribution”
• Canal de Slack para la comunidad de Firebase #app-distribution

Informar problemas

• Problemas de GitHub