메인 콘텐츠로 건너뛰기

@capgo/capacitor-inappbrowser

Capacitor의 네이티브 인 앱 브라우저는 관리되는 웹 뷰, 네이티브 UI 레이어링, 개인적인 세션, 프록시, 다운로드, 팝업, 앱 메시징과 같은 기능을 제공합니다.

@capgo/capacitor-inappbrowser Capacitor 앱에 두 개의 브라우저 경로를 제공합니다. open() 시스템 브라우저 경험을 위한 openWebView() 관리되는 네이티브 WebView를 위한

__CAPGO_KEEP_0__ 앱은 WebView의 크기, 숨김, 메시지, 스크립트, 프록시, layer를 조정할 수 있습니다. Ionic UI와 함께 사용할 수 있습니다.

__CAPGO_KEEP_1__/__CAPGO_KEEP_2__-inappbrowser에서 @__CAPGO_KEEP_0__/inappbrowser으로 이름이 바뀌었습니다.

일반적인 사용 사례

일반적인 사용 사례
  • 실시간 브라우저 페이지 위에 Ionic 또는 Capacitor UI를 표시하세요. toBack, sendToBack(), bringToFront(), transparentBackground, 및 dispatchInputEvent().
  • 부분 화면 브라우저, 하단 시트, 및 picture-in-picture 웹뷰를 빌드하세요. width, height, x, y, 및 updateDimensions().
  • Capacitor 앱을 사용하여 Android 및 iOS에서 커스텀 사이즈 브라우저 프레임 외부에서 사용자에게 탭을 허용하세요.
  • 영구적인 웹사이트 저장소 없이 체크아웃, 로그인, 지원, 또는 계정-switching 흐름을 실행하세요. persistWebViewData: falseclearAllBrowsingData().
  • 여러 브라우저 인스턴스를 __CAPGO_KEEP_0__로 로드하세요. hidden, hide(), 및 show() 페이지 상태를 보존하면서 __CAPGO_KEEP_0__를 사용하세요.
  • __CAPGO_KEEP_0__에서 요청 프록싱, 파일 업로드, 다운로드, 팝업 제어, Google Pay 지원, _blank 링크 처리 및 앱-페이지 메시징을 위한 고급 웹 앱을 임베드합니다.

기본 기능

기본 기능
  • open 섹션 제목 SFSafariViewController - 안드로이드 또는 iOS에서 Chrome Custom Tabs를 열거나
  • openWebView - 사용자 정의 툴바, 크기, 네이티브 네비게이션, 메시징, 스크립팅, 프록시, 다운로드, 팝업 및 데이터 제어를 지원하는 관리형 네이티브 WebView를 열거나
  • sendToBack / bringToFront - Capacitor 호스트 WebView 뒤에 또는 위에 관리형 브라우저를 옮기거나
  • dispatchInputEvent - 네이티브 앱 UI 뒤에 있는 브라우저로 클릭, 터치 및 스크롤 이벤트를 전달하거나
  • updateDimensions - 페이지를 다시 로드하지 않고 관리형 WebView 크기 및 위치를 변경하거나
  • hide / show - 관리형 WebView를 로드한 채로 네이티브 표시를 제거하거나 복원하거나
  • postMessage / executeScript - Capacitor 앱을 관리형 페이지 내부의 JavaScript와 연결하거나
  • clearAllBrowsingData / persistWebViewData - 쿠키, 캐시, 저장소, IndexedDB 및 세션 지속성을 제어합니다.
  • handleDownloads- 프록시 규칙 및 팝업 이벤트 - 문서 포털, 업로드 흐름, 결제 페이지 및 임베디드 웹 앱을 지원합니다.
