El enlace profundo es una técnica poderosa que permite que las aplicaciones móviles se abran directamente a contenidos o páginas específicos dentro de la aplicación. En dispositivos iOS, esto se logra mediante el uso de esquemas URL, que son URL personalizadas que activan acciones específicas en una aplicación. Cuando se combina con un CMS sin cabeza como Directus, puede administrar dinámicamente el contenido que estos enlaces profundos apuntan, permitiendo una experiencia móvil escalable y basada en contenido.

¿Cuál es el Plan de URL de iOS?

El esquema de URL de iOS es un protocolo que permite a las aplicaciones comunicarse entre sí usando URLs personalizadas. Cada aplicación puede registrar uno o más esquemas personalizados (por ejemplo, , ) en su archivo . Cuando el sistema encuentra un enlace que comienza con uno de estos esquemas, se lanza la aplicación correspondiente y pasa la URL completa a ella.

Por ejemplo, el esquema conocido puede llevar a los usuarios directamente a un tweet, un perfil de usuario, o la pantalla compuesta según el camino anexado. De manera similar, puede abrir la aplicación Uber con un destino pre-llenado. Este comportamiento directo al contenido es lo que hace que los esquemas de URL sean tan valiosos para los desarrolladores de aplicaciones que buscan reducir la fricción y aumentar el compromiso.

Desde una perspectiva técnica, los esquemas de URL utilizan los mismos elementos estructurales que las URL web: un esquema, un host, un camino opcional y parámetros de consulta. La diferencia clave es que el esquema no es o sino una cadena personalizada registrada por la aplicación. Esto permite al sistema operativo identificar de forma única qué aplicación debe manejar el enlace.

Cómo funciona el vínculo profundo con esquemas de URL

La conexión profunda con los esquemas de URL de iOS implica construir una URL que le diga a la aplicación exactamente a dónde ir. La estructura típica es:

  • Esquema:] El identificador de protocolo personalizado (por ejemplo, )
  • Host:] Una cadena similar a un dominio que identifica el área de destino (por ejemplo, , )
  • Path:] Uno o más componentes de la ruta para especificar el recurso exacto (por ejemplo, )
  • Parámetros: Buscar pares de valor clave que pasan contexto adicional (por ejemplo, )

Cuando un usuario toca tal enlace en un dispositivo iOS, el sistema comprueba si alguna aplicación instalada ha registrado el esquema. Si es así, lanza la aplicación y da la URL al método delegado de la aplicación. La aplicación entonces analiza la URL y navega a la vista o pantalla correspondiente. Si no se registra ninguna aplicación, el sistema puede volver al navegador web predeterminado, pero sólo si el enlace utiliza un enlace universal (más en eso más adelante).

Para un vínculo profundo con el trabajo fiable, los desarrolladores deben asegurarse de que la estructura URL sea consistente tanto en el contenido web que alberga los enlaces como en la lógica de la aplicación. Aquí es donde un sistema de gestión de contenidos como Directus puede ayudar mediante el almacenamiento de las URLs canónicas o IDs que impulsan la navegación de la aplicación.

Enlaces universales vs. esquemas de URL personalizados

Apple introdujo Enlaces Universales en iOS 9 como una alternativa más segura y sin problemas a los esquemas de URL personalizados. Los enlaces universales utilizan URLs estándar HTTP/HTTPS (por ejemplo, ) y requieren validación de lado del servidor a través de un archivo . Cuando un usuario pulsa un enlace Universal, iOS revisa el archivo, abre la aplicación directamente si se instala, y no deja ningún enlace del navegador redirigido.

Los esquemas de URL personalizados, por otro lado, tienen algunos inconvenientes: pueden entrar en conflicto con otras aplicaciones (dos aplicaciones pueden registrar el mismo esquema), no se desploman con gracia (el sistema muestra un error si la aplicación falta), y pueden ser secuestrados por aplicaciones maliciosas. A pesar de estas limitaciones, los esquemas de URL personalizados todavía son ampliamente utilizados, especialmente para enlaces profundos dentro de una sola aplicación o para la comunicación entre aplicaciones cuando no se admiten Enlaces.

Para aplicaciones de producción, Apple recomienda utilizar Universal Links como el principal mecanismo de conexión profunda y volver a los esquemas de URL personalizados para soportes heredados o casos de uso específicos. Muchas aplicaciones modernas, incluyendo aquellas integradas con Directus, implementan tanto para asegurar la máxima compatibilidad entre versiones de iOS y preferencias de usuario.

Integrando enlaces profundos con contenido directo

