Distribuya aplicaciones de Android a los evaluadores mediante Firebase CLI

Esta guía describe cómo distribuir Android App Bundles (AAB) a los evaluadores mediante Firebase CLI. La herramienta CLI le permite especificar probadores y notas de la versión para una compilación y luego distribuye la compilación en consecuencia.

App Distribution se integra con el servicio interno para compartir aplicaciones de Google Play para procesar los AAB que usted carga y ofrecer APK que están optimizados para las configuraciones de dispositivos de sus evaluadores. La distribución de AAB le permite hacer lo siguiente:

  • Ejecute APK optimizados (servidos por Google Play) que estén optimizados para los dispositivos de sus evaluadores.

  • Descubra y depure problemas específicos del dispositivo.

  • Pruebe las funciones del paquete de aplicaciones, como Play Feature Delivery y Play Asset Delivery .

  • Reduzca el tamaño de las descargas para sus evaluadores.

Permisos requeridos

Para cargar AAB en App Distribution, debes vincular tu aplicación de Firebase a una aplicación en Google Play . Debe tener el nivel de acceso requerido para realizar estas acciones.

Si no tiene el acceso necesario a Firebase, puede pedirle al propietario del proyecto de Firebase que le asigne el rol correspondiente a través de la configuración de IAM de la consola de Firebase . Si tienes preguntas sobre cómo acceder a tu proyecto de Firebase, incluida la búsqueda o asignación de un propietario, consulta las preguntas frecuentes sobre "Permisos y acceso a proyectos de Firebase" .

La siguiente tabla se aplica a vincular una aplicación de Firebase a una aplicación en Google Play, así como a cargar AAB.

Acción en la consola Firebase Permiso IAM requerido Roles de IAM que incluyen los permisos necesarios de forma predeterminada Roles adicionales requeridos
Vincular una aplicación de Firebase a una aplicación en Google Play firebase.playLinks.update Uno de los siguientes roles: Acceso a una cuenta de desarrollador de Google Play como administrador
Cargar AAB en la distribución de aplicaciones firebaseappdistro.releases.update Uno de los siguientes roles: ––

Antes de que empieces

  1. Si aún no lo has hecho, agrega Firebase a tu proyecto de Android . Al final de este flujo de trabajo, tendrás una aplicación Firebase para Android en tu proyecto de Firebase.

    Si no utiliza ningún otro producto de Firebase, solo necesita crear un proyecto y registrar su aplicación. Si decide utilizar productos adicionales, asegúrese de completar todos los pasos en Agregar Firebase a su proyecto de Android .

  2. Para crear un enlace de Firebase a Google Play y cargar AAB, asegúrese de que su aplicación cumpla con los siguientes requisitos:

    • La aplicación en Google Play y la aplicación Firebase para Android están registradas con el mismo nombre de paquete.

    • La aplicación en Google Play se configura en el panel de la aplicación y 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.

  3. Vincula tu aplicación Firebase para Android a tu cuenta de desarrollador de Google Play:

    1. En la consola de Firebase, ve a tu Configuración del proyecto y luego seleccione la pestaña Integraciones .

    2. En la tarjeta de Google Play , haz clic en Enlace .
      Si ya tiene enlaces a Google Play, haga clic en Administrar .

    3. Siga las instrucciones en pantalla para habilitar la integración de distribución de aplicaciones y seleccione qué aplicaciones de Android de Firebase vincular a Google Play.

    Obtén más información sobre cómo vincular a Google Play .

Paso 1. Crea tu aplicación

Cuando esté listo para distribuir una versión preliminar de su aplicación a los evaluadores, cree su AAB (visite la documentación de Android Studio para obtener instrucciones).

Paso 2. Distribuya su aplicación a los evaluadores

