Distribuye versiones de paquetes de aplicaciones a los verificadores: Codelab

1. Descripción general

image10.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), Pruebas cerradas, Pruebas abiertas o Producción.
  • Una dirección de correo electrónico que puedas 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 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 tu app, asegúrate de usar el mismo nombre de paquete que la app que se subió 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 (google-services.json) a tu app. Ten en cuenta que, para 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 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 se que los nombres de paquetes 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 (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 Gradle de configuración a nivel del proyecto (android/settings.gradle.kts), agrega el repositorio de 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 del nivel de la app (android/app/build.gradle.kts), 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 del paquete en Android Studio

En este paso, te agregarás como verificador para 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: De tus verificadores direcciones de correo electrónico. En este codelab, agrega tu propio correo electrónico para que puedas 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 si pasas los argumentos de la línea de comandos con el formato -PappDistribution-property-name=property-value.

5. Compila y distribuye una versión

  1. Ejecuta la tarea de Gradle bundleVariant para compilar tu archivo de paquetes de aplicaciones:
    $ ./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 Distribución de aplicaciones.

6. Descarga y prueba la 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.

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