@capgo/capacitor-navegador-de-aplicación

Resumen

@capgo/capacitor-inappbrowser da a las aplicaciones Capacitor dos rutas de navegador: open() para la experiencia del navegador del sistema y openWebView() para un navegador nativo gestionado que su aplicación puede dimensionar, ocultar, enviar mensajes, ejecutar scripts, configurar proxy y superponer con la interfaz de usuario de Ionic.

Utilízalo cuando la página necesite más que un navegador externo simple: flujos de OAuth y pago, portales de soporte incorporados, pantallas de pago, llamadas de video, portales de documentos, aplicaciones web interactivas o cualquier flujo donde tu aplicación necesite controles nativos alrededor de contenido web en vivo.

El nombre del paquete ha cambiado.

Uso común

• Presenta la interfaz de usuario de Ionic o Capacitor por encima de una página de navegador en vivo con toBack, sendToBack(), bringToFront(), transparentBackground, y dispatchInputEvent().
• Crea navegadores de pantalla parcial, hojas inferiores y vistas de imagen en imagen con width, height, x, y, y updateDimensions().
• Permite a los usuarios tocar la aplicación Capacitor fuera de un marco de navegador personalizado de tamaño en Android e iOS.
• Ejecuta flujos de pago, inicio de sesión, soporte o cambio de cuenta sin almacenamiento persistente de sitios web utilizando persistWebViewData: false y clearAllBrowsingData().
• mantenga varias instancias de navegador cargadas con hidden, hide(), y show() mientras se preserva el estado de la página.
• Integrar aplicaciones web avanzadas que necesitan proxy de solicitudes, subida de archivos, descarga de archivos, control de pestañas emergentes, soporte de Google Pay, manejo de enlaces y mensajería de aplicación a página. _blank Capacidades básicas

Sección titulada “Capacidades básicas”

• open - Abre una vista web nativa gestionada con barra de herramientas personalizada, tamaño, navegación nativa, mensajería, scripting, proxy, descargas, pestañas emergentes y controles de datos. SFSafariViewController - Mueve un navegador gestionado detrás o encima de la __CAPGO_KEEP_0__ vista web nativa.
• openWebView - Reenvía eventos de clic, toque y desplazamiento a un navegador que se encuentra detrás de la interfaz de usuario nativa de la aplicación.
• sendToBack / bringToFront - Moves a managed browser behind or above the Capacitor host WebView.
• dispatchInputEvent Core Capabilities
• updateDimensions - Cambia el tamaño y posición de la WebView administrada sin recargar la página.
• hide / show - Mantiene cargadas las WebViews administradas mientras se eliminan o restauran su presentación nativa.
• postMessage / executeScript - Conecta la aplicación Capacitor con JavaScript que se ejecuta dentro de la página administrada.
• clearAllBrowsingData / persistWebViewData - Controla la persistencia de cookies, caché, almacenamiento, IndexedDB y sesión.
• handleDownloads- Controla proxy, reglas, eventos de popup, y documentos de puertas de soporte, flujos de carga, páginas de pago y aplicaciones web incorporadas.

- Público API

