Distribuye versiones de paquetes de aplicaciones a los verificadores: Codelab

1. Descripción general

imagen10.png

En este codelab, aprenderás a distribuir versiones de Android App Bundle a los verificadores con Firebase App Distribution y su complemento de Gradle. App Distribution proporciona un espacio central para que administres las versiones previas al lanzamiento de tu app y los verificadores que invites a cada versión.

Qué aprenderás

  • Cómo vincular tu app de Firebase a Google Play
  • Cómo empaquetar y compilar tu app como un paquete de aplicación
  • Cómo crear una versión y compartirla con verificadores reales
  • Cómo descargar y probar nuevas versiones como verificador

Requisitos

  • La versión más reciente de Android Studio
  • Un archivo de paquete firmado que generaste desde Android Studio
  • Una cuenta de desarrollador de Google Play de la que eres propietario o administrador
  • Tu app en Google Play se configura en el panel de apps de Google Play y tiene el siguiente estado:
    • La app se distribuye en uno de los segmentos de Google Play (pruebas internas, pruebas cerradas, pruebas abiertas o producción).
    • La revisión de la app en Google Play debe estar completa y la app debe estar publicada. La app estará publicada si en la columna Estado de la app se muestra uno de los siguientes estados: Prueba interna (no prueba interna en borrador), Prueba cerrada, Prueba abierta o Producción.
  • Una dirección de correo electrónico que puedes usar como verificador para recibir invitaciones de compilación nuevas de Firebase

2. Crea un proyecto de Firebase

  1. Accede a Firebase.
  2. En Firebase console, haz clic en Add Project y, luego, asigna el nombre “AppBundlesCodelab” a tu proyecto. Recuerda el ID de tu proyecto de Firebase. Si no editas el ID del proyecto, Firebase le asignará automáticamente un ID único.

    imagen8.png
  3. (Opcional) Cuando se te solicite, habilita Google Analytics.
  4. Completa los pasos restantes y, luego, haz clic en Crear proyecto.

Agrega el paquete de aplicación al proyecto

  1. En Firebase console, haz clic en Agregar app.

    imagen5.png
  2. Cuando registres tu app, asegúrate de usar el mismo nombre de paquete que la app que se sube a tu cuenta de desarrollador de Google Play. Por último, haz clic en Registrar app.
  3. Completa los pasos restantes para agregar el archivo de configuración de Firebase de tu app (google-services.json) a ella. Ten en cuenta que, en el caso de Android, App Distribution no tiene un SDK de Firebase para agregar a tu app.
  4. Haz clic en Ir a la consola.
  1. En Firebase console, ve a Configuración del proyecto.

    image2.png
  2. En la pestaña Integraciones, haz clic en Vincular en la tarjeta de Google Play.
  3. Sigue las instrucciones en pantalla para habilitar la integración de App Distribution y, luego, selecciona la app de Firebase que acabas de crear para vincularla a Google Play.

Ahora que completaste estos pasos, la app de Firebase se vinculará a la app en tu cuenta de desarrollador de Google Play, siempre y cuando los nombres de los paquetes de las apps coincidan.

3. Agrega App Distribution a tu proyecto

Agrega el complemento de Gradle para App Distribution

Ahora, usarás Android Studio para agregar App Distribution y su complemento de Gradle a tu app.

  1. En el archivo Gradle (android/build.gradle.kts) de nivel de proyecto, agrega el complemento de Gradle para App Distribution al bloque plugins.
    plugins {
     //...

     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution") version "4.0.0" apply false
}
  2. En el archivo de configuración de Gradle (android/settings.gradle.kts) a nivel de proyecto, agrega el repositorio Maven de Google al bloque pluginManagement.
     pluginManagement {
     // Check that you have Google's Maven repository (if not, add it).
     repositories {
         google()
         mavenCentral()
     }
 }
  3. En el archivo Gradle (android/app/build.gradle.kts) de nivel de app, agrega el complemento de App Distribution al bloque plugins.
    plugins {
     //...

     // Add the App Distribution plugin
     id("com.google.firebase.appdistribution")
}
  4. Si usas un proxy o firewall corporativo, agrega la siguiente propiedad del sistema Java que permite que App Distribution suba tus distribuciones a Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password

