API UUID
Identifique las instalaciones de la app con un UUID único añadido a su URL de WebView u obtenido mediante JavaScript.
La API de UUID de WebViewGold le permite obtener un ID de dispositivo único y no personal (UUID, "Universally Unique Identifier"), que puede identificar de forma única un dispositivo iOS. Esta función puede resultar útil para:
- Almacenar configuraciones específicas del usuario en el servidor
- Mantener los estados de sesión
- Recuperar los datos guardados en el lado del cliente
Nota sobre privacidad: Asegúrese de cumplir con las leyes de privacidad locales e internacionales al usar esta función, ya que implica la identificación del dispositivo.
Cómo obtener el UUID:
Para obtener el UUID desde su aplicación basada en WebView, utilice el siguiente código:
<a href="get-uuid://">Get UUID</a>
<a href="#" onClick="alert(uuid);">Show UUID</a>
- Get UUID: Solicita el UUID a WebViewGold.
- Show UUID: Muestra el UUID mediante una alerta para facilitar las pruebas.
Método alternativo: añadir el UUID a la URL del WebView
Si prefiere incluir el UUID en los parámetros de la URL, habilite la opción enhanceUrlUUID en Config.swift estableciéndola en true. Esto añadirá automáticamente uuid=XYZ a la URL de su WebView en la primera solicitud, lo que le permitirá acceder al UUID directamente en su contenido web:
- Ejemplo: Si la URL de su WebView es
https://www.example.org, se solicitará comohttps://www.example.org?uuid=XYZ. - Nota: Solo la solicitud inicial de la URL incluirá este parámetro GET, por lo que conviene guardarlo en una sesión o cookie si necesita consultarlo más adelante en la aplicación.
Inyectar automáticamente el UUID en JavaScript:
Para hacer que el UUID (y otras variables) estén disponibles automáticamente en JavaScript en todas las páginas sin modificar las URL, establezca autoInjectVariable en true en Config.swift. Esto le permite acceder al UUID y a otros valores directamente dentro de cualquier página.
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.