API de gestión de URL
Decida qué enlaces se abren dentro de su aplicación de Android, en las Chrome Custom Tabs o en el navegador externo.
Para mejorar la experiencia del usuario, suele ser beneficioso personalizar la forma en que su aplicación maneja los diferentes tipos de enlaces web. Por ejemplo, los botones de redes sociales se pueden configurar para que se abran en el navegador del sistema o en la aplicación respectiva, en lugar de dentro de su aplicación. WebViewGold proporciona configuraciones flexibles para personalizar el manejo de URL para su aplicación de Android basada en WebView:
Tipos de enlaces:
- Enlaces externos:Enlaces que conducen a undominio diferentedesde el dominio principal de su aplicación.
- Ejemplo:Si el dominio de su aplicación esmidominio.com, un enlace externo seríagoogle.com.
- Enlaces internos:Enlaces que permanecen dentro delmismo dominiocomo tu aplicación.
- Ejemplo:Si el dominio de su aplicación esmidominio.com, un enlace interno seríamidominio.com/compra.
- Enlaces especiales:Enlaces que incluyen atributos especiales, comotarget="_blank"o enlaces que terminan en#.
Opciones de manejo de enlaces:
Puede configurar el comportamiento del enlace modificando la configuración en elConfig.javaarchivo como se muestra a continuación.
Manejo de enlaces externos:
- Opción predeterminada (0):Para abrir enlaces externos en el WebView principal (igual que los enlaces internos), configure
EXTERNAL_LINK_HANDLING_OPTIONSa0. - Opción 1:Para abrir enlaces externos en una nueva pestaña en la aplicación, configure
EXTERNAL_LINK_HANDLING_OPTIONSa1. - Opción 2:Para abrir enlaces externos en el navegador del sistema predeterminado del dispositivo (por ejemplo, Chrome, Safari), configure
EXTERNAL_LINK_HANDLING_OPTIONSa2.
Manejo de enlaces especiales:
- Opción 0:Para abrir enlaces especiales en el WebView principal de la aplicación, configure
SPECIAL_LINK_HANDLING_OPTIONSa0. - Opción 1:Para abrir enlaces especiales en una nueva pestaña en la aplicación, configure
SPECIAL_LINK_HANDLING_OPTIONSa1. - Opción 2:Para abrir enlaces especiales en el navegador del sistema predeterminado del dispositivo (por ejemplo, Chrome, Safari), configure
SPECIAL_LINK_HANDLING_OPTIONSa2.
Nota: Esta configuración con anulaciónEXTERNAL_LINK_HANDLING_OPTIONSpara enlaces que sean tanto externos como especiales.
Personalización del acceso a enlaces: lista blanca y lista negra
Para crear excepciones para sitios o páginas específicas, abraConfig.javay agregue el dominio a una de las siguientes matrices:
- BROWSER_WHITELIST:Enumera dominios específicos para abrir dentro del WebView de la aplicación.
- BROWSER_BLACKLIST:Enumera dominios específicos para abrir en el navegador externo.
Para obtener orientación detallada sobre la configuración de enlaces para su aplicación de Android, mire el video tutorial que se proporciona a continuación:
Manejo de URL: uso del navegador de la aplicación para enlaces específicos
Es posible que algunos enlaces, como una página de Términos y condiciones, no sean lo suficientemente importantes como para abrirlos en un navegador de sistema externo, pero sí demasiado específicos para la vista web principal de su aplicación. WebViewGold proporciona una solución creativa para manejar estos enlaces:una pestaña del navegador en la aplicaciónque se abre sobre el WebView principal, proporcionando una experiencia híbrida de aplicación y navegador. Así es como se verá:
Características clave de la pestaña del navegador en la aplicación:
- La pestaña del navegador de la aplicación incluye unabarra de direccionesybotones de navegación, que ofrece una experiencia más parecida a la de un navegador que el WebView principal.
- Ideal para contenidos que requieren una navegación sencilla, como tutoriales, bases de conocimiento o páginas con información específica.
Cómo utilizar la pestaña del navegador en la aplicación en su aplicación de Android basada en WebView:
Para abrir un enlace en la pestaña del navegador de la aplicación, formatee la URL en su HTML de la siguiente manera:
<a href='#' onClick="top.location.href='https://www.example.com';">Open Example Page</a>
Ejemplo:Para abrir Google, use:
<a href='#' onClick="top.location.href='https://www.google.com';">Open Google</a>
Comportamiento del enlace de prueba:
Para ver cómo su aplicación manejará diferentes tipos de enlaces, use la siguiente URL como URL de WebView durante la prueba:
Enlace de prueba:https://www.webviewgold.com/demo/testlinks.php
Nota:También puedes abrir el mismo dominio en tu navegador de escritorio para ver el código fuente y copiar el formato de tus enlaces.
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.