Directus es un CMS sin cabeza que proporciona una API flexible para gestionar contenido. Al construir una aplicación iOS que utiliza un enlace profundo, puede aprovechar Directus para almacenar las asignaciones entre las rutas URL y los elementos de contenido. Por ejemplo, cada artículo o producto en Directus puede tener un campo o que se convierte en parte de la URL de enlace profundo. Esto mantiene la estructura de enlace consistente y editable sin requerir una actualización de aplicación.

Así funciona una integración típica:

  1. Definir las colecciones de contenidos en Directus (por ejemplo, , ).
  2. Agregar campos] como , ], ] – la la lancha se utiliza a menudo en el camino de la unión profunda.
  3. Construir la URL de enlace profundo dinámicamente en el front-end web o servidor usando la API Directus para buscar la mancha del elemento.
  4. Registre el esquema URL en la aplicación iOS (por ejemplo, ).
  5. Parse el enlace] dentro de la aplicación y llame a la API Directus para recuperar el contenido completo para el slug dado.

Este patrón asegura que cuando un editor de contenidos actualiza un artículo en Directus, el enlace profundo indica automáticamente la última versión – no hay caminos codificados por el duro necesario.

Obtener contenido de Directus para enlaces profundos

Para ilustrar, supongamos que tiene una colección Directus con un campo . Al construir una página web que se une a la aplicación iOS, generaría una etiqueta de anclaje como:

<a href="directusapp://article/how-to-deep-link">Read in App</a>

Dentro de la aplicación iOS, después de recibir la URL, se extraía la rotura y se haría una solicitud de GET para:

https://your-directus-project.example.com/items/articles?filter[slug][_eq]=how-to-deep-link

La respuesta de la API contiene los datos completos de artículo, que luego utiliza para popular la vista. Esto decodifica la aplicación de contenido codificado y hace que el enlace profundo sea realmente dinámico.

Directus también admite campos relacionales, por lo que podría conectarse profundamente en el perfil de un usuario específico o una colección relacionada. Por ejemplo, podría buscar al usuario de la colección y mostrar sus detalles.

Construyendo URLs de Enlace Profundo en Contenido Web

Cuando generas enlaces profundos desde tu interfaz web, normalmente tienes dos opciones: crea las URLs manualmente usando el esquema personalizado de la aplicación, o usa Enlaces Universales. Con Enlaces Universales, la URL es simplemente la URL del sitio web público (por ejemplo, ). El sistema iOS maneja automáticamente la redireccion basada en el archivo . Esto es preferido a menudo porque funciona incluso si el error de página no tiene

Para implementar Enlaces Universales con Directus, usted necesita:

  • Anfitrión del archivo JSON en la raíz de su dominio (por ejemplo, ).
  • Asegúrese de que su API Directus y la ejecución de la web de front-end en el mismo dominio, o configurar el archivo de asociación en el dominio web.
  • En la aplicación iOS, habilitar “Asociated Domains” en la pestaña Capacidades de Xcode y añadir el dominio (por ejemplo, ).
  • Maneja los enlaces universales entrantes en el método de delegado .

Mediante el uso de Enlaces Universales, usted consigue una experiencia sólida y segura de conexión profunda que respeta el contexto del usuario. La flexibilidad de Directus significa que puede gestionar el contenido para estos enlaces centralmente, actualizando los fragmentos, títulos, o incluso redireccionando enlaces antiguos a nuevos contenidos sin tocar la aplicación.

Implementando esquemas de URL personalizados en su aplicación iOS

Para comenzar con esquemas de URL personalizados en un proyecto Xcode, abra la aplicación y agregue una clave llamada . En ese caso, cree un diccionario con un (generalmente el identificador de paquetes de su aplicación) y una matriz de que contenga su esquema personalizado (por ejemplo, ).

A continuación, implemente el método en su (o el equivalente del ciclo de vida SwiftUI). Este método recibe la URL y puede analizar sus componentes. Una implementación típica parece:

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
 let scheme = url.scheme // "directusapp"
 let host = url.host // "article"
 let path = url.path // "/how-to-deep-link"
 let params = url.queryParameters // ["ref": "campaign"]

 // Handle routing based on host and path
 if host == "article" {
 let slug = path.dropFirst() // remove leading "/"
 navigateToArticle(withSlug: String(slug))
 } else if host == "product" {
 // ...
 }
 return true
}

Este fragmento de código supone que tiene una extensión para extraer parámetros de consulta como diccionario. Con la mancha extraída, puede llamar a su cliente de Directus API para buscar el elemento de contenido y empujar el controlador de vista adecuado.

Manejando los Fallbacks con gratitud

