Los problemas descritos aquí son específicos de iOS. Los problemas de instalación en Android suelen estar causados por el ajuste "Fuentes desconocidas" — consulta Fuentes desconocidas en Android para obtener más información.
Diagnóstico rápido: ¿qué estás viendo?
| Síntoma | Causa más probable |
|---|---|
| La barra de progreso aparece pero no avanza | Problema de conectividad de red |
| La instalación de la app se queda en "Esperando…" | Problema de conectividad de red |
| El icono de la app se vuelve gris oscuro y no es pulsable | Problema con el certificado o el perfil de aprovisionamiento |
| Alerta: "No se puede instalar — la integridad no se pudo verificar" | Fallo en la firma del código |
La barra de progreso aparece pero no avanza
Causa: El dispositivo no puede llegar a los servidores de descarga de Applivery. Casi siempre es un problema de red.
Resolución:
Asegúrate de que el dispositivo tiene una conexión a internet estable — cambia entre Wi-Fi y datos móviles para descartar un problema específico de la conexión.
Cancela la descarga e inténtalo de nuevo.
Si el problema persiste, prueba en una red diferente.
La instalación de la app se queda en "Esperando…"
Causa: iOS puso la instalación en cola pero no puede continuar — lo más habitual es un timeout de red durante la descarga o un estado de sobrecarga del dispositivo.
Resolución:
Asegúrate de que el dispositivo tiene una conexión a internet estable e inténtalo de nuevo.
Si el problema persiste, apaga el dispositivo completamente, espera al menos 5 minutos, vuélvelo a encender y reinténtalo.
Si sigue bloqueándose, usa el depurador de instalación de iOS para obtener más detalles sobre dónde falla el proceso.
El icono de la app se vuelve gris oscuro y no es pulsable
Este síntoma significa que iOS comenzó la instalación pero se detuvo antes de completarla. La causa está siempre relacionada con la configuración de firma de la App. Sigue estas comprobaciones:
UDID del dispositivo faltante (solo distribución Ad-hoc)
Si la App se firmó con un certificado Ad-hoc, el UDID del dispositivo debe estar incluido en el perfil de aprovisionamiento. Si no lo está, iOS fallará silenciosamente al instalar.
Resolución:
En el panel de Applivery, abre los detalles de la Build y anota el UDID del dispositivo.
Añade el UDID a tu perfil de aprovisionamiento en el Apple Developer Portal.
Descarga el perfil de aprovisionamiento actualizado, vuelve a firmar la App y sube la nueva Build a Applivery.
Perfil de aprovisionamiento caducado
Los perfiles de aprovisionamiento tienen una validez máxima de un año. Un perfil caducado impedirá la instalación aunque el certificado de firma siga siendo válido.
Resolución:
Renueva el perfil de aprovisionamiento en el Apple Developer Portal.
Reconstruye la App con el perfil actualizado y sube la nueva Build a Applivery.
Certificado de firma caducado
Tanto los certificados de firma Ad-hoc como los Enterprise caducan. Un certificado caducado invalida todas las Builds firmadas con él, aunque el perfil de aprovisionamiento siga siendo válido.
Resolución:
Renueva o crea un nuevo certificado de firma en el Apple Developer Portal.
Actualiza la configuración de firma en Xcode, reconstruye la App y sube la nueva Build a Applivery.
Otros problemas de firma
Si ninguno de los puntos anteriores aplica, puede haber una discrepancia entre el certificado, el perfil y el bundle identifier.
Resolución:
Verifica que el bundle identifier en tu proyecto de Xcode coincide exactamente con el del perfil de aprovisionamiento.
Comprueba que el certificado usado para firmar la Build es el asociado al perfil de aprovisionamiento.
Usa el depurador de instalación de iOS para capturar el error específico.
Alerta: "No se puede instalar — la integridad no se pudo verificar"
Mensaje completo: No se puede instalar "Nombre de la App": Esta app no se puede instalar porque su integridad no se pudo verificar.
Causa: Apple comprobó la firma del código de la App después de la descarga y la encontró inválida. Esto normalmente significa que el perfil de aprovisionamiento incluido en la App no coincide con el certificado de firma, o que el perfil ha caducado.
Resolución:
Comprueba el perfil de aprovisionamiento asociado a la Build — asegúrate de que no ha caducado y coincide con el certificado de firma utilizado.
Reconstruye la App con una combinación válida de perfil y certificado y sube la nueva Build a Applivery.
Si el problema persiste, usa el depurador de instalación de iOS para capturar el punto exacto del fallo.