En esta guía, se describe cómo distribuir compilaciones automáticamente a los verificadores con la función Verificador automatizado de App Distribution en Firebase console. La función Verificador automatizado proporciona una herramienta de pruebas de humo fácil de usar y que siempre está lista para tu app.
Antes de comenzar
Si aún no lo has hecho, agrega Firebase a tu proyecto de Android.
Si no utilizas ningún otro producto de Firebase, solo debes crear un proyecto y registrar tu app. Sin embargo, si decides usar productos adicionales en el futuro, asegúrate de completar todos los pasos que se indican en Agrega Firebase con Firebase console.
Cuando estés listo para distribuir una versión previa al lanzamiento de tu app a los verificadores, compila el APK usando el proceso normal. Debes firmar el APK con tu clave de depuración o la clave de firma de la app.
Distribuye tu app al Verificador automatizado con Firebase console
Para distribuir tu app al Verificador automatizado, sube el archivo APK con Firebase console como se indica a continuación:
- Abre la página App Distribution de Firebase console. Selecciona tu proyecto de Firebase cuando se te solicite.
- En la página Versiones, selecciona la app que quieres distribuir desde el menú desplegable.
- Arrastra el archivo APK a la consola para subirlo.
- Cuando se complete la carga, selecciona Verificador automatizado en la barra de búsqueda Agregar verificadores o grupos.
- Para personalizar tu prueba automatizada, haz clic en el ícono Editar y selecciona las personalizaciones en el diálogo Personalizar la prueba automatizada.
- (Opcional) En el diálogo device configuration, selecciona el nivel de API, la orientación del dispositivo y la configuración regional que cumplan con tus especificaciones de prueba.
- (Opcional) Haz clic en el menú desplegable Credenciales de acceso para crear un nombre de usuario y una contraseña personalizados que se puedan usar durante la prueba si la app requiere credenciales de acceso.
- Haz clic en Distribute. También puedes agregar una nota de la versión opcional para tu app.
Distribuye tu app al Verificador automatizado con Firebase CLI
Ejecuta el comando appdistribution:distribute para subir la app y distribuirla a los verificadores. Usa los siguientes parámetros para
configurar la distribución en la función de Verificador automatizdo:
| Opciones de appdistribution:distribute | |
|---|---|
--test-devices o
--test-devices-file
|
Los dispositivos de prueba que quieres distribuir a las compilaciones con la función de Verificador automatizado. Puedes especificar los dispositivos de prueba como una lista de dispositivos de prueba separada por punto y coma: --test-devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"
También puedes especificar la ruta de acceso 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 del acceso automático que se usará durante las pruebas automatizadas. |
--test-password o
--test-password-file
|
La contraseña del acceso automático que se usará durante las pruebas automatizadas. O bien, puedes especificar la ruta de acceso a un archivo de texto sin formato que contenga una contraseña: --test-password-file: "/path/to/test-password.txt"
|
--test-username-resource
|
El nombre del recurso del campo de nombre de usuario del acceso automático que se usará durante las pruebas automatizadas. |
--test-password-resource
|
El nombre de recurso del campo de contraseña para el acceso automático que se usará durante las pruebas automatizadas. |
--test-non-blocking |
Ejecuta pruebas automatizadas de forma asíncrona. Visita Firebase console para ver los resultados de la prueba automática. |
Si quieres obtener más información sobre cómo comenzar a usar Firebase CLI y las diferentes maneras de configurar tu distribución, consulta Distribuye apps para Android a los verificadores con Firebase CLI.
Distribuye tu app a un verificador automatizado con Gradle
Para configurar App Distribution, agrega al menos una sección firebaseAppDistribution
y usa los siguientes parámetros para configurar la distribución a la
función de Verificador automatizado:
| Parámetros de compilación de App Distribution | |
|---|---|
testDevices o
testDevicesFile
|
Los dispositivos de prueba a los que deseas distribuir las compilaciones mediante pruebas automatizadas Puedes especificar los dispositivos de prueba en una lista de especificaciones de dispositivos separada por punto y coma testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0p, version=33, locale=en, orientation=portrait"
También puedes especificar la ruta de acceso a un archivo que contenga una lista separada por punto y coma con las especificaciones del dispositivo: testDevicesFile="/path/to/testDevices.txt"
|
testUsername
|
El nombre de usuario del acceso automático que se usará durante las pruebas automatizadas. |
testUsernameResource
|
El nombre del recurso del campo de nombre de usuario del acceso automático que se usará durante las pruebas automatizadas. |
testPassword o
testPasswordFile
|
La contraseña del acceso automático que se usará durante las pruebas automatizadas. O bien, puedes especificar la ruta de acceso a un archivo de texto sin formato que contenga una contraseña: testPasswordFile="/path/to/testPassword.txt" |
testPasswordResource
|
El nombre de recurso del campo de contraseña para el acceso automático que se usará durante las pruebas automatizadas. |
testNonBlocking |
Ejecuta pruebas automatizadas de forma asíncrona. Visita Firebase console para ver los resultados de la prueba automática. |
Si quieres obtener más información para comenzar a usar Gradle y las diferentes maneras de configurar tu distribución, consulta Distribuye apps para Android a los verificadores usando Gradle.
Distribuye tu app a un verificador automático con fastlane
En un carril de ./fastlane/Fastfile, agrega un bloque firebase_app_distribution. Usa los siguientes parámetros para
configurar la distribución en la función de Verificador automatizdo:
| Parámetros de firebase_app_distribution | |
|---|---|
test_devices o
test_devices_file
|
Los dispositivos de prueba que quieres distribuir a las compilaciones con la función de Verificador automatizado. Puedes especificar los dispositivos de prueba como una lista de dispositivos de prueba separada por punto y coma: test_devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"
También puedes especificar la ruta de acceso 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 del acceso automático que se usará durante las pruebas automatizadas. |
test_password o
test_password_file
|
La contraseña del acceso automático que se usará durante las pruebas automatizadas. O bien, puedes especificar la ruta de acceso a un archivo de texto sin formato que contenga una contraseña: test_password_file: "/path/to/test-password.txt"
|
test_username_resource
|
El nombre del recurso del campo de nombre de usuario del acceso automático que se usará durante las pruebas automatizadas. |
test_password_resource
|
El nombre de recurso del campo de contraseña para el acceso automático que se usará durante las pruebas automatizadas. |
test_non_blocking |
Ejecuta pruebas automatizadas de forma asíncrona. Visita Firebase console para ver los resultados de la prueba automática. |
Si quieres obtener más información para comenzar a usar fastlane y las diferentes formas de configurar tu distribución, consulta Distribuye apps para Android a los verificadores con fastlane.
Estados del rastreo de prueba automatizado
Para ayudarte a interpretar los resultados de la prueba, en la pestaña Resultados de la prueba automatizada se muestran los problemas, las capturas de pantalla de la app y un video del rastreo de prueba para cada dispositivo. Puedes consultar el estado de la prueba en la página de resultados de la siguiente manera:
| Estado del rastreo | Descripción |
|---|---|
| Pendiente | Aún se está ejecutando la prueba automática, y tus resultados estarán disponibles pronto. |
| Aprobado | La prueba automática rastreó correctamente la app y no encontró ninguna falla. |
| Con errores | La prueba automática falló porque tu app falló durante la prueba. |
| Poco concluyentes | La prueba automática falló debido a errores de infraestructura. |