Debido a que los esquemas de URL personalizados no ofrecen un retroceso incorporado, debe implementar manualmente un enfoque común es utilizar un redireccionamiento de JavaScript o un cheque de servidor. Por ejemplo, en su sitio web, puede detectar el dispositivo del usuario y tratar de abrir el enlace de esquema personalizado. Si falla (es decir, la aplicación no está instalada), puede redirigir al usuario a la App Store o a una versión web móvil del contenido.

Una técnica es usar el truco con un temporizador:

<script>
 window.location = "directusapp://article/how-to-deep-link";
 setTimeout(function() {
 window.location = "https://apps.apple.com/your-app-id";
 }, 500);
</script>

Esto funciona en muchos dispositivos, pero puede ser poco confiable si la aplicación abre lentamente. Un método más robusto es utilizar el enfoque para iOS o integrar un servicio de conexión profunda de terceros como Enlaces dinámicos de Branch o Firebase. Al utilizar Directus, también puede almacenar la URL de App Store en una colección de sistema y buscarla dinámicamente para el retroceso.

Mejores prácticas para la conexión profunda en aplicaciones con potencia directa

Para crear un sistema de conexión profunda con Directus, siga estas pautas:

  • Mantén las URL legibles por humanos. Usar manchas en lugar de IDs opacas cuando sea posible. Por ejemplo, es más significativo que . Las manchas pueden ser generadas por Directus con ganchos o extensiones.
  • Siempre proporciona un inconveniente. Para los esquemas de URL personalizados, es esencial un retroceso a la versión web o App Store. Para los Enlaces Universales, el inconveniente es automático (Safari).
  • Utilizar análisis. Seguimiento de enlaces profundos se abre en Directus registrando la URL o utilizando una colección dedicada para registrar qué enlaces están siendo seleccionados. Esto ayuda a los equipos de contenido a entender el compromiso.
  • Prueba en dispositivos reales. Las pruebas de simulador no pueden reproducir completamente el comportamiento de Enlace Universal. Prueba en dispositivos físicos que ejecutan diferentes versiones de iOS.
  • Ejecute su esquema. Usar Enlaces Universales sobre esquemas personalizados cuando sea posible para evitar el escaneo de esquemas. Si usted debe utilizar un esquema personalizado, haga que sea único – anexa el dominio inverso de su empresa, por ejemplo, .
  • Casos de borde de husillo. Si la API Directus devuelve un error (por ejemplo, la mancha ya no existe), muestre una pantalla de error amistosa o redirige a una pantalla de inicio dentro de la aplicación.

Al adherirse a estas prácticas, usted asegura que los usuarios que pulsan un vínculo profundo tienen una experiencia suave, ya sea que tengan la aplicación instalada o no.

Pruebas y depuración de enlaces profundos

Debugging profunda links puede ser difícil porque el sistema a menudo caches archivos de asociación o silenciosamente falla. Aquí están algunos consejos:

  • Utilice el registro de consolas. En Xcode, establezca un punto de ruptura en sus métodos de delegado o agregue para ver qué URL se están pasando.
  • ]Simular enlaces de Safari. Puedes probar esquemas de URL personalizados escribiendo directamente en la barra de direcciones de Safari. Para Enlaces Universales, necesitas ser el anfitrión del archivo de asociación y probar desde un dominio real.
  • Valida tu archivo de asociación de Apple-app-site. Apple proporciona una herramienta en la consola de desarrolladores de Apple para comprobar el archivo. También puedes usar validadores en línea como El Validador AASA de Branch].
  • Verifique los registros del servidor. Si utiliza Directus como backend, asegúrese de que su punto final de API para buscar contenido sea accesible y devuelve los datos esperados. Utilice herramientas como Postman para simular solicitudes.
  • Reestablece el caché del dispositivo. iOS envuelve el archivo de asociación de forma agresiva. Puede forzar un refresco reiniciando el dispositivo o revolviendo el modo del avión.

Para una prueba completa, cree una lista de verificación que cubre tanto los escenarios de aplicaciones instalados como desinstalados, diferentes versiones de iOS, y varios formatos de enlace (con y sin parámetros).

Conclusión

Combinar esquemas de URL para iOS para conectarse profundamente con un CMS sin cabeza como Directus crea un sistema potente y flexible para entregar contenido directamente a los usuarios en su aplicación móvil. Si centraliza la gestión de contenidos en Directus, puede actualizar los destinos de enlace profundos, añadir nuevas vías y realizar un seguimiento sin reestructurar nunca la aplicación. Si eliges esquemas de URL personalizados o Enlaces Universales – y de forma ideal ambos – el resultado es un puente sin problemas entre la conversión de aplicaciones de aplicaciones.

Para más lectura, consulte la documentación oficial de Apple sobre la vinculación profunda ], el Documento de la CMS, y este Raywenderlich tutorial sobre Enlaces Universales para ejemplos de implementación paso a paso.