Codelab: Distribuye versiones de paquetes de aplicaciones a los verificadores

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 centro central para que administres las versiones previas al lanzamiento de tu app y los verificadores que invitas 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 en vivo
  • 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 seas propietario o administrador
  • Tu app en Google Play está configurada 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 está publicada si en la columna Estado de la app se muestra uno de los siguientes estados: Pruebas internas (no pruebas internas en borrador), Prueba cerrada, Prueba abierta o Producción.
  • Una dirección de correo electrónico que puedas usar como verificador para recibir invitaciones de compilaciones nuevas de Firebase

2. Crea un proyecto de Firebase

  1. Accede a Firebase.
  2. En Firebase console, haz clic en Agregar proyecto y, luego, asígnale el nombre "AppBundlesCodelab". Recuerda el ID de tu proyecto de Firebase. Si no editas el ID de proyecto, Firebase le asignará automáticamente un ID único.

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

Agrega tu paquete de aplicación al proyecto

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

    image5.png
  2. Cuando registres la app, asegúrate de usar el mismo nombre de paquete que usaste para la app que subiste 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). 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 la 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; luego, selecciona la app de Firebase que acabas de crear para vincularla a Google Play.

Ahora que completaste estos pasos, tu app de Firebase se vinculará a tu 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 App Distribution para Gradle

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

  1. En el archivo Gradle a nivel del proyecto (android/build.gradle.kts), agrega el complemento de App Distribution para Gradle 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 Gradle (android/settings.gradle.kts) de la configuración a nivel del 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 la app, agrega el complemento de App Distribution al bloque plugins.
    plugins {
         //...
    
         // Add the App Distribution plugin
         id("com.google.firebase.appdistribution")
    }
    
  4. Si estás detrás de un proxy o firewall empresarial, agrega la siguiente propiedad del sistema de Java que permite que App Distribution suba tus distribuciones a Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

Cómo autenticar tu proyecto de Firebase

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

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, luego, incluye los siguientes parámetros:

  • appID: Es el ID de app de Firebase de tu app. Puedes encontrarlo en la pestaña General de la Configuración del proyecto.
  • artifactType: Es el tipo de archivo de tu app (AAB).
  • testers: Las direcciones de correo electrónico de tus verificadores. En este codelab, agrega tu propio correo electrónico para que puedas probar tu 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 con el formato -PappDistribution-property-name=property-value.

5. Compila y distribuye una versión

  1. Ejecuta la tarea bundleVariant de Gradle para compilar el archivo de paquetes de tu app:
    $ ./gradlew :base:bundleRelease
    
  2. Localiza 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 los destinos bundleRelease y appDistributionUploadRelease 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
    

Ahora, los verificadores 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. Descarga y prueba 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 el 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, que evita que se agreguen las versiones descargadas a la carpeta Downloads de tu dispositivo. También muestra información adicional sobre las versiones, como el progreso de la descarga y la versión.

    image9.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 completar una vez).

Una vez que 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