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.
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:
Verifique el tamaño de la IPA. 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 IPA está dentro del límite de tamaño de archivo y es reproducible, siga estos pasos:
Verifique su archivo
Info.plisty confirme siCFBundleDisplayNamecontiene algún delimitador<array>.Elimine los delimitadores
<array>y reconstruya su aplicación. La carga debería realizarse correctamente.Si aún tiene problemas, comuníquese con el soporte de Firebase .
Si el tamaño IPA supera el límite de tamaño del archivo, realice los cambios necesarios para reducir el tamaño del archivo.
Si reducir el tamaño del archivo IPA no resuelve el problema, comuníquese con el soporte de Firebase y pregunte sobre el uso de Testflight .
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 al evaluador no le importa recibir notificaciones por correo electrónico y solo quiere poder aceptar invitaciones a aplicaciones, puede ver las invitaciones a aplicaciones pendientes directamente en el clip web de Firebase App Distribution: appdistribution.firebase.google.com .
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.
El error de 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 > Perfiles y administración de dispositivos , seleccione el nombre del desarrollador de la aplicación y confíe en él.
El error Se requiere modo de desarrollador aparece cuando intenta iniciar una aplicación de iOS proporcionada 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 tu iPhone, abre la aplicación Configuración y luego toca Privacidad y seguridad .
- Desplácese hacia abajo hasta Seguridad y toque Modo desarrollador .
- Toque el control deslizante Modo de desarrollador .
- Toca Reiniciar .
- Después de que el dispositivo se reinicie, desbloquéelo. ¿Activar el modo de desarrollador? Aparece el cuadro de diálogo.
- Toca Activar . Ahora puede iniciar su aplicación y comenzar a probarla.
Si está instalando una distribución Ad Hoc, este mensaje aparece cuando el desarrollador aún no ha configurado su aplicación para ejecutarse 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ó previamente (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. Vuelve a intentarlo iniciando sesión con la cuenta de Google que utilizaste anteriormente para aceptar la invitació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.
Habilitación de alertas en la aplicación con el SDK de iOS de distribución de aplicaciones
Utilice los siguientes consejos para solucionar problemas que implican habilitar alertas de nuevas compilaciones en la aplicación mediante el SDK de iOS de App Distribution.
Si ya configuró el SDK de iOS de distribución de aplicaciones en su aplicación y sus evaluadores no reciben alertas en la aplicación, verifique que su aplicación esté obteniendo 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]".
Compruebe que el evaluador 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 donde el cuadro de diálogo de alerta se carga antes de que aparezca la Vista.
Si no se devuelve ninguna versión, 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 actualizaciones, 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 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 forma predeterminada, sus evaluadores solo necesitan iniciar sesión en su cuenta de Google una vez para habilitar alertas de nuevas compilaciones e instalar nuevas compilaciones. 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 UserDefaults 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.
Consulte Registrar dispositivos adicionales .
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 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 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 la IPA y elimine la versión del panel de distribución de aplicaciones. Luego, vuelva a cargar la 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 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 instalan la versión desde la aplicación web del probador de App Distribution 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 versión en la página Distribución de aplicaciones de Firebase console y en la aplicación web del probador de Distribución de aplicaciones.
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 .
El perfil de Firebase es un perfil de configuración que permite a App Distribution:
Registre el dispositivo de prueba recopilando su ID de dispositivo único (UDID). Si estás 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 pueda probarse en tu 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 que estás invitado a probar se agregan automáticamente al clip web.
Para obtener ayuda sobre cómo instalar perfiles de configuración en su dispositivo iOS, consulte la documentación de Apple .
Si es un tester, 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 has hecho, inicia sesión en Google y acepta la invitación.
En Probar aplicaciones , 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 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.