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 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 abierto el proyecto de inicio en Android Studio.

4. Crea un proyecto de Firebase console

Agrega 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.

Agrega 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 a fin de 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. Después de que se descargue el archivo, puedes omitir los siguientes pasos que se muestran en la consola (ya se completaron 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 que estás en la vista "Android" y busca la pestaña "Gradle Scripts" y abre el archivo Gradle del módulo (a nivel de la app) (por lo general, app/build.gradle.kts).
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".

Cómo sincronizar tu proyecto con archivos de Gradle

Para asegurarte de que todas las dependencias estén disponibles para tu app, sincroniza tu proyecto con los archivos de Gradle seleccionando 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 Android para Firebase App Distribution a tu app y mostrarás alertas en la app a tus 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 "Codelab de Firebase" proyecto (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 en el que se les pide a los verificadores que accedan a App Distribution con su Cuenta de Google.

La habilitación de las alertas es un proceso único en el dispositivo de prueba que persiste en todas las actualizaciones de la app. Las alertas permanecerán habilitadas en el dispositivo de prueba hasta que se desinstale la app o se llame 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 nueva compilación es un App Bundle (AAB), redirecciona al verificador a Play Store para completar el proceso de actualización.
6. Si la nueva compilación es un APK, el SDK la descarga en segundo plano y le pide al verificador que la instale cuando se complete la descarga. El SDK envía notificaciones del progreso de descarga al usuario mediante NotificationManager.. Puedes agregar tu propio indicador de progreso adjuntando 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, distribuirás la compilación a los verificadores con Firebase console para compilar la app y probar la implementación.

Cómo compilar 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 de firma de la app.

Cómo distribuir tu app a los verificadores

Para distribuir tu app a los verificadores, sube el archivo APK con Firebase console como se indica a continuación:

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. Si quieres obtener más información para crear grupos de verificadores, consulta Cómo agregar y quitar 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 los verificadores que agregaste en la versión de tu app.

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

Aceptar 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 verificador de Firebase App Distribution que aparece, accede con tu Cuenta de Google y presiona Aceptar invitación. Ahora puedes ver la versión que te invitaron a probar.

Descarga la versión del dispositivo de prueba

Cuando navegas a la app del codelab AppDistribution, puedes ver que la versión está lista para descargar.

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 versionName a "1.1" y versionCode a 2 en el archivo Gradle de tu módulo (nivel de app) (por lo general, app/build.gradle).
2. Compila el APK con el proceso normal. Debes firmar el APK con tu clave de depuración o de firma de la app.
3. Sube este nuevo APK a Firebase console, vuelve a agregar tu correo electrónico como verificador y haz clic en Distribuir.

Alertas de compilación de prueba

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 la app con las alertas integradas.

7. Personaliza el acceso de los verificadores

Los métodos signInTester/signOutTester e isTesterSignedIn te brindan más flexibilidad para personalizar la experiencia de acceso del verificador, de modo que pueda coincidir mejor con el aspecto de tu app.

En el siguiente ejemplo, se comprueba si el verificador ya accedió a su cuenta de Firebase App Distribution, de manera que puedes mostrar tu IU de acceso solo para los verificadores que aún no hayan accedido. 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 función "Mostrar 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

• Cómo usar el complemento Fastlane
• Usa 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