Distribuir lanzamientos de paquetes de aplicaciones a los probadores - Codelab

1. Información general

imagen10.png

En este laboratorio de programación, aprenderá a distribuir versiones de Android App Bundle a evaluadores mediante Firebase App Distribution y su complemento Gradle. App Distribution proporciona un centro central para que administre las versiones preliminares de su aplicación y los probadores que invita a cada lanzamiento.

lo que aprenderás

  • Cómo vincular su aplicación Firebase a Google Play
  • Cómo empaquetar y compilar su aplicación como un paquete de aplicaciones
  • Cómo crear un lanzamiento y compartirlo con evaluadores en vivo
  • Cómo descargar y probar nuevos lanzamientos como tester

Lo que necesitarás

  • Última versión de estudio de Android
  • Un archivo de paquete firmado que generó desde Android Studio
  • Una cuenta de desarrollador de Google Play de la que sea propietario o administrador
  • Su aplicación en Google Play está configurada en el panel de la aplicación de Google Play y tiene el siguiente estado :
    • La aplicación se distribuye a una de las pistas de Google Play (pruebas internas, pruebas cerradas, pruebas abiertas o producción).
    • La revisión de la aplicación en Google Play está completa y la aplicación está publicada. Su aplicación se publica si la columna Estado de la aplicación muestra uno de los siguientes estados: Prueba interna (no prueba interna preliminar), Prueba cerrada, Prueba abierta o Producción.
  • Una dirección de correo electrónico que puede usar como evaluador para recibir nuevas invitaciones de compilación de Firebase

2. Crea un proyecto de Firebase

  1. Inicie sesión en Firebase .
  2. En la consola de Firebase, haga clic en Agregar proyecto y, a continuación, asigne el nombre "AppBundlesCodelab" a su proyecto. Recuerde el ID del proyecto para su proyecto de Firebase. Si no edita el ID del proyecto, Firebase asigna automáticamente un ID único para su proyecto.

    imagen8.png
  3. (Opcional) Cuando se le solicite, habilite Google Analytics.
  4. Complete los pasos restantes, luego haga clic en Crear proyecto .

Agregue su paquete de aplicaciones al proyecto

  1. En la consola de Firebase, haga clic en Agregar aplicación .

    imagen5.png
  2. Al registrar su aplicación, asegúrese de usar el mismo nombre de paquete que la aplicación cargada en su cuenta de desarrollador de Google Play. Finalmente, haga clic en Registrar aplicación .
  3. Complete los pasos restantes para agregar el archivo de configuración de Firebase de su aplicación ( google-services.json ) a su aplicación. Tenga en cuenta que para Android, App Distribution no tiene un SDK de Firebase para agregar a su aplicación.
  4. Haga clic en Continuar a la consola .
  1. En la consola de Firebase, vaya a la configuración de su proyecto .

    imagen2.png
  2. En la pestaña Integraciones , haga clic en Enlace en la tarjeta Google Play .
  3. Siga las instrucciones en pantalla para habilitar la integración de distribución de aplicaciones, luego seleccione su aplicación Firebase recién creada para vincularla a Google Play.

Ahora que completó estos pasos, su aplicación de Firebase se vinculará a su aplicación en su cuenta de desarrollador de Google Play siempre que los nombres de los paquetes de las aplicaciones coincidan.

3. Agregue la distribución de aplicaciones a su proyecto

Agregue el complemento Gradle de distribución de aplicaciones

Ahora, usará Android Studio para agregar App Distribution y su complemento Gradle a su aplicación.

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

Autentica tu proyecto de Firebase

Antes de poder usar el complemento de Gradle, deberá autenticar su proyecto de Firebase. Para este laboratorio de programación, iniciará sesión en su cuenta de Google mediante la CLI de Firebase .

Ejecute el siguiente comando en la raíz de su proyecto de Android:

~/your-android-project$ firebase login

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

4. Configure las propiedades de su paquete en Android Studio

En este paso, se agregará como probador de la compilación que distribuirá más adelante. Una vez que distribuye la compilación, los evaluadores reciben notificaciones por correo electrónico de Firebase invitándolos a probar la nueva compilación.

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

  • appID : el ID de aplicación de Firebase de su aplicación. Puede encontrarlo en la pestaña General de la configuración de su proyecto .
  • artifactType : el tipo de archivo de su aplicación ( AAB ).
  • testers : las direcciones de correo electrónico de sus testers. Para este laboratorio de código, agregue su propio correo electrónico para que pueda probar su 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 puede anular los valores establecidos en su build.gradle.kts pasando argumentos de línea de comandos en forma de -PappDistribution- property-name = property-value .

5. Cree y distribuya un lanzamiento

  1. Ejecute la tarea bundle Variant Gradle para crear su archivo de paquetes de aplicaciones:
    $ ./gradlew :base:bundleRelease
    
  2. Ubique el paquete en el directorio de compilación de su aplicación (la ubicación predeterminada es app/build/outputs/bundle/release ).
  3. Para distribuir el lanzamiento, crea los objetivos bundleRelease y appDistributionUploadRelease con el contenedor de Gradle de tu proyecto. Incluya el token de Firebase (el que recibió en el paso 3: Agregar distribución de aplicaciones a su aplicación).
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

Los evaluadores ahora recibirán invitaciones por correo electrónico para descargar y probar la compilación. Como desarrollador, ahora puede monitorear la compilación en la pestaña Versiones del panel de distribución de aplicaciones.

6. Descarga y prueba tu lanzamiento

En esta sección, se configurará como probador para descargar la versión que distribuyó. Como evaluador, deberá autenticar su dispositivo de prueba y habilitar el uso compartido interno de aplicaciones en la aplicación Google Play Store.

  1. En su dispositivo de prueba, inicie sesión en su cuenta de correo electrónico de prueba y abra la invitación de Firebase.

    imagen6.png
  2. Inicie sesión con su cuenta de Google y acepte la invitación para probar la versión distribuida. Como opción, también puede descargar Firebase App Tester , que evita que las versiones descargadas se agreguen a la carpeta Downloads de su dispositivo. También muestra información adicional sobre los lanzamientos, como el progreso de la descarga y la versión del lanzamiento.

    imagen9.png
  3. Toque Descargar en el lanzamiento para instalarlo desde Play Store.
  4. Cuando se le solicite, complete los pasos restantes para habilitar el uso compartido interno de aplicaciones (las instrucciones se muestran en su dispositivo de prueba y solo deben completarse una vez).

Una vez que se complete la descarga, su lanzamiento aparecerá automáticamente como un acceso directo en la pantalla de inicio de su dispositivo.

7. ¡Felicitaciones!

Acaba de usar Firebase App Distribution para cargar un paquete de aplicaciones y distribuir una versión a los evaluadores.

Próximos pasos