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.
El siguiente es un ejemplo de una respuesta de red del navegador:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
Para resolver este problema, siga estos pasos:
Verifica el tamaño de la IPA. 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 de IPA está dentro del límite de tamaño de archivo y es reproducible, siga estos pasos:
Verifique su archivo
Info.plist
y confirme siCFBundleDisplayName
contiene algún delimitador<array>
.Elimine los delimitadores
<array>
y reconstruya su aplicación. La carga debería tener éxito.Si aún tiene problemas, comuníquese con el Soporte de Firebase .
Si el tamaño de IPA supera el límite de tamaño del archivo, realice los cambios necesarios para reducir el tamaño del archivo.
Si disminuir el tamaño del archivo IPA no resuelve el problema, comuníquese con el Soporte de Firebase y pregunte sobre el uso de Testflight .
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.
El error Desarrollador empresarial no confiable aparece si no confiaba en el certificado de desarrollador en el dispositivo de prueba antes de abrir la aplicación. En la pantalla Configuración de la aplicación > Administración de perfiles y dispositivos , seleccione el nombre del desarrollador de la aplicación y confíe en él.
El error de modo de desarrollador requerido aparece cuando intenta iniciar una aplicación de iOS aprovisionada ad hoc en iOS 16 o posterior sin habilitar primero el modo de desarrollador.
Para habilitar el modo de desarrollador y resolver este error, siga estos pasos:
- En su iPhone, abra la aplicación Configuración y luego toque Privacidad y seguridad .
- Desplácese hacia abajo hasta Seguridad y toque Modo desarrollador .
- Toque el control deslizante Modo de desarrollador .
- Presiona Reiniciar .
- Después de que el dispositivo se reinicie, desbloquee el dispositivo. ¿Activar el modo de desarrollador? aparece el cuadro de diálogo.
- Presiona Activar . Ahora puede iniciar su aplicación y comenzar a probar.
Si está instalando una distribución Ad Hoc, este mensaje aparece cuando el desarrollador aún no ha configurado su aplicación para que se ejecute en su dispositivo de prueba. Para que la aplicación esté disponible para usted, el desarrollador debe completar las instrucciones en Registrar dispositivos adicionales .
Si su cuenta de Google no tiene acceso a una aplicación de prueba que instaló anteriormente (o para la que aceptó una invitación), es probable que haya iniciado sesión en la cuenta de Google incorrecta. Las aplicaciones a las que tiene acceso están asociadas con la cuenta de Google que utilizó cuando aceptó por primera vez la invitación para probar la aplicación. Vuelva a intentarlo iniciando sesión con la cuenta de Google que utilizó anteriormente para aceptar la invitació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 iOS SDK
Use los siguientes consejos para solucionar problemas que impliquen habilitar alertas de nueva compilación en la aplicación mediante el SDK de iOS de distribución de aplicaciones.
Si ya configuró App Distribution iOS SDK en su aplicación y sus evaluadores no reciben alertas en la aplicación, asegúrese de que su aplicación obtenga nuevas versiones:
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 "[Firebase/AppDistribution]".
Verifique que el probador tenga acceso a la nueva versión:
Si se devuelve un objeto de versión válido, es probable que haya un problema en el ciclo de vida del controlador de vista en el que se carga el cuadro de diálogo de alerta antes de que aparezca la vista.
Si no se devuelve ninguna versión, 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 actualizaciones, 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 el clip web de Firebase App Distribution. Recuerde seleccionar la cuenta de Google que utilizó por primera vez cuando aceptó la invitación para probar la aplicación.
Asegúrese de que la nueva versión de la aplicación esté disponible en el clip web.
De manera predeterminada, sus evaluadores solo necesitan iniciar sesión en su cuenta de Google una vez para habilitar las alertas de nuevas compilaciones 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 los valores predeterminados de usuario al cerrar 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.
Consulte Registrar dispositivos adicionales .
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 caducidad de 150 días o el límite de lanzamiento de 1000 aplicaciones, el lanzamiento se elimina del panel de distribución de aplicaciones y de la aplicación web del probador de distribución de aplicaciones. 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 supere el límite de lanzamiento, descargue el IPA y elimine el lanzamiento del panel de distribución de aplicaciones. Luego, vuelva a cargar el IPA 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 web del evaluador de distribución de aplicaciones 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 de lanzamiento de la aplicación en su lanzamiento en la página de distribución de aplicaciones de la consola de Firebase y en la aplicación web del probador de distribución de aplicaciones.
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 .
El perfil de Firebase es un perfil de configuración que permite a App Distribution:
Registre el dispositivo de prueba recopilando el ID de dispositivo único (UDID) del dispositivo. Si está probando una distribución Ad Hoc, Firebase envía al desarrollador de la aplicación un correo electrónico que incluye el UDID del dispositivo de prueba, junto con instrucciones sobre cómo incluir el dispositivo en el perfil de aprovisionamiento de la aplicación para que la compilación se pueda probar en su dispositivo.
Instale un clip web de Firebase App Distribution en la pantalla de inicio de su dispositivo. El clip web le permite instalar y acceder a todas sus aplicaciones de prueba en un solo lugar. Las nuevas compilaciones a las que está invitado a probar se agregan automáticamente al clip web.
Para obtener ayuda sobre la instalación de perfiles de configuración en su dispositivo iOS, consulte la documentación de Apple .
Si es un probador, puede acceder a todas sus aplicaciones de prueba con el clip web de Firebase App Distribution , que se agrega automáticamente a la pantalla de inicio de su dispositivo de prueba cuando instala el perfil de Firebase. Si está probando una distribución Ad Hoc, primero debe instalar el perfil antes de poder probar la aplicación.
Si está probando una distribución empresarial, puede instalar manualmente el perfil:
Si aún no lo ha hecho, inicie sesión en Google y acepte la invitación.
En Aplicaciones de prueba , seleccione la aplicación que desea probar.
En la parte superior derecha de la página de la aplicación, toca mobile_screen_share .
Siga las instrucciones que se muestran para instalar el perfil de Firebase.
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.