메서드설명
goBack웹뷰의 히스토리를 뒤로 가려면.
open새 창에서 전체 화면으로 URL을 열기, 안드로이드에서는 Chrome Custom Tabs를 사용하고, iOS에서는 SFSafariViewController를 사용합니다.
clearCookiesURL의 쿠키를 삭제할 때 id omitted인 경우 모든 열려 있는 웹뷰에 적용됩니다.
clearAllCookies모든 쿠키를 삭제할 때 id omitted인 경우 모든 열려 있는 웹뷰에 적용됩니다.
clearCache캐시 지우기 When id omitted 일 경우, 모든 열려 있는 웹 뷰에 적용됩니다.
clearAllBrowsingData기본 저장소 및 관리되는 WebView에서 쿠키, 캐시, 로컬 스토리지, 세션 스토리지, IndexedDB, 및 다른 브라우징 데이터를 지웁니다.
getCookies특정 URL에 대한 쿠키를 가져옵니다.
close웹 뷰를 닫습니다. When id omitted 일 경우, 활성 웹 뷰를 닫습니다.
hide웹 뷰를 숨깁니다. 닫지 않습니다. show()를 사용하여 다시 나타낼 수 있습니다. When id omitted 일 경우, 활성 웹 뷰를 대상으로합니다.
show이전에 숨겨진 웹 뷰를 표시합니다. When id omitted 일 경우, 활성 웹 뷰를 대상으로합니다.
sendToBackCapacitor 호스트 WebView 뒤의 네이티브 브라우저를 뒤로 밀어 app UI가 위에 나타나도록 합니다.
bringToFront호스트 WebView 뒤의 브라우저를 앞으로 다시 가져옵니다.
dispatchInputEvent클릭, 터치 또는 스크롤 입력을 관리 브라우저로 전송; 좌표는 브라우저 뷰포트에 상대적입니다.
openWebView도구栏과 향상된 기능, chẳng hạn như 카메라 접근, 파일 접근, 이벤트 듣기, 자바스크립트 주입, 양방향 통신 등이 있는 새로운 웹뷰에서 URL을 열습니다.
executeScriptInAppBrowser 창에 자바스크립트 code를 주입합니다. omitted일 때는 모든 열린 웹뷰에서 실행됩니다. id 웹뷰 (인앱 브라우저)로 이벤트를 보냅니다. 페이지에서 listen하는 경우 . The payload는 JSON-serializable해야합니다. omitted일 때는 모든 열린 웹뷰로 방송됩니다.
postMessage현재 웹뷰 뷰포트를 PNG 스크린샷으로 캡처합니다. omitted일 때는 활성 웹뷰를 대상으로합니다. window.addEventListener('messageFromNative', listenerFunc)웹뷰의 URL을 설정합니다. omitted일 때는 활성 웹뷰를 대상으로합니다. detail __CAPGO_KEEP_0__ id __CAPGO_KEEP_0__
takeScreenshot__CAPGO_KEEP_0__ id __CAPGO_KEEP_0__
setUrl__CAPGO_KEEP_0__ id __CAPGO_KEEP_0__
addListenerURL 변경을 감지하기 위해, WebView가 열려 있는 경우에만.
addListenerURL 변경을 감지하기 위해; buttonNearDoneClickURL 변경을 감지하기 위해; WebView의 데이터가 포함되어 있습니다. id.
addListenerWebView가 열려 있는 경우에만, 닫기 클릭을 감지하기 위해.
addListener사용자가 약관이 필요한 경우에, 확인 버튼을 클릭했을 때 발생합니다. openWebView의 shareDisclaimer와 closeModal을 사용합니다.
addListener웹뷰가 앱으로 이벤트를 보낼 때 발생합니다. window.mobileApp.postMessage(...) 페이지에서 사용할 수 있으며, 데이터가 JSON-serializable해야 합니다.
addListenerAPI에서 캡처한 스크린샷, 네이티브 스크린샷 버튼, 또는 주입된 JavaScript 브리지에서 캡처한 스크린샷이 발생할 때마다.
addListener페이지가 로드될 때 발생합니다.
addListener페이지 로드 오류가 발생할 때 발생합니다.
addListener네이티브 다운로드 처리가 로컬 파일을 저장한 후에 발생합니다. 이 기능을 사용하려면 handleDownloads: true WebView를 열 때
addListener자연 다운로드 처리가 실패할 때 트리거됩니다. 이 옵션을 활성화하려면 handleDownloads: true 웹뷰를 열 때
addListener페이지가 팝업/새 창을 열 때마다 트리거됩니다. 반환된 팝업 ID를 사용하여 executeScript, postMessage, show, hide, close.
addListener자연 런타임에 의해 위임된 프록시 요청을 듣습니다. 대신 addProxyHandler() 직접 호출하는 것보다
addListener관리 페이지에서 내보내는 JavaScript 콘솔 출력을 듣습니다. 웹뷰를 열 때 captureConsoleLogs: true 활성화하려면
handleProxyRequest으로 사용됩니다. addProxyHandler() 수동 phase 리스너에게 proxyRequest 원본
removeAllListeners__CAPGO_KEEP_0__
reload__CAPGO_KEEP_1__
updateDimensions__CAPGO_KEEP_2__ id __CAPGO_KEEP_3__
setEnabledSafeTopMargin__CAPGO_KEEP_4__ id __CAPGO_KEEP_5__
setEnabledSafeBottomMargin__CAPGO_KEEP_6__ id __CAPGO_KEEP_7__
openSecureWindow__CAPGO_KEEP_8__ BroadcastChannel__CAPGO_KEEP_9__

__CAPGO_KEEP_10__

__CAPGO_KEEP_11__

__CAPGO_KEEP_0__을 사용하여 내부 브라우저 또는 WebView를 열 때 툴바 옵션과 함께 사용하세요.

사용자는
activity단순한 툴바에 닫기 및 공유 제어를 찾을 것입니다.
compact닫기 제어만 있는 단순한 툴바.
navigation뒤로 및 앞으로 제어를 가진 풀 네비게이션 툴바.
blank툴바가 없습니다.

이 참조는 __CAPGO_KEEP_1__에서 동기화됩니다. src/definitions.ts __CAPGO_KEEP_0__-inappbrowser capacitor에서 계속하기.

Keep going from @capgo/capacitor-inappbrowser

Section titled “Keep going from @capgo/capacitor-inappbrowser”

__CAPGO_KEEP_0__을 사용하고 계신가요? capgo/capacitor-inappbrowser __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-inappbrowser을 사용하여 capgo/capacitor-inappbrowser을 사용하여 capgo/capacitor-inappbrowser을 사용하여 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 Capacitor Plugins by Capgo Capacitor 플러그인에 대한 구현 세부 정보는 Capgo에서 확인할 수 있습니다. 플러그인 추가 또는 업데이트 __CAPGO_KEEP_0__ 플러그인에 대한 구현 세부 정보는 플러그인 추가 또는 업데이트, 및 Capacitor Enterprise 플러그인 대체 Capacitor Enterprise 플러그인에 대한 제품 워크플로우입니다.