Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Distribuya aplicaciones de Android a los evaluadores mediante Firebase CLI

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 lanzamiento para una compilación, luego distribuye la compilación en consecuencia.

App Distribution se integra con el servicio interno de uso compartido de aplicaciones de Google Play para procesar los AAB que carga y sirve 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 funciones de paquetes 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, debe vincular su 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 de un proyecto de Firebase que le asigne la función correspondiente a través de la configuración de IAM de la consola de Firebase . Si tiene preguntas sobre el acceso a su proyecto de Firebase, incluida la búsqueda o la asignación de un propietario, consulte las preguntas frecuentes sobre "Permisos y acceso a proyectos de Firebase" .

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

Acción en la consola Firebase Permiso de gestión de identidades y accesos requerido Funciones de IAM que incluyen los permisos necesarios de forma predeterminada Rol(es) adicional(es) requerido(s)
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
Subir AAB a la distribución de aplicaciones firebaseappdistro.releases.update Uno de los siguientes roles: ––

Antes de que empieces

  1. Si aún no lo ha hecho, agregue Firebase a su proyecto de Android . Al final de este flujo de trabajo, tendrá una aplicación de Android de Firebase en su proyecto de Firebase.

    Si no está utilizando ningún otro producto de Firebase, solo necesita crear un proyecto y registrar su aplicación. Si decide usar 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 tablero de la aplicación y 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.

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

    1. En Firebase console, vaya a su del proyecto , luego seleccione la pestaña Integraciones .

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

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

    Obtén más información sobre la vinculación a Google Play .

Paso 1. Cree su 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 mediante 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, seleccione la aplicación que desea distribuir y luego haga clic en Comenzar .
  3. Ejecute el appdistribution:distribute para cargar su aplicación y distribuirla a los evaluadores. Utilice los siguientes parámetros para configurar la distribución:

    appdistribution:distribuir opciones
    --app

    Obligatorio : el ID de aplicación de Firebase de su 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 autentica su entorno de CI con Firebase CLI (lea 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 bien, 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 bien, 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 a los que desea invitar (consulte Administrar testers ). Los grupos se especifican usando alias de grupo , que puede buscar en Firebase console.

    Puede especificar los grupos como una lista separada por comas:

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

    O bien, 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 marca que puede incluir para imprimir la salida del registro detallado.

    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 la carga de la versión. Estos enlaces lo ayudan a administrar binarios y garantizar que los probadores y otros desarrolladores tengan la versión correcta:

    • firebase_console_uri : un vínculo a la consola de Firebase que muestra una única versión. Puede compartir este enlace con otros desarrolladores en su organización.
    • testing_uri : un vínculo 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 probador necesita acceso a la versión para usar 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.

    Además de distribuir lanzamientos, también puede usar appdistribution:testers:add y appdistribution:testers:remove para invitar a nuevos testers o eliminar testers existentes de su proyecto de Firebase. Una vez que se haya agregado un probador a su proyecto de Firebase, puede agregarlo a versiones individuales. Una vez que elimine a un evaluador, ya no tendrá acceso a las versiones de su proyecto. Tenga en cuenta que los evaluadores que se eliminaron 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 de los probadores deben estar separados por un espacio. También puede especificar probadores usando --file /path/to/testers.txt .

Una vez que distribuya su 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 caduque la compilación, aparece un aviso de caducidad tanto en la consola como en la lista de compilaciones del probador en su dispositivo de prueba.

Los probadores 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 compilació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). Puede monitorear el estado de cada evaluador, ya sea que aceptaron la invitación y si descargaron la aplicación, en la consola de Firebase.

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

Próximos pasos

Conozca las prácticas recomendadas para distribuir aplicaciones de Android a evaluadores de control de calidad mediante CI/CD .