Distribuir lanzamientos de paquetes de aplicaciones a los evaluadores - Codelab

1. Información general

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

lo que aprenderás

• Cómo vincular tu aplicación Firebase a Google Play
• Cómo empaquetar y crear su aplicación como un paquete de aplicaciones
• Cómo crear una versión y compartirla con evaluadores en vivo
• Cómo descargar y probar nuevas versiones como tester

Lo que necesitarás

• Última versión de Android Studio
• Un archivo de paquete firmado que generó desde Android Studio
• Una cuenta de desarrollador de Google Play de la que eres propietario o administrador
• Su aplicación en Google Play está configurada en el panel de la aplicación 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).
  • Se completa la revisión de la aplicación en Google Play 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 utilizar como tester para recibir invitaciones a nuevas compilaciones de Firebase

2. Crea un proyecto de Firebase

1. Inicia sesión en Firebase .
2. En Firebase console, haz clic en Agregar proyecto y luego nombra tu proyecto "AppBundlesCodelab". Recuerde el ID del proyecto de su proyecto de Firebase. Si no editas el ID del proyecto, Firebase asigna automáticamente un ID único para tu proyecto.
   
   
3. (Opcional) Cuando se le solicite, habilite Google Analytics.
4. Complete los pasos restantes y luego haga clic en Crear proyecto .

Agregue su paquete de aplicaciones al proyecto

1. En Firebase console, haz clic en Agregar aplicación .
   
   
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.

   Nota: Se requiere el mismo nombre de paquete para vincular su aplicación Firebase con su cuenta de desarrollador de Google Play, lo cual hará en la siguiente sección.

   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 .

Enlace a Google Play

1. En Firebase console, ve a la configuración de tu proyecto .
   
   
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 ha completado estos pasos, su aplicación 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 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 a 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 a 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 a nivel de aplicación ( android/app/build.gradle.kts ), agregue el complemento App Distribution 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 a App Distribution cargar 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 Gradle, deberás autenticar tu proyecto de Firebase. Para este codelab, iniciará sesión en su cuenta de Google mediante Firebase CLI .

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 evaluador 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 su app/build.gradle.kts , agregue una sección firebaseAppDistribution e incluya los siguientes parámetros:

• appID : el ID de la aplicación Firebase de tu 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 codelab, agregue su propio correo electrónico para que pueda probar su compilación una vez distribuida.

Por ejemplo:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "[e-mail], [e-mail], [e-mail]"
                }
            }
        }

        // ...
    }

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

5. Cree y distribuya una versión

1. Ejecute la tarea bundle Variant Gradle para crear el archivo de paquetes de aplicaciones:

   $ ./gradlew :base:bundleRelease
   

2. Localice 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 la versión, cree los destinos bundleRelease y appDistributionUploadRelease con el contenedor Gradle de su proyecto. Incluye el token de Firebase (el que recibiste en el paso 3: Agregar distribución de aplicaciones a tu 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 Lanzamientos del panel de Distribución de aplicaciones.

6. Descarga y prueba tu versión.

En esta sección, se le configurará como evaluador para poder 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.
   
   
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 puedes descargar Firebase App Tester , que evita que las versiones descargadas se agreguen 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 de la versión.
   
   
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!

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

Próximos pasos

• Dirígete a la documentación de distribución de aplicaciones para obtener más información sobre cómo administrar los evaluadores para tu versión.
• Consulte Crear y probar su Android App Bundle para obtener información sobre otras herramientas que puede utilizar para implementar su aplicación.