Esta página proporciona ayuda para la resolución de problemas y respuestas a las preguntas más frecuentes sobre la distribución y prueba de aplicaciones con App Distribution.
Distribuir aplicaciones
Use los siguientes consejos para solucionar los problemas que pueda encontrar al distribuir aplicaciones a sus evaluadores.
Al cargar una aplicación, es posible que encuentre este error:
"No pudimos encontrar un correo electrónico de contacto para la aplicación <app-id>
. Visite Distribución de aplicaciones dentro de Firebase console para configurar uno".
Establezca un correo electrónico de contacto en la consola de Firebase, 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 Firebase Support . Proporcione al servicio de asistencia su número de proyecto de Firebase y el identificador de la aplicación.
Verifica el tamaño del APK. El límite máximo de tamaño de archivo para todos los archivos binarios es de 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 los 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 la consola de Firebase.
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 de Firebase para Android se desvincula de Google Play, ocurre lo siguiente:
No podrá cargar nuevos paquetes de aplicaciones a 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 distribución de aplicaciones de Firebase y para sus evaluadores.
Todos los datos exportados previamente entre Firebase y Google Play seguirán estando 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 con Firebase y su cuenta de desarrollador de Google Play. Esto significa que tiene una aplicación de Firebase para Android y una aplicación de 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 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.
Si cargó una aplicación que anteriormente no cumplía con los criterios enumerados anteriormente para la vinculación, pero ahora los cumple, puede volver a intentar vincular su aplicación Firebase para Android con Google Play .
Instalación y prueba de aplicaciones.
Use los siguientes consejos para solucionar problemas que sus evaluadores pueden encontrar cuando instalan y prueban 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 probador debe seguir estas pautas:
- No uses 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 el evaluador 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 usa el probador para aceptar la invitación (Correo electrónico B). Esto crea un vínculo entre bastidores. Cada vez que se agrega el correo electrónico A a las nuevas compilaciones, en realidad es el correo electrónico B el que obtiene acceso.
Si el probador aceptó la invitación por correo electrónico con una dirección de correo electrónico diferente, siga estos pasos para resolver el problema:
Elimina el tester de la pestaña Testers & Groups en la página App Distribution de Firebase console. Las invitaciones existentes se eliminan.
Vuelva a invitar al evaluador a probar su aplicación. El evaluador debe 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 algo de lo siguiente:
Las notificaciones por correo electrónico se envían a las carpetas de spam.
Los filtros de correo electrónico están configurados.
La invitación se envió a una cuenta de correo electrónico, pero el probador aceptó con una cuenta de correo electrónico diferente. El probador recibe nuevos correos electrónicos de lanzamiento para la cuenta de correo electrónico a la que se envió originalmente la invitación.
El probador fue invitado previamente pero no aceptó la invitación inicial. Si el probador se agrega a versiones posteriores, App Distribution no enviará automáticamente notificaciones de lanzamiento a ese probador porque no aceptó la invitación inicial.
Solución 1
Pídale al probador que verifique su carpeta de correo no deseado y cualquier filtro de correo electrónico que haya configurado en su servicio de correo electrónico.
Si el probador canceló la suscripción a los correos electrónicos, pídale que haga lo siguiente:
- Encuentre un correo electrónico que el probador haya recibido previamente de la aplicación.
- Haz clic en Administrar la configuración de correo electrónico en la parte inferior y haz clic en Permitir que los correos electrónicos se vuelvan a suscribir.
Solución 2
Elimine el probador de la pestaña Testers & Groups en la página de 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 debe 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 probador 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 de 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 tiene 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 , toca Seguridad y selecciona Fuentes desconocidas . Cuando aparezca el mensaje, toque Aceptar > Confiar .
Si un APK de prueba no se instala en el dispositivo de un probador:
- 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 solo 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 lo redirige a la pantalla de inicio de sesión, es posible que esté utilizando un espacio de trabajo de Google (anteriormente GSuite) que incluye configuraciones de restricción.
Para eliminar la configuración de restricciones:
En la pestaña Aplicaciones de su 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 eliminen las configuraciones, intente iniciar sesión nuevamente.
Este error puede ocurrir cuando la aplicación que se está instalando entra en conflicto con una aplicación que ya está 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 probador que recopile un informe de error inmediatamente después de experimentar el problema e inspeccione el informe para obtener más información sobre la causa. El probador debe eliminar cualquier aplicación en conflicto antes de que se pueda instalar la nueva aplicación.
Cuando encuentra un error 403, significa que la cuenta que está utilizando 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 debe tener permiso para instalar y probar aplicaciones, solicite 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 los servicios que no se controlan individualmente .
Si tiene varias cuentas, intente iniciar sesión con una cuenta diferente que no esté restringida para instalar y probar aplicaciones.
Habilitación de alertas en la aplicación con App Distribution Android SDK
Use los siguientes consejos para solucionar problemas que impliquen habilitar alertas de nueva compilación en la aplicación mediante el SDK de Android de distribución de aplicaciones.
Si ya configuró el SDK de Android App Distribution en su aplicación y sus evaluadores no reciben alertas en la aplicación, siga estos pasos:
Verifique los mensajes de error adjuntando un
OnFailureListener
a 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 } }
Verifique que el probador 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 probador no tiene acceso, es posible que su probador 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 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 que configuró su dispositivo de prueba correctamente:
En el dispositivo de prueba, inicie sesión en Firebase App Distribution a través de App Tester o a través de la aplicación web de prueba. Recuerde seleccionar la cuenta de Google que utilizó por primera vez cuando aceptó la invitación para probar la aplicación.
Verifique para asegurarse de que la nueva versión de la aplicación esté disponible en App Tester o en la aplicación web del probador.
De manera predeterminada, sus evaluadores solo necesitan iniciar sesión en su cuenta de Google una vez para habilitar nuevas actualizaciones de compilación e instalar nuevas compilaciones. Si se les solicita a sus evaluadores que inicien sesión nuevamente después de cerrar y volver a abrir su aplicación, siga estos consejos para asegurarse de que su configuración de distribución de aplicaciones esté configurada correctamente:
Asegúrate de haber habilitado la API de Firebase App Testers. Para obtener más información, consulte Habilitar la API del probador de distribución de aplicaciones .
En Restricciones de clave , asegúrese de que la API de Firebase App Testers esté incluida en la lista de API permitidas.
Si normalmente borra SharedPreferences al cerrar la sesión, es posible que esté borrando el estado de su evaluador. App Distribution almacena una marca que indica si su probador 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 evaluadores:
Agregue un máximo de 500 evaluadores a un proyecto de Firebase
Agregar 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 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 volviendo a enviarla a través del menú desplegable en la fila del probador.
Los lanzamientos de aplicaciones se eliminan de App Distribution si ocurre una de las siguientes condiciones:
- La versión de la aplicación tiene más de 150 días.
- Supera el límite de 1000 lanzamientos de 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 versiones, la versión se elimina del panel de distribución de aplicaciones y de la aplicación Firebase App Tester. Si su probador 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, use una de las siguientes recomendaciones:
- Antes de que el lanzamiento de la aplicación caduque o exceda el límite de lanzamiento, descargue el APK o AAB y elimine el lanzamiento 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 carga una versión de su 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 el lanzamiento, puede distribuirlo a los evaluadores, quienes instalan el lanzamiento 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
App Distribution permite un máximo de 1000 lanzamientos por aplicación. Cuando su aplicación alcanza el límite de 1000 versiones, App Distribution elimina automáticamente las versiones más antiguas que superan el límite.
Si desea administrar manualmente los lanzamientos de su aplicación, use la API REST de distribución de aplicaciones para enumerar y eliminar los lanzamientos de aplicaciones de forma masiva.
Si tiene preguntas, comuníquese con el Soporte de Firebase .
Si es un probador, le recomendamos que descargue Firebase App Tester , una aplicación que le permite acceder a todas sus compilaciones de prueba en un solo lugar.
Para eliminar su cuenta de probador de distribución de aplicaciones 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 )Eliminar cuenta .
Opcional: en los permisos de su cuenta de Google , revoque el acceso de Firebase App Distribution. Tenga en cuenta que revocar el acceso sin eliminar primero su cuenta de distribución de aplicaciones no elimina su cuenta de probador ni sus datos.