Autentica el proyecto de Firebase

Para poder usar el complemento de Gradle, deberás autenticar tu proyecto de Firebase. En este codelab, usarás Firebase CLI para acceder a tu Cuenta de Google.

Ejecuta el siguiente comando en la raíz de tu proyecto de Android:

~/your-android-project$ firebase login

La documentación de referencia contiene más detalles.

4. Cómo configurar las propiedades de tu paquete en Android Studio

En este paso, te agregarás como verificador de la compilación que distribuirás más adelante. Una vez que distribuyas la compilación, los verificadores recibirán notificaciones por correo electrónico de Firebase en las que se los invitará a probar la compilación nueva.

En tu app/build.gradle.kts, agrega una sección firebaseAppDistribution y, además, incluye los siguientes parámetros:

  • appID: Es el ID de app de Firebase de la app. Puedes encontrarlo en la pestaña General de Configuración del proyecto.
  • artifactType: El tipo de archivo de la app (AAB).
  • testers: Direcciones de correo electrónico de los verificadores. En este codelab, agrega tu propio correo electrónico para poder probar la compilación una vez que se distribuya.

Por ejemplo:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

Como opción, también puedes anular los valores establecidos en tu build.gradle.kts pasando argumentos de línea de comandos en el formato de -PappDistribution-property-name=property-value.

5. Cómo compilar y distribuir una versión

  1. Ejecuta la tarea de Gradle bundleVariant para compilar tu archivo de paquetes de aplicaciones:
    $ ./gradlew :base:bundleRelease
  2. Ubica el paquete en el directorio de compilación de tu aplicación (la ubicación predeterminada es app/build/outputs/bundle/release).
  3. Para distribuir la versión, compila bundleRelease y appDistributionUploadRelease de destino con el wrapper de Gradle de tu proyecto. Incluye el token de Firebase (el que recibiste en el paso 3: Agrega App Distribution a tu app).
    export FIREBASE_TOKEN=your_firebase_token

./gradlew --stop // Only needed for environment variable changes

./gradlew bundleRelease appDistributionUploadRelease

Los verificadores ahora recibirán invitaciones por correo electrónico para descargar y probar la compilación. Como desarrollador, ahora puedes supervisar la compilación en la pestaña Versiones del panel de App Distribution.

6. Cómo descargar y probar tu versión

En esta sección, te configurarás como verificador para descargar la versión que distribuiste. Como verificador, deberás autenticar tu dispositivo de prueba y habilitar el uso compartido interno de apps en la app de Google Play Store.

  1. En tu dispositivo de prueba, accede a tu cuenta de correo electrónico de verificador y abre la invitación de Firebase.

    imagen6.png
  2. Accede con tu Cuenta de Google y acepta la invitación para probar la versión distribuida. Como opción, también puedes descargar Firebase App Tester, lo que evita que las versiones descargadas se agreguen a la carpeta Downloads del dispositivo. También muestra información adicional sobre las versiones, como el progreso de la descarga y la versión de actualización.

    imagen9.png
  3. Presiona Descargar en la versión para instalarla desde Play Store.
  4. Cuando se te solicite, completa los pasos restantes para habilitar el uso compartido interno de apps (las instrucciones se muestran en tu dispositivo de prueba y solo debes completarlas una vez).

Cuando se complete la descarga, la versión aparecerá automáticamente como un acceso directo en la pantalla principal del dispositivo.

7. ¡Felicitaciones!

Acabas de usar Firebase App Distribution para subir un paquete de aplicación y distribuir una versión a los verificadores.

Próximos pasos