Comprueba si los Universal Links de tu app iOS están bien configurados. Escribe tu dominio y la herramienta descarga el archivo apple-app-site-association, revisa todo lo que Apple exige y te dice qué URLs abrirán tu app. También comprueba qué versión tiene ya la CDN de Apple, que es la que usan los iPhone.
Cargando…
Qué comprueba
- Dónde está el archivo: en
/.well-known/apple-app-site-association(lo recomendado) o en la raíz del dominio. - HTTPS con certificado válido y sin redirecciones: Apple no sigue redirecciones, así que si tu servidor manda de
ejemplo.comawww.ejemplo.com, el archivo tiene que estar en los dos dominios que declares. - Que sea JSON válido, sin extensión
.json, sin BOM y de menos de 128 KB. - Los IDs de las apps: tienen que ser
TEAMID.bundle.id, con el Team ID de 10 caracteres de tu cuenta de desarrollador. - Las reglas de
components(iOS 13 y posteriores) o del formato antiguopaths, incluidas las exclusiones. - La copia de Apple: los iPhone no descargan el archivo de tu servidor, sino de la CDN de Apple. Si acabas de cambiarlo, te avisa de que Apple aún tiene la versión anterior.
Prueba si una URL abrirá tu app
Debajo de las reglas puedes escribir una ruta, por ejemplo /producto/123?ref=email, y la herramienta aplica las reglas en el mismo orden que iOS: gana la primera que coincide, y si es una exclusión la URL se abre en Safari. En los patrones, * equivale a cualquier texto y ? a un solo carácter.
Ejemplo de archivo apple-app-site-association
{
"applinks": {
"details": [
{
"appIDs": ["ABCDE12345.com.tuempresa.tuapp"],
"components": [
{ "/": "/admin/*", "exclude": true, "comment": "Nunca abrir el panel en la app" },
{ "/": "/producto/*" },
{ "/": "/promo", "?": { "ref": "email*" } }
]
}
]
},
"webcredentials": {
"apps": ["ABCDE12345.com.tuempresa.tuapp"]
}
}
En Xcode, añade en Signing & Capabilities → Associated Domains las entradas applinks:tudominio.com y, si usas autocompletar contraseñas, webcredentials:tudominio.com.
Preguntas frecuentes
He cambiado el archivo y mi iPhone sigue igual, ¿por qué?
Porque iOS usa la copia de la CDN de Apple, que se actualiza sola pasado un tiempo (normalmente horas, a veces algo más). Mientras desarrollas puedes saltártela añadiendo ?mode=developer a la entrada de Associated Domains y activando el modo desarrollador de dominios asociados en los ajustes de desarrollador del iPhone.
¿Hace falta el Content-Type application/json?
Es lo recomendable. La herramienta lo marca como aviso y no como error, porque lo importante es que el contenido sea JSON válido y se sirva sin redirecciones.
¿Al pulsar un enlace dentro de mi propia web se abre la app?
No: iOS no abre la app si el usuario ya está navegando por el mismo dominio en Safari. Pruébalo desde Notas o Mensajes.
¿Guardáis los dominios que compruebo?
No. El resultado se guarda solo dos minutos en caché para no saturar tu servidor si repites la comprobación, y después se borra.
Si vas a montar el backend de tu app, en el iOS Backend Starter tienes push, Sign in with Apple y Stripe ya funcionando. Y tienes más utilidades en las herramientas para desarrolladores iOS.