Read/Write Value API
Persist small strings on the device from JavaScript and read them back — for theme, language, session tokens, or onboarding state.
La API de lectura/escritura de valores almacena de forma persistente una cadena arbitraria en el dispositivo (a través del almacenamiento privado de la app) y la vuelve a leer en su JavaScript. Los valores sobreviven a los reinicios de la app y a la eliminación de la caché, salvo que el sistema operativo borre los datos de la aplicación.
Escritura de un valor:
Todo lo que aparece después de writevalue:// se almacena literalmente como una única cadena. Diseñe su propio formato (cadena de consulta, JSON, CSV, lo que mejor se adapte a su aplicación web):
<a href="writevalue://darkmode=on;user=42">Save</a>
Lectura de un valor:
Cuando se activa readvalue://, la app inyecta la cadena almacenada de vuelta en el WebView para que su JavaScript pueda leerla:
<a href="readvalue://" onclick="setTimeout(showSettings, 200)">Load</a>
<script>
function showSettings() {
console.log(window.appSettings || "no settings yet");
}
</script>
Casos de uso típicos:
- Recordar el tema, el idioma o el estado de incorporación de un usuario sin conexión.
- Almacenar en caché un token de sesión cuando no puede confiar en las cookies.
- Persistir una pequeña preferencia local sin necesidad de un viaje de ida y vuelta al backend.
Notas: Los valores son específicos de cada instalación de la app y de cada dispositivo: no se sincronizan entre dispositivos. Mantenga los valores pequeños; esta API está pensada para configuraciones, no para almacenamiento de blobs.
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 Android 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 Android 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 Android.