Para distribuir su aplicación a los evaluadores, cargue el archivo de su aplicación usando Firebase CLI:

  1. Instale o actualice a la última versión de Firebase CLI (recomendamos descargar el binario independiente para la CLI específica de su sistema operativo). Asegúrate de iniciar sesión y probar que puedes acceder a tus proyectos.
  2. En la página Distribución de aplicaciones de Firebase console, selecciona la aplicación que deseas distribuir y luego haz clic en Comenzar .

  3. Ejecute el comando appdistribution:distribute para cargar su aplicación y distribuirla a los evaluadores. Utilice los siguientes parámetros para configurar la distribución:

    distribución de aplicaciones: opciones de distribución
    --app

    Requerido : el ID de la aplicación Firebase de tu aplicación. Puede encontrar el ID de la aplicación en Firebase console, en la página Configuración general .

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    Un token de actualización que se imprime cuando autenticas tu entorno de CI con Firebase CLI (lee Usar la CLI con sistemas de CI para obtener más información).

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    Notas de la versión para esta compilación.

    Puede especificar las notas de la versión directamente:

    --release-notes "Text of release notes"

    O especifique la ruta a un archivo de texto sin formato:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    Las direcciones de correo electrónico de los evaluadores que desea invitar.

    Puede especificar los evaluadores como una lista de direcciones de correo electrónico separadas por comas:

    --testers "ali@example.com, bri@example.com, cal@example.com"

    O puede especificar la ruta a un archivo de texto sin formato que contenga una lista de direcciones de correo electrónico separadas por comas:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    Los grupos de testers que desea invitar (consulte Administrar testers ). Los grupos se especifican usando alias de grupo , que puedes buscar en Firebase console.

    Puede especificar los grupos como una lista separada por comas:

    --groups "qa-team, trusted-testers"

    O puede especificar la ruta a un archivo de texto sin formato que contenga una lista de nombres de grupos separados por comas:

    --groups-file "/path/to/groups.txt"
    --debug

    Una bandera que puede incluir para imprimir una salida de registro detallada.

    --test-devices
    --test-devices-file

    Los siguientes tipos de distribución forman parte de la función beta del probador automatizado .

    Los dispositivos de prueba a los que desea distribuir compilaciones (consulte Pruebas automatizadas ).

    Puede especificar los evaluadores como una lista de direcciones de correo electrónico separadas por comas:

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

    O puede especificar la ruta a un archivo de texto sin formato que contenga una lista de dispositivos de prueba separados por punto y coma:

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    El nombre de usuario para el inicio de sesión automático que se utilizará durante las pruebas automatizadas .

    --test-password
    --test-password-file

    La contraseña para el inicio de sesión automático que se utilizará durante las pruebas automatizadas .

    O puede especificar la ruta a un archivo de texto sin formato que contenga una contraseña:

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    Nombre del recurso para el campo de nombre de usuario para el inicio de sesión automático que se utilizará durante las pruebas automatizadas .

    --test-password-resource

    Nombre del recurso para el campo de contraseña para el inicio de sesión automático que se utilizará durante las pruebas automatizadas .

    --test-non-blocking

    Ejecute pruebas automatizadas de forma asincrónica. Visite la consola de Firebase para ver los resultados de las pruebas automáticas.

    Por ejemplo:

    firebase appdistribution:distribute test.aab  \
    --app 1:1234567890:android:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

    Firebase CLI genera los siguientes enlaces después de cargar la versión. Estos enlaces lo ayudan a administrar archivos binarios y garantizar que los evaluadores y otros desarrolladores tengan la versión correcta:

    • firebase_console_uri : un enlace a Firebase console que muestra una versión única. Puede compartir este enlace con otros desarrolladores de su organización.
    • testing_uri : un enlace a la versión en la experiencia del evaluador (aplicación nativa de Android) que permite a los evaluadores ver las notas de la versión e instalar la aplicación en su dispositivo. El evaluador necesita acceso a la versión para poder utilizar el enlace.
    • binary_download_uri : un enlace firmado que descarga e instala directamente el binario de la aplicación (archivo APK o AAB). El enlace caduca después de una hora.

    Administrar probadores y grupos

    Además de distribuir versiones, también puedes usar appdistribution:testers:add y appdistribution:testers:remove para invitar a nuevos testers o eliminar testers existentes de tu proyecto de Firebase.

    Una vez que se haya agregado un tester a su proyecto de Firebase, puede agregarlo a versiones individuales. Una vez que elimines a un evaluador, ya no tendrá acceso a las versiones de tu proyecto. Tenga en cuenta que los evaluadores que fueron eliminados recientemente aún pueden conservar el acceso a sus versiones durante un período de tiempo.

    Por ejemplo:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com

    Los correos electrónicos del evaluador deben estar separados por un espacio. También puede especificar probadores usando --file /path/to/testers.txt .

    Si tiene una gran cantidad de evaluadores, debería considerar el uso de grupos: puede usar appdistribution:group:create y appdistribution:group:delete para crear o eliminar grupos en su proyecto de Firebase.

    Utilice --group-alias para especificar un grupo para los appdistribution:testers:add y appdistribution:testers:remove .

    Por ejemplo:

    firebase appdistribution:group:create "QA team" qa-team

firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:group:delete qa-team

Una vez que distribuyas tu compilación, estará disponible en el panel de distribución de aplicaciones de Firebase console durante 150 días (cinco meses). Cuando faltan 30 días para que expire la compilación, aparece un aviso de vencimiento tanto en la consola como en la lista de compilaciones del evaluador en su dispositivo de prueba.

Los evaluadores que no han sido invitados a probar la aplicación reciben invitaciones por correo electrónico para comenzar, y los probadores existentes reciben notificaciones por correo electrónico de que una nueva versión está lista para probar (lea la guía de configuración del probador para obtener instrucciones sobre cómo instalar la aplicación de prueba). Puedes monitorear el estado de cada tester (si aceptaron la invitación y si descargaron la aplicación) en Firebase console.

Los evaluadores tienen 30 días para aceptar una invitación para probar la aplicación antes de que caduque. Cuando faltan 5 días para que expire una invitación, aparece un aviso de vencimiento en Firebase console junto al evaluador en una versión. Se puede renovar una invitación reenviándola usando el menú desplegable en la fila del probador.

Próximos pasos