- Método	- Descripción
goBack	- Navega hacia atrás en la historia de la WebView si es posible.
open	- Abre la URL en una ventana nueva en pantalla completa, en Android utiliza Chrome Custom Tabs, en iOS utiliza SFSafariViewController.
clearCookies	- Elimina los cookies de la URL cuando id se omite, se aplica a todas las pestañas abiertas.
clearAllCookies	Borrar todas las cookies Cuando id se omite, se aplica a todas las pestañas abiertas.
clearCache	Borrar caché Cuando id se omite, se aplica a todas las pestañas abiertas.
clearAllBrowsingData	Borra cookies, caché, almacenamiento local, almacenamiento de sesión, IndexedDB y otros datos de navegación del almacén predeterminado y de las pestañas administradas.
getCookies	Obtener cookies para una URL específica.
close	Cierra la pestaña de navegación. Cuando id se omite, cierra la pestaña de navegación activa.
hide	Oculta la pestaña de navegación sin cerrarla. Utiliza show() para traerla de nuevo. Cuando id se omite, se aplica a la pestaña de navegación activa.
show	Muestra una pestaña de navegación previamente oculta. Cuando id se omite, se dirige a la vista activa del navegador web.
sendToBack	Mueve el navegador nativo detrás de la Capacitor WebView del host para que la interfaz de usuario de la aplicación pueda aparecer encima de ella.
bringToFront	Mueve un navegador que estaba detrás de la WebView del host nuevamente a la parte delantera.
dispatchInputEvent	Envía la entrada de clic, toque o desplazamiento a un navegador gestionado; las coordenadas son relativas a la vista del navegador.
openWebView	Abre una URL en una nueva vista del navegador con barras de herramientas y capacidades mejoradas, como acceso a la cámara, acceso a archivos, escucha de eventos, inyección de JavaScript, comunicación bidireccional, etc.
executeScript	Inyecta JavaScript code en la ventana del navegador InAppBrowser. Cuando id se omite, se ejecuta en todas las vistas del navegador web abiertas.
postMessage	Envía un evento a la vista del navegador (navegador en aplicación). Escucha en la página con window.addEventListener('messageFromNative', listenerFunc)El detail El payload debe ser serializable en JSON. Cuando id se omite, se emite a todas las vistas del navegador abiertas.
takeScreenshot	Captura la vista del navegador actual como una captura de pantalla PNG. Cuando id se omite, se dirige a la vista activa.
setUrl	Establece la URL de la vista. id se omite, se dirige a la vista activa.
addListener	Escucha el cambio de URL, solo para openWebView.
addListener	Escucha el evento buttonNearDoneClick; el payload contiene la vista id.
addListener	Escucha solo el clic de cierre para openWebView.
addListener	Se disparará cuando el usuario haga clic en el botón de confirmación cuando se requiera un aviso, funciona con openWebView shareDisclaimer y closeModal.
addListener	Se disparará cuando la vista envíe un evento de vuelta a la aplicación. Utilice window.mobileApp.postMessage(...) en la página, y mantenga el payload serializable en JSON.
addListener	Se disparará cada vez que se capture una captura de pantalla desde el plugin API, el botón de captura de pantalla nativo o el puente de JavaScript inyectado.
addListener	Se disparará cuando se cargue la página.
addListener	Se disparará cuando se produzca un error de carga de página.
addListener	Se disparará después de que el manejo de descargas nativas guarde un archivo localmente. Habilita esto con handleDownloads: true cuando se abre la vista web.
addListener	Se disparará cuando el manejo de descargas nativas falla. Habilita esto con handleDownloads: true cuando se abre la vista web.
addListener	Se disparará cada vez que una página abra una ventana emergente/nueva ventana. Utiliza el id de ventana emergente devuelto con executeScript, postMessage, show, hide, y close.
addListener	Escucha las solicitudes delegadas por el runtime nativo. Prefiere addProxyHandler() en lugar de llamar directamente a este método.
addListener	Escucha la salida del consola de JavaScript emitida por la página gestionada. Habilita esto con captureConsoleLogs: true cuando se abre la vista web.
handleProxyRequest	Método interno utilizado por addProxyHandler() enviar una decisión de proxy hacia nativo. Envía el original phase cuando se responde a un manual proxyRequest escuchador.
removeAllListeners	Eliminar todos los escuchadores para este plugin.
reload	Recargar la página web actual.
updateDimensions	Actualizar las dimensiones de la vista web. Permite cambiar el tamaño y la posición de la vista web en tiempo de ejecución. Cuando id establece el margen superior seguro habilitado de la vista web en tiempo de ejecución. Cuando
setEnabledSafeTopMargin	establece el margen inferior seguro habilitado de la vista web en tiempo de ejecución. Cuando id abre una ventana de OAuth2 segura. En web, devuelve la URL redirigida a través de un
setEnabledSafeBottomMargin	__CAPGO_KEEP_0__ id __CAPGO_KEEP_0__
openSecureWindow	__CAPGO_KEEP_0__ BroadcastChannel; en dispositivos móviles, registre una URI de redirección personalizada en la configuración de su aplicación. Consulte la guía de inicio rápido para obtener los ejemplos completos de HTML, Info.plist y AndroidManifest.

Valores de Referencia

Use estos valores con opciones de herramienta al abrir un navegador en la aplicación o una vista de navegador.

Tipos de Herramienta

Valor	El usuario encontrará
activity	Herramienta simple con controles de cierre y compartir.
compact	Herramienta simple con un control de cierre.
navigation	Herramienta de navegación completa con controles de atrás y adelante.
blank	Sin herramienta.

Fuente de Verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-navegador-de-aplicación.

Sigue adelante desde @capgo/capacitor-navegador-de-aplicación

Si estás utilizando @capgo/capacitor-navegador-de-aplicación para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-navegador-de-aplicación para la capacidad nativa en Usando @capgo/capacitor-navegador-de-aplicación, Directorio de Plugins Capgo para el flujo de trabajo del producto en Directorio de Plugins Capgo Plugins de Capgo en Capacitor para el detalle de implementación en Plugins de Capgo en Capacitor Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise.