API de Universal Links
Abra los enlaces a su dominio directamente en su app iOS con Apple Universal Links: configuración, archivo AASA y resolución de problemas.
La API de Universal Links simplifica la vinculación a contenido dentro de su aplicación, proporcionando una experiencia de usuario más fluida y nativa. WebViewGold le permite configurar su dominio para que los enlaces de aplicaciones como Mail, Safari y otras se abran automáticamente dentro de su aplicación basada en WebViewGold, sin necesidad de indicaciones adicionales.
Nota: la aplicación debe estar instalada primero en el dispositivo del usuario para que esta función funcione.
Alternativamente, es posible utilizar nuestra API de Deep Linking. Aunque funciona de manera similar, utiliza una sintaxis diferente. No obstante, cabe señalar que la sintaxis de la API de Universal Links es más común que la sintaxis de la API de Deep Linking. Para la mayoría de las aplicaciones, es aconsejable elegir una u otra, pero no ambas.
Para configurar los Universal Links en su aplicación iOS, siga los pasos que se indican a continuación:
- Configuración en el Apple Developer Center:
- Inicie sesión en su cuenta en el Apple Developer Center.
- Haga clic en 'Certificates, Identifiers & Profiles'.
- En 'Identifiers', seleccione 'App IDs' y luego elija el ID de su aplicación en la lista.
- En la sección 'App Services', marque la opción 'Associated Domains' y guarde los cambios.
- Configuración en Xcode:
- Abra el proyecto de su aplicación en Xcode.
- Seleccione el target (en la mayoría de los casos "WebViewGold"). En la pestaña 'Signing & Capabilities', vaya a la sección 'Associated Domains'. Haga clic en '+' para añadir un dominio. Su dominio debe llevar el prefijo 'applinks:', de esta manera:
applinks:example.org&applinks:www.example.org:
- En Config.swift, establezca ShowExternalLink en true.
- Tenga en cuenta los subdominios. Existe una distinción entre los dominios "www.*" y los que no son "www" (considere añadir ambos). Asegúrese de tener el perfil de aprovisionamiento correcto con la capacidad 'Associated Domains'. Si no, Xcode debería pedirle que lo corrija.
- Configuración del servidor:
- En el servidor de su sitio web, debe alojar un archivo Apple App Site Association (AASA) en el nivel raíz de su servidor o utilizando el prefijo
/.well-known/. Por ejemplo,https://example.org/.well-known/apple-app-site-association - El archivo AASA debe contener detalles sobre la aplicación y los dominios asociados. Consulte la documentación oficial para conocer la estructura exacta. Asegúrese de que el archivo apple-app-site-association esté alojado en un servidor que admita HTTPS, no solo HTTP.
¡Listo! :-) Las pruebas en el Simulador no son tan efectivas como en un dispositivo real. Para obtener los mejores resultados, utilice un iPhone o iPad real.
Notas de implementación estilo SDK
Trate esta función como una capacidad nativa expuesta a su capa web: mantenga su sitio web de producción o PWA como fuente de verdad y, a continuación, utilice los indicadores de configuración de WebViewGold, los comandos de URL y las llamadas del puente de JavaScript documentados para activar el comportamiento nativo de iOS solo donde aporte valor. Este enfoque mantiene su código fácil de mantener, porque la misma aplicación web puede servir a los navegadores, a WebViewGold para iOS y a las demás plataformas de WebViewGold con una lógica condicional mínima.
Para obtener resultados fiables, opte por puntos de conexión HTTPS, nombres de ruta estables, estados de éxito/error explícitos en su interfaz y pequeñas funciones auxiliares de JavaScript que envuelvan las llamadas nativas. Por ejemplo, una aplicación web creada con jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, una pila propia de React/Vue/Angular o HTML estático puede exponer un único botón o controlador de eventos que active la API nativa de WebViewGold y, aun así, muestre una alternativa elegante en el navegador.
- Patrón de integración recomendado: detecte el contexto de la app, llame a la API de WebViewGold y luego actualice su interfaz web tras la devolución de llamada nativa o el cambio de ruta.
- Lista de comprobación de pruebas: valide la función en un dispositivo real o en una compilación empaquetada, verifique los permisos y el texto de revisión de la tienda, y confirme que los usuarios que solo usan el navegador siguen recibiendo una alternativa útil.
- Ventaja para el SEO: mantenga las páginas de funciones, los títulos de ruta y el contenido estructurado indexables en su sitio web, mientras WebViewGold ofrece la carcasa nativa de la app para los usuarios de iOS.