Distribuye versiones de paquetes de aplicaciones a los verificadores: Codelab

1. Descripción general

En este codelab, aprenderás a distribuir versiones de Android App Bundle a los verificadores con Firebase App Distribution y su complemento para 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 una de ellas.

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 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 asígnale el nombre “AppBundlesCodelab”. Recuerda el ID del proyecto de Firebase. Si no editas el ID del proyecto, Firebase le asigna automáticamente un ID único.
   
   
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.
   
   
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.

   Nota: Se requiere el mismo nombre de paquete para vincular tu app de Firebase con tu cuenta de desarrollador de Google Play. Deberás hacerlo en la siguiente sección.

   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, para Android, App Distribution no tiene un SDK de Firebase para agregar a tu app.
4. Haz clic en Ir a la consola.

Crea un vínculo a Google Play

1. En Firebase console, ve a la configuración del proyecto.
   
   
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, 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 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 corporativo, 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
   

Autentica 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 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 que los invitan a probar la compilación nueva.

En tu app/build.gradle.kts, agrega una sección firebaseAppDistribution e 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 los verificadores. 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 = "[e-mail], [e-mail], [e-mail]"
                }
            }
        }

        // ...
    }

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 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 App Distribution.

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

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

• Consulta la documentación de App Distribution para obtener más información sobre cómo administrar los verificadores de tu versión.
• Consulta Cómo compilar y probar tu Android App Bundle para obtener información sobre otras herramientas que puedes usar para implementar tu app.