En esta página, se proporciona ayuda para la solución de problemas y respuestas a preguntas frecuentes sobre la distribución y prueba de apps con App Distribution.
Distribución de apps
Usa las siguientes sugerencias para solucionar problemas que podrían surgir durante la distribución de apps a tus verificadores.
No se puede distribuir una app porque falta el correo electrónico de contacto
Cuando subas una app, es posible que veas el siguiente error:
"We could not find a contact email for app <app-id>
. Please visit
App Distribution within the Firebase console to set one up”.
Si está disponible, configura un correo electrónico de contacto en Firebase console. Si el problema persiste, comunícate con el equipo de Asistencia de Firebase.
Se produjo un error cuando se aprovisionaba la app (errores 400, 409 o 500)
Si encuentras los errores 400, 409 o 500 durante el aprovisionamiento, comunícate con el equipo de Asistencia de Firebase. Indica el número del proyecto de Firebase y el identificador de la app.
No se pudo subir el archivo IPA
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 el problema, sigue estos pasos:
Verifica el tamaño del IPA. El límite máximo para todos los objetos binarios es de 2,048 MiB, que es un poco más de 2 GB.
Si el tamaño del IPA cumple con el límite y puedes reproducir el error, sigue estos pasos:
Verifica el archivo
Info.plist
y confirma siCFBundleDisplayName
contiene delimitadores de<array>
.Quita los delimitadores
<array>
y vuelve a compilar la app. La carga debería realizarse correctamente.Si los problemas persisten, comunícate con el equipo de Asistencia de Firebase.
Si el tamaño del IPA supera el límite, realiza los cambios necesarios para reducirlo.
Si la disminución del tamaño del archivo IPA no resuelve el problema, comunícate con el equipo de Asistencia de Firebase y consulta sobre el uso de Testflight.
Instala y prueba apps
Usa las siguientes sugerencias para solucionar problemas que los verificadores podrían encontrar cuando instalen y prueben tus apps.
El verificador no tiene una Cuenta de Google
Cuando un usuario crea una Cuenta de Google, recibe automáticamente una dirección de Gmail.
Si un verificador no tiene una dirección de Google Workspace o Gmail, o si prefiere usar otra dirección de correo electrónico, pídele que la vincule a la cuenta y la utilice para acceder.
Al momento de elegir un correo electrónico alternativo, el verificador debe seguir estos lineamientos:
- No usar una dirección de Gmail
- No usar una dirección de correo electrónico que ya esté vinculada a otra Cuenta de Google
- Usar la contraseña de la Cuenta de Google cuando acceda con esta dirección de correo electrónico
Para obtener más información, consulta Cómo acceder a tu Cuenta de Google con otra dirección de correo electrónico.
El verificador no puede ver las apps ni las compilaciones correctas
Si el verificador aceptó la invitación con una dirección de correo electrónico diferente a la de la invitación, es posible que no pueda ver las apps o compilaciones correctas.
El correo electrónico al que el desarrollador envía invitaciones y que se agrega a compilaciones nuevas (correo electrónico A) puede ser diferente del correo electrónico que el verificador usa para aceptar la invitación (correo electrónico B). Esta acción crea un vínculo detrás de escena. Cuando se agrega el correo electrónico A a compilaciones nuevas, en realidad es el correo electrónico B el que puede acceder.
Si el verificador aceptó la invitación con una dirección de correo electrónico diferente, sigue estos pasos para resolver el problema:
Borra al verificador de la sección Ver todos los verificadores de la pestaña Verificadores y grupos en la página de App Distribution de Firebase console. De esta forma, se quitan las invitaciones existentes.
Vuelve a invitar al verificador para que pruebe tu app. Este debería recibir un correo electrónico de invitación.
Asegúrate de que acepte la invitación con la misma dirección de correo electrónico.
El verificador no recibe notificaciones por correo electrónico
Es posible que los verificadores no reciban notificaciones por correo electrónico si ocurre alguna de las siguientes situaciones:
Las notificaciones por correo electrónico llegan a la carpeta de spam.
El correo electrónico tiene filtros.
La invitación se envió a una cuenta de correo electrónico, pero el verificador aceptó con otra cuenta. El verificador recibe correos electrónicos con nuevos lanzamientos en la cuenta a la que se envió originalmente la invitación.
El verificador se invitó anteriormente, pero no aceptó la invitación inicial. Si se agrega el verificador a las versiones posteriores, App Distribution no le enviará notificaciones de lanzamiento automáticamente debido a que no aceptó la invitación inicial.
Solución 1
Pídele al verificador que revise su carpeta de spam y los filtros que configuró en su servicio de correo electrónico.
Si el verificador anuló la suscripción a los correos electrónicos, pídele que haga lo siguiente:
- Busca uno de los correos electrónicos que el verificador recibió anteriormente de la app.
- Haz clic en Administrar la configuración de correo electrónico en la parte inferior y haz clic en Permitir correos electrónicos para volver a suscribirlo.
Solución 2
Si al verificador no le interesa recibir notificaciones por correo electrónico y solo desea aceptar invitaciones de apps, puede ver las invitaciones de apps pendientes directamente en el clip web de Firebase App Distribution: appdistribution.firebase.google.com.
Solución 3
Borra al verificador de la sección Ver todos los verificadores de la pestaña Verificadores y grupos en la página de App Distribution en Firebase console. Esta acción quita las invitaciones existentes.
Vuelve a invitar al verificador para que pruebe tu app. Este debería recibir un correo electrónico de invitación. Asegúrate de que acepte la invitación con la misma dirección de correo electrónico a la que se envió.
Aparece el error “Desarrollador empresarial no confiable” cuando se intenta ejecutar la app de prueba
Aparecerá el error Desarrollador empresarial no confiable si no confías en el certificado de desarrollador en el dispositivo de prueba antes de abrir la app. En la app de Configuración, ve a la pantalla Perfiles y administración de dispositivos, selecciona el nombre del desarrollador de la app y confía en ella.
Aparece el error que indica “modo de desarrollador obligatorio” cuando se intenta ejecutar la app de prueba
El error de modo de desarrollador obligatorio se muestra cuando intentas iniciar una app para iOS aprovisionada en anuncios en iOS 16 o versiones posteriores sin primero habilitar el modo de desarrollador.
Para habilitar este modo y resolver el error, sigue estos pasos:
- En tu iPhone, abre la app de Configuración y presiona Privacidad y seguridad.
- Desplázate hacia abajo hasta Seguridad y presiona Modo de desarrollador.
- Presiona el control deslizante Modo de desarrollador.
- Presiona Reiniciar.
- Después de que se reinicie, desbloquea el dispositivo. Aparecerá el cuadro de diálogo ¿Deseas activar el modo de desarrollador?
- Presiona Activar. Ahora puedes iniciar tu app y comenzar a realizar pruebas.
“Se registró el dispositivo y está todo listo. Recibirás un correo electrónico cuando la app esté lista para probarla”.
Si instalas una distribución ad hoc, este mensaje aparece cuando el desarrollador todavía no ha configurado su app para que se ejecute en tu dispositivo de prueba. Para que la app esté disponible, el desarrollador debe completar las instrucciones que se indican en Registra dispositivos adicionales.
La Cuenta de Google no tiene acceso a la app de prueba
Si tu Cuenta de Google no tiene acceso a una app de prueba que ya instalaste (o de la que aceptaste una invitación), es probable que hayas accedido a la cuenta incorrecta. Las apps a las que tienes acceso están asociadas con la Cuenta de Google que usaste la primera vez que aceptaste la invitación para probar la app. Vuelve a acceder con la Cuenta de Google que usaste para aceptar la invitación.
Error 403: “Comunícate con tu administrador para obtener acceso”
Si encuentras un error del tipo 403, la cuenta que estás usando no tiene permiso para instalar ni probar apps. El administrador del dominio de tu cuenta de Google Workspace determina el acceso.
Si crees que deberías tener permiso para instalar y probar apps, pídele al administrador de tu cuenta de Google Workspace que cambie la configuración. Este debe seguir las instrucciones del artículo sobre cómo administrar el acceso a los servicios que no se pueden controlar por separado.
Si tienes varias cuentas, intenta acceder con una diferente que no te impida instalar y probar apps.
Habilita alertas integradas en la app con el SDK de Firebase App Distribution para iOS
Usa las siguientes sugerencias para solucionar problemas relacionados con la habilitación de alertas de compilación nuevas en la app mediante el SDK de iOS de App Distribution.
El verificador no recibe alertas en la app
Si ya configuraste el SDK de iOS de App Distribution en la app y los verificadores no reciben alertas en ella, asegúrate de que la app esté recuperando actualizaciones nuevas de la siguiente forma:
Habilita el modo de depuración en la app. Para obtener más información, consulta la documentación de Google Analytics.
Ejecuta tu app en un simulador y busca la string “[Firebase/AppDistribution]”.
Comprueba que el verificador tenga acceso a la versión nueva:
Si se muestra un objeto de versión válido, es probable que haya un problema en el ciclo de vida de los controladores de vista en los que se carga el diálogo de alerta antes de que aparezca la vista.
Si no se muestra ninguna versión, es posible que tu verificador no esté asociado con la versión nueva. En el panel de App Distribution de Firebase console, asegúrate de que el verificador esté incluido en la distribución de compilación y que el estado de la invitación sea Aceptada.
Si el verificador aún no recibe actualizaciones, pídele que siga estas sugerencias para confirmar que haya aceptado la invitación a fin de probar la app y configurado el dispositivo de prueba de manera correcta:
En el dispositivo de prueba, accede al clip web de Firebase App Distribution. Recuerda seleccionar la Cuenta de Google que usaste cuando aceptaste la invitación para probar la app.
Asegúrate de que la nueva versión de la app esté disponible en el clip web.
Se solicitó que el verificador volviera a acceder después de cerrar la app
De forma predeterminada, los verificadores solo deben acceder a su Cuenta de Google una vez para habilitar las alertas de compilación nuevas y, además, instalar compilaciones nuevas. Si se solicita a los verificadores que vuelvan a acceder luego de cerrar y volver a abrir la app, sigue estas sugerencias para asegurarte de que App Distribution esté configurado correctamente:
Asegúrate de haber habilitado la API de Firebase App Tester. Para obtener más información, consulta Habilita la API de App Distribution Tester.
En Restricciones de claves, asegúrate de que la API de App Distribution Tester se incluya en la lista de API permitidas.
Si sueles borrar UserDefaults cuando sales, es posible que estés borrando el estado del verificador. App Distribution almacena una marca que indica si el verificador ya accedió a la app. Para obtener más información, consulta el repositorio de GitHub.
Preguntas frecuentes
¿Hay límites para agregar verificadores a mi app?
Firebase App Distribution tiene los siguientes límites de verificadores:
Agrega un máximo de 500 verificadores a un proyecto de Firebase.
Agrega un máximo de 200 verificadores a un grupo de App Distribution.
Para agregar más verificadores, solicita un aumento de límite sin costo.
¿Mis invitaciones de verificador vencen?
Los verificadores tendrán 30 días para aceptar una invitación a fin de probar la app antes de que venza. Cuando falten 5 días para que venza la invitación, aparecerá un aviso en Firebase console junto al verificador en una versión. Si quieres renovar una invitación, puedes usar el menú desplegable de la fila del verificador para reenviarla.
¿Cuándo se crea una nueva versión para las cargas de iOS?
Consulta Registra dispositivos adicionales.
¿Durante cuánto tiempo están disponibles las versiones de las apps?
Las versiones de la app se quitan de App Distribution si se produce alguna de las siguientes condiciones:
- La versión de la app tiene más de 150 días de antigüedad.
- Superaste el límite de 1,000 versiones de apps y la versión es anterior a las 1,000 más recientes.
Para obtener más información, consulta App Distribution admite un máximo de 1,000 versiones.
Una vez que la app alcanza o supera el límite de vencimiento de 150 días o el de 1,000, la versión se quita del panel de App Distribution y de la app web de prueba de App Distribution. Si el verificador instaló la versión, se seguirá ejecutando la versión local de la app.
Para que la versión de la app permanezca disponible por más tiempo, usa una de las siguientes recomendaciones:
- Antes de que la versión venza o supere el límite de versiones, descarga el archivo IPA y borra la versión del panel de App Distribution. Luego, vuelve a subir el archivo IPA como una compilación nueva a App Distribution.
- Descarga la versión y súbela a Cloud Storage para archivarla a largo plazo.
Las versiones de la app vencen después de 150 días
Cuando subes una versión de tu app en Firebase, esta aparece en el panel de App Distribution durante 150 días a partir de la fecha de carga. Después de subir la versión, puedes distribuirla a los verificadores que instalan la versión desde la aplicación web de verificadores de App Distribution en su dispositivo de prueba.
Cuando la versión esté a 30 días de la fecha de vencimiento, aparecerá una notificación de vencimiento de la app en la página App Distribution de Firebase console y en la aplicación web de verificador de App Distribution.
App Distribution admite un máximo de 1,000 versiones
App Distribution permite un máximo de 1,000 versiones por app. Cuando tu app alcanza el límite de 1,000 versiones, App Distribution borra automáticamente las versiones más antiguas que superan el límite.
Si deseas administrar las actualizaciones de tus apps de forma manual, usa la API de REST de App Distribution para enumerar y borrar versiones de la app de forma masiva.
Si tienes preguntas, comunícate con el equipo de Asistencia de Firebase.
¿Qué es el perfil de Firebase?
El perfil de Firebase es un perfil de configuración que permite que App Distribution realice las siguientes acciones:
Registrar el dispositivo de prueba mediante la recopilación del ID de dispositivo único (UDID). Si estás probando una distribución de Ad Hoc, Firebase envía un correo electrónico al desarrollador de la app, el cual incluye el UDID del dispositivo de prueba, junto con instrucciones para incluir el dispositivo en el perfil de aprovisionamiento de la app a fin de que se pueda probar la compilación en tu dispositivo
Instalar un clip web de Firebase App Distribution en la pantalla principal de tu dispositivo. El clip web te permite instalar y acceder a todas tus aplicaciones de prueba en un solo lugar. Las nuevas compilaciones que te invitan a probar se agregan automáticamente al clip web
A fin de obtener ayuda para instalar perfiles de configuración en tu dispositivo iOS, consulta la documentación de Apple.
¿Cómo puedo acceder a las apps de prueba que instalé en mi dispositivo?
Si eres verificador, puedes acceder a todas tus apps de prueba con el clip web de Firebase App Distribution, que se agrega automáticamente a la pantalla principal de tu dispositivo de prueba cuando instalas el perfil de Firebase. Si estás probando una distribución Ad Hoc, primero debes instalar el perfil antes de poder probar la app.
Si estás probando una distribución empresarial, puedes instalar el perfil de forma manual:
Si aún no lo has hecho, accede a Google y acepta la invitación.
En Test apps, selecciona la app que quieres probar.
En la parte superior derecha de la página de la app, presiona mobile_screen_share.
Sigue las instrucciones que se muestran para instalar el perfil de Firebase.
¿Cómo borro mi cuenta de verificador?
Para borrar tu cuenta de verificador de App Distribution y sus datos asociados, sigue estos pasos en orden:
Visita https://appdistribution.firebase.google.com y accede con tu Cuenta de Google.
En la parte superior derecha, haz clic en settings (Manage account)
Borrar cuenta.
Opcional: En los permisos de tu Cuenta de Google, revoca el acceso desde Firebase App Distribution. Ten en cuenta que si revocas el acceso sin borrar primero la cuenta de App Distribution no se borrarán ni tu cuenta ni tus datos de verificador.