Esta página proporciona ayuda para la resolución de problemas y respuestas a preguntas frecuentes sobre la distribución y prueba de aplicaciones con App Distribution.
Distribuir aplicaciones
Utilice los siguientes consejos para solucionar problemas que pueda encontrar al distribuir aplicaciones a sus evaluadores.
Al cargar una aplicación, es posible que encuentres este error:
"No pudimos encontrar un correo electrónico de contacto para la aplicación <app-id> . Visite Distribución de aplicaciones en Firebase console para configurar una".
Configure un correo electrónico de contacto en Firebase console, si está disponible. Si el problema persiste, comuníquese con el soporte de Firebase .
Si encuentra repetidamente los errores 400, 409 o 500 durante el aprovisionamiento, comuníquese con el soporte de Firebase . Proporcione soporte con el número de su proyecto de Firebase y el identificador de la aplicación.
Verifique el tamaño del APK. El límite máximo de tamaño de archivo para todos los binarios es 2048 MiB, que es un poco más de 2 GB.
Si el tamaño del APK está dentro del límite de tamaño del archivo y es reproducible, comuníquese con el soporte de Firebase .
Verifique que el APK esté firmado usando lo siguiente:
apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk
Distribución de paquetes de aplicaciones de Android (AAB)
Cuando carga un AAB en App Distribution, Google Play renuncia automáticamente al APK generado mediante un certificado de clave de firma de aplicación de prueba. Cuando se le solicite, debe registrar su aplicación con proveedores de API si desea continuar utilizando sus servicios de terceros. Una vez firmado, el certificado de prueba de su aplicación se puede ver en Firebase console.
Las compilaciones de AAB que carga en App Distribution no aparecen en su cuenta de desarrollador de Google Play (esto incluye App Bundle Explorer y el uso compartido interno de aplicaciones).
Si una aplicación Firebase para Android se desvincula de Google Play, sucede lo siguiente:
No podrá cargar nuevos paquetes de aplicaciones en App Distribution y exportarlos a Google Play a través de la integración de App Distribution con Google Play.
Las compilaciones existentes seguirán estando disponibles en el panel de Firebase App Distribution y para sus evaluadores.
Todos los datos exportados previamente entre Firebase y Google Play seguirán siendo accesibles en ambos productos.
Para distribuir un Android App Bundle (AAB) a través de App Distribution y vincular automáticamente los AAB cargados tanto a su proyecto de Firebase como a su cuenta de desarrollador de Google Play, asegúrese de cumplir con los siguientes requisitos:
Su cuenta de desarrollador de Google Play tiene uno de los siguientes niveles de acceso : Propietario o Administrador.
Para su proyecto de Firebase, tiene uno de los siguientes roles: Propietario o Administrador de Firebase .
Su aplicación está registrada en Firebase y en su cuenta de desarrollador de Google Play. Esto significa que tienes una aplicación Firebase para Android y una aplicación Google Play.
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.
Si subiste una aplicación que anteriormente no cumplía con los criterios enumerados anteriormente para vincularla, pero ahora sí los cumple, puedes volver a intentar vincular tu aplicación Firebase para Android a Google Play .
Instalar y probar aplicaciones
Utilice los siguientes consejos para solucionar problemas que sus evaluadores puedan encontrar al instalar y probar sus aplicaciones.
Cuando un usuario crea una cuenta de Google, recibe automáticamente una dirección de Gmail.
Si un evaluador no tiene una dirección de Google Workspace o Gmail, o si prefiere usar otra dirección de correo electrónico para iniciar sesión, pídale que vincule una dirección de correo electrónico que no sea de Gmail a la cuenta y use ese correo electrónico para iniciar sesión.
Al elegir un correo electrónico alternativo, el evaluador debe seguir estas pautas:
- No utilices una dirección de Gmail.
- No utilice una dirección de correo electrónico que ya esté vinculada a otra cuenta de Google.
- Recuerde utilizar la contraseña de su cuenta de Google al iniciar sesión con esta dirección de correo electrónico.
Para obtener más información, consulte Iniciar sesión en su cuenta de Google con otra dirección de correo electrónico .
Si el evaluador aceptó la invitación por correo electrónico con una dirección de correo electrónico diferente a la que se envió la invitación, es posible que no pueda ver las aplicaciones o compilaciones correctas.
El correo electrónico al que el desarrollador envía invitaciones y agrega nuevas compilaciones (correo electrónico A) puede ser diferente del correo electrónico que utiliza el evaluador para aceptar la invitación (correo electrónico B). Esto crea un vínculo detrás de escena. Cada vez que se agrega el correo electrónico A a nuevas compilaciones, en realidad es el correo electrónico B el que obtiene acceso.
Si el evaluador aceptó la invitación por correo electrónico con una dirección de correo electrónico diferente, siga estos pasos para resolver el problema:
Elimine el probador de la sección Ver todos los probadores de la pestaña Probadores y grupos en la página Distribución de aplicaciones de Firebase console. Se eliminan las invitaciones existentes.
Vuelva a invitar al evaluador a probar su aplicación. El evaluador debería recibir un correo electrónico de invitación.
Asegúrese de que el evaluador acepte la invitación con la misma dirección de correo electrónico.
Es posible que los evaluadores no reciban notificaciones por correo electrónico si ocurre una de las siguientes situaciones:
Las notificaciones por correo electrónico se envían a carpetas de spam.
Se establecen filtros de correo electrónico.
La invitación se envió a una cuenta de correo electrónico, pero el evaluador aceptó con una cuenta de correo electrónico diferente. El evaluador recibe correos electrónicos de nueva versión para la cuenta de correo electrónico a la que se envió originalmente la invitación.
El evaluador fue invitado previamente pero no aceptó la invitación inicial. Si el evaluador se agrega a versiones posteriores, App Distribution no enviará automáticamente notificaciones de lanzamiento a ese evaluador porque no aceptó la invitación inicial.
Solución 1
Pídale al evaluador que revise su carpeta de correo no deseado y los filtros de correo electrónico que haya configurado en su servicio de correo electrónico.
Si el evaluador canceló su suscripción a los correos electrónicos, pídale que haga lo siguiente:
- Busque un correo electrónico que el evaluador haya recibido previamente desde la aplicación.
- Haga clic en Administrar configuración de correo electrónico en la parte inferior y haga clic en Permitir que los correos electrónicos se vuelvan a suscribir.
Solución 2
Si el evaluador no desea recibir notificaciones por correo electrónico pero quiere poder aceptar invitaciones a aplicaciones, puede ver las invitaciones a aplicaciones pendientes directamente en la aplicación App Tester ( instrucciones de descarga ).
Solución 3
Elimine el probador de la sección Ver todos los probadores de la pestaña Probadores y grupos en la página Distribución de aplicaciones en Firebase console. Esta acción elimina las invitaciones existentes.
Vuelva a invitar al evaluador a probar su aplicación. El evaluador debería recibir un correo electrónico de invitación. Asegúrese de que el evaluador acepte la invitación con la misma dirección de correo electrónico a la que se envió la invitación.
Si un evaluador descarga e instala una versión pero la interfaz de usuario de detalles de la aplicación no muestra que la aplicación está instalada, se trata de un problema conocido. En algunos casos, el ID del paquete en la aplicación Firebase no coincide con el ID del paquete del APK.
Verifica que el ID del paquete del APK coincida con el ID del paquete de la aplicación Firebase que usaste para cargar la distribución.
La alerta de Android aparece si su aplicación o navegador en ejecución aún no ha recibido permiso para instalar aplicaciones fuera de Google Play. Para otorgar permiso:
Versión de Android 8 o posterior : en la aplicación Configuración , toque Permitir desde esta fuente .
Versión de Android 7 o anterior : en la aplicación Configuración , toque Seguridad y seleccione Fuentes desconocidas . Cuando aparezca el mensaje, toque Aceptar > Confiar .
Si un APK de prueba no se instala en el dispositivo de un evaluador:
- Verifique que los certificados de la nueva versión coincidan con los de la versión instalada en el dispositivo del evaluador. El sistema Android sólo permite que la aplicación se actualice si los certificados coinciden. Para obtener más información, consulte Consideraciones sobre la firma .
- Asegúrese de que la aplicación admita la versión del sistema operativo del dispositivo de prueba (verifique
minSdkVersion).
Si la aplicación App Tester le impide iniciar sesión y le redirige a la pantalla de inicio de sesión, es posible que esté utilizando un Google Workspace (anteriormente GSuite) que incluye configuraciones de restricción.
Para eliminar su configuración de restricción:
En la pestaña Aplicaciones de Google Workspace, asegúrese de que Firebase App Distribution no esté configurado en Acceso: Bloqueado .
En la pestaña Servicios , asegúrese de que Cloud Platform no tenga restricciones.
Una vez que se elimine la configuración, intente iniciar sesión nuevamente.
Este error puede ocurrir cuando la aplicación que se está instalando entra en conflicto con una aplicación ya instalada en el dispositivo. Por ejemplo, podría ser una variante diferente de la misma aplicación con el mismo permiso personalizado o nombre de ContentProvider .
Puede pedirle al evaluador que recopile un informe de error inmediatamente después de experimentar el problema e inspeccionar el informe para obtener más información sobre la causa. El evaluador debe eliminar cualquier aplicación en conflicto antes de poder instalar la nueva aplicación.
Cuando encuentras un error 403, esto significa que la cuenta que estás usando no tiene permiso para instalar y probar aplicaciones. El acceso lo determina el administrador del dominio de su cuenta en Google Workspace.
Si cree que debería tener permiso para instalar y probar aplicaciones, pídale al administrador de su cuenta de Google Workspace que cambie la configuración de su cuenta. Su administrador debe seguir las instrucciones en Administrar el acceso a servicios que no se controlan individualmente .
Si tiene varias cuentas, intente iniciar sesión con una cuenta diferente que no tenga restricciones para instalar y probar aplicaciones.
Si es la primera vez que realiza un tester, consulte Configuración como tester .
Si ya eres un evaluador de distribución de aplicaciones y obtienes un nuevo dispositivo Android para realizar la prueba, en lugar de volver a realizar todo el flujo del nuevo evaluador, sigue estos pasos:
Navegue hasta appdistribution.firebase.google.com en su dispositivo Android.
Inicie sesión con su cuenta de probador existente y haga clic en el botón Descargar App Tester en la parte inferior de la pantalla para instalar la aplicación Android App Tester.
Habilitación de funciones de prueba con el SDK de Android de distribución de aplicaciones
Utilice los siguientes consejos para solucionar problemas que implican habilitar alertas de nuevas compilaciones en la aplicación o enviar comentarios en la aplicación mediante el SDK de Android de distribución de aplicaciones.
Si ya configuró el SDK de Android de distribución de aplicaciones en su aplicación para admitir comentarios dentro de la aplicación y sus evaluadores no pueden enviar comentarios, siga estos pasos:
Habilite el registro detallado para el SDK de Android de distribución de aplicaciones en su aplicación:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSEVerifique mensajes de error en los registros de su aplicación filtrando por "FirebaseAppDistribution".
Confirme que el evaluador tenga acceso a la versión instalada:
Si los registros indican que "el evaluador no tiene acceso a este recurso", es posible que su evaluador no haya sido invitado a la aplicación o que no tenga acceso a la versión.
En el panel de distribución de aplicaciones de Firebase console, busque la versión exacta que se está ejecutando en el dispositivo del evaluador y asegúrese de que el evaluador aparezca en la pestaña Probadores de la tarjeta de versión y que esté en el estado Aceptado.
Si aún no recibe comentarios, siga estos pasos:
En el dispositivo de prueba, inicie sesión en Firebase App Distribution mediante App Tester o la aplicación web del probador. Asegúrese de seleccionar la cuenta de Google que utilizó por primera vez cuando aceptó la invitación para probar la aplicación.
Instale la aplicación nuevamente usando App Tester o la aplicación web de prueba para asegurarse de que el evaluador tenga acceso a la versión.
Intente enviar comentarios, asegurándose nuevamente de iniciar sesión con la misma cuenta de Google.
Asegúrate de haber habilitado la API de Firebase App Testers. Para obtener más información, consulte Habilitar la API de App Distribution Tester .
En Restricciones de claves , asegúrese de que la API de Firebase App Testers esté incluida en la lista de API permitidas.
Si ve este mensaje al enviar comentarios, "Habría enviado comentarios, pero no lo hizo debido al modo de desarrollo", deshabilite el modo de desarrollador en el dispositivo ejecutando este comando:
adb shell setprop debug.firebase.appdistro.devmode falseVerifique su archivo
google-services.jsonpara asegurarse de que está enviando comentarios para el proyecto y la aplicación correctos.Habilite el registro detallado para el SDK de Android de distribución de aplicaciones en su aplicación:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSEVerifique mensajes de error en los registros de su aplicación filtrando por "FirebaseAppDistribution".
Si ya configuró el SDK de Android de distribución de aplicaciones en su aplicación y sus evaluadores no reciben alertas en la aplicación, siga estos pasos:
Compruebe si hay mensajes de error adjuntando un
OnFailureListenera la tarea devuelta por la API de distribución de aplicaciones de Firebase.Java
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> { if (e instanceof FirebaseAppDistributionException) { // Log exception here }});Kotlin
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e -> if (e is FirebaseAppDistributionException) { // Log exception here } }Compruebe que el evaluador tenga acceso a la nueva versión:
Habilite el modo de depuración en su aplicación. Para saber cómo, consulte la documentación de Google Analytics .
Ejecute su aplicación en un simulador y busque la cadena "FirebaseAppDistribution".
Si los registros indican que no se encontró ninguna versión o que el evaluador no tiene acceso, es posible que su evaluador aún no esté asociado con la nueva versión.
En el panel de Distribución de aplicaciones de Firebase console, asegúrese de que su probador esté incluido en su distribución de compilación y esté en el estado Aceptado .
Si su evaluador aún no recibe alertas, pídale que siga los consejos a continuación para asegurarse de que aceptó la invitación para probar su aplicación y de que configuró su dispositivo de prueba correctamente:
En el dispositivo de prueba, inicie sesión en Firebase App Distribution mediante App Tester o mediante la aplicación web del tester. Recuerde seleccionar la cuenta de Google que utilizó por primera vez cuando aceptó la invitación para probar la aplicación.
Verifique que la nueva versión de la aplicación esté disponible en App Tester o en la aplicación web del probador.
De forma predeterminada, sus evaluadores solo necesitan iniciar sesión en su cuenta de Google una vez para habilitar las funciones de prueba. Si a sus evaluadores se les solicita que inicien sesión nuevamente después de cerrar y volver a abrir su aplicación, siga estos consejos para asegurarse de que la configuración de distribución de su aplicación esté configurada correctamente:
Asegúrate de haber habilitado la API de Firebase App Testers. Para obtener más información, consulte Habilitar la API de App Distribution Tester .
En Restricciones de claves , asegúrese de que la API de Firebase App Testers esté incluida en la lista de API permitidas.
Si normalmente borra SharedPreferences al cerrar sesión, es posible que esté borrando el estado de su probador. App Distribution almacena una bandera que indica si su evaluador ya ha iniciado sesión en la aplicación. Para obtener más información, consulte el repositorio de GitHub .
Preguntas frecuentes
Firebase App Distribution tiene los siguientes límites de prueba:
Agregue un máximo de 500 testers a un proyecto de Firebase
Agregue un máximo de 200 evaluadores a un grupo de distribución de aplicaciones
Para agregar más probadores, solicite un aumento de límite sin costo.
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 a través del menú desplegable en la fila del probador.
Los lanzamientos de aplicaciones se eliminan de App Distribution si se produce una de las siguientes condiciones:
- El lanzamiento de la aplicación tiene más de 150 días.
- Excede el límite de lanzamientos de 1000 aplicaciones y el lanzamiento de la aplicación es anterior a los 1000 lanzamientos de aplicaciones más recientes.
Para obtener más información, consulte La distribución de aplicaciones admite un máximo de 1000 versiones .
Una vez que la aplicación alcanza o supera el límite de vencimiento de 150 días o el límite de 1000 lanzamientos, el lanzamiento se elimina del panel de distribución de aplicaciones y de la aplicación Firebase App Tester. Si su evaluador instaló la versión, la versión local de la aplicación continúa ejecutándose.
Para mantener la versión de la aplicación disponible por más tiempo, utilice una de las siguientes recomendaciones:
- Antes de que la versión de la aplicación caduque o supere el límite de versión, descargue el APK o AAB y elimine la versión del panel de distribución de aplicaciones. Luego, vuelva a cargar el APK o AAB como una nueva compilación en App Distribution.
- Descargue la versión y cárguela en Cloud Storage para archivarla a largo plazo.
Los lanzamientos de aplicaciones caducan después de 150 días
Cuando cargas una versión de tu aplicación en Firebase, la versión aparece en el panel de Distribución de aplicaciones durante 150 días, a partir de la fecha de carga. Después de cargar la versión, puede distribuirla a los evaluadores, quienes la instalan desde la aplicación Firebase App Tester en su dispositivo de prueba.
Cuando el lanzamiento es de 30 días a partir de la fecha de vencimiento, aparece una notificación de vencimiento del lanzamiento de la aplicación en su lanzamiento en la aplicación Firebase App Tester.
App Distribution admite un máximo de 1000 versiones
La distribución de aplicaciones permite un máximo de 1000 lanzamientos por aplicación. Cuando su aplicación alcanza el límite de versiones de 1000 aplicaciones, App Distribution elimina automáticamente las versiones más antiguas que superan el límite.
Si desea administrar manualmente los lanzamientos de sus aplicaciones, use la API REST de distribución de aplicaciones para enumerar y eliminar lanzamientos de aplicaciones de forma masiva.
Si tiene preguntas, comuníquese con el soporte de Firebase .
Si eres un tester, te recomendamos descargar Firebase App Tester , una aplicación que te permite acceder a todas tus compilaciones de prueba en un solo lugar.
Firebase App Distribution utiliza la infraestructura de Firebase Test Lab y sus límites de cuota y precios son los mismos. Las cuotas de pruebas se miden por la cantidad de pruebas realizadas por día. Para obtener más información sobre las cuotas de prueba y la facturación, consulte Niveles de uso, cuotas y precios de Test Lab .
Si excede la cuota, recibirá errores de cuota excedida. Las cuotas tardan aproximadamente 24 horas en restablecerse, por lo que debe evitar volver a intentarlo hasta que se libere la cuota. Sin embargo, si recibe errores relacionados con la infraestructura del probador automatizado, es más probable que las llamadas se realicen correctamente si vuelve a intentarlo inmediatamente.
Necesitará tener acceso de editor en el proyecto de Firebase para poder ejecutar pruebas con la función Automated Tester.
Para eliminar su cuenta de probador de App Distribution y sus datos asociados, siga estos pasos en orden:
Visite https://appdistribution.firebase.google.com e inicie sesión con su cuenta de Google.
En la parte superior derecha, haz clic en ( Administrar cuenta )
Borrar cuenta .
Opcional: en los permisos de su cuenta de Google , revoque el acceso desde Firebase App Distribution. Tenga en cuenta que revocar el acceso sin eliminar primero su cuenta de distribución de aplicaciones no elimina su cuenta ni sus datos de probador.