@capgo/capacitor-inappbrowser Capacitor 앱에 두 개의 브라우저 경로를 제공합니다. open() 시스템 브라우저 경험과 openWebView() 관리되는 네이티브 WebView를 위해 앱이 크기, 숨기기, 메시지, 스크립트, 프록시, layering을 할 수 있습니다. Ionic UI.
페이지가 단순한 외부 브라우저만 필요하지 않은 경우 사용하세요: OAuth 및 체크아웃 흐름, 임베디드 지원 포털, 결제 화면, 비디오 호출, 문서 포털, 상호 작용 웹 앱, 또는 앱이 라이브 웹 콘텐츠 주변에 네이티브 컨트롤이 필요할 때.
패키지 이름이 변경되었습니다.Common Use Cases
Section titled “Common Use Cases”- Ionic 또는 Capacitor UI를 라이브 브라우저 페이지 위에 표시하세요:
toBack,sendToBack(),bringToFront(),transparentBackground와dispatchInputEvent(). - 부분 화면 브라우저, 하단 시트, 그리고 picture-in-picture 웹뷰를 빌드하세요.
width,height,x,y밖에서 __CAPGO_KEEP_0__ 앱을 Android 및 iOS의 커스텀 사이즈 브라우저 프레임 외부에서 탭할 수 있습니다.updateDimensions(). - Let users tap the Capacitor app outside a custom-size browser frame on Android and iOS.
- 밖에서 __CAPGO_KEEP_0__ 앱을 Android 및 iOS의 커스텀 사이즈 브라우저 프레임 외부에서 탭할 수 있습니다.
persistWebViewData: false체크아웃, 로그인, 지원, 또는 계정-switching 흐름을 사용하여 영구적인 웹사이트 저장소 없이 실행합니다.clearAllBrowsingData(). - 밖에서 __CAPGO_KEEP_0__ 앱을 Android 및 iOS의 커스텀 사이즈 브라우저 프레임 외부에서 탭할 수 있습니다.
hidden,hide()다중 브라우저 인스턴스를 로드하여 페이지 상태를 보존하는 동안show()다중 브라우저 인스턴스를 로드하여 페이지 상태를 보존하는 동안 - 다중 브라우저 인스턴스를 로드하여 페이지 상태를 보존하는 동안
_blank고급 웹 앱을 임베드하여 요청 프록시, 파일 업로드, 다운로드, 팝업 제어, Google Pay 지원, 링크 처리, 및 앱-페이지 메시징을 사용합니다.
Core Capabilities
Core Capabilitiesopen- Android 또는 iOS에서 Chrome Custom Tabs를 열어줍니다.SFSafariViewControlleriOS에서 동작합니다.openWebView- 사용자 정의 툴바, 크기 조절, 네이티브 네비게이션, 메시징, 스크립팅, 프록시, 다운로드, 팝업, 데이터 제어와 같은 기능을 가진 관리형 네이티브 웹뷰를 열 수 있습니다.sendToBack/bringToFront- Capacitor 호스트 웹뷰 뒤에 또는 위에 관리형 브라우저를 이동할 수 있습니다.dispatchInputEvent- 네이티브 앱 UI 뒤에 있는 브라우저로 클릭, 터치, 스크롤 이벤트를 전달할 수 있습니다.updateDimensions- 페이지를 다시 로드하지 않고 웹뷰 크기와 위치를 변경할 수 있습니다.hide/show- 관리형 웹뷰를 로드하고 유지하면서 그들의 네이티브 표시를 제거하거나 복원할 수 있습니다.postMessage/executeScript- Capacitor 앱을 관리형 페이지 내부에서 실행 중인 자바스크립트와 연결할 수 있습니다.clearAllBrowsingData/persistWebViewData- 쿠키, 캐시, 스토리지, IndexedDB, 세션 지속성과 같은 기능을 제어할 수 있습니다.handleDownloads- 프록시 규칙, 팝업 이벤트와 같은 기능을 지원하며 문서 포털, 업로드 흐름, 결제 페이지, 임베디드 웹 앱과 같은 기능을 지원합니다.
API 공개
API 공개 섹션| 메소드 | __CAPGO_KEEP_0__ |
|---|---|
goBack | __CAPGO_KEEP_0__ |
open | __CAPGO_KEEP_0__ |
clearCookies | __CAPGO_KEEP_0__ id __CAPGO_KEEP_0__ |
clearAllCookies | __CAPGO_KEEP_0__ id __CAPGO_KEEP_0__ |
clearCache | __CAPGO_KEEP_0__ id __CAPGO_KEEP_0__ |
clearAllBrowsingData | __CAPGO_KEEP_0__ |
getCookies | __CAPGO_KEEP_0__ |
close | __CAPGO_KEEP_0__ id 은 생략되며, 활성 웹뷰를 닫습니다. |
hide | 활성 웹뷰를 닫지 않고 웹뷰를 숨깁니다. 다시 나타내려면 show()를 사용하세요. When id 은 생략되며, 활성 웹뷰를 대상으로합니다. |
show | 이전 웹뷰를 다시 나타냅니다. When id 은 생략되며, 활성 웹뷰를 대상으로합니다. |
sendToBack | Capacitor 호스트 WebView 뒤의 네이티브 브라우저를 뒤로 옵니다. 앱 UI가 위에 나타나도록. |
bringToFront | __CAPGO_KEEP_0__ 호스트 WebView 뒤의 브라우저를 다시 앞으로 옵니다. |
dispatchInputEvent | 관리 브라우저로 클릭, 터치, 또는 스크롤 입력을 전달합니다. 브라우저 뷰포트 기준 좌표입니다. |
openWebView | __CAPGO_KEEP_0__에서 URL을 새 웹뷰에서 열고, 툴바, 카메라 접근, 파일 접근, 이벤트 듣기, 자바스크립트 주입, 양방향 통신 등 강화된 기능을 사용합니다. |
executeScript | InAppBrowser 창에 자바스크립트 code를 주입합니다. When id 은 생략되며, 열린 모든 웹뷰에서 실행합니다. |
postMessage | 웹뷰(인앱 브라우저)로 이벤트를 전송합니다. 페이지에서 이벤트를 듣기 위해 window.addEventListener('messageFromNative', listenerFunc). The detail __CAPGO_KEEP_0__ payload must be JSON-serializable. When __CAPGO_KEEP_1__ is omitted, broadcasts to all open webviews. id __CAPGO_KEEP_2__ captures the current webview viewport as a PNG screenshot. When __CAPGO_KEEP_3__ is omitted, targets the active webview. |
takeScreenshot | __CAPGO_KEEP_4__ sets the URL of the webview. When __CAPGO_KEEP_5__ is omitted, targets the active webview. id __CAPGO_KEEP_6__ listen for URL change, only for open webview. |
setUrl | __CAPGO_KEEP_7__ listen for __CAPGO_KEEP_8__; the payload contains the webview __CAPGO_KEEP_9__ id __CAPGO_KEEP_10__ listen for close click only for open webview. |
addListener | __CAPGO_KEEP_11__ will be triggered when user clicks on confirm button when disclaimer is required, works with open webview shareDisclaimer and closeModal. |
addListener | targetLanguage buttonNearDoneClickKorean id. |
addListener | protectedTokens |
addListener | Cloudflare, Capacitor, GitHub, Capgo, code, API, SDK, CLI, npm, bun |
addListener | 웹뷰가 앱으로 이벤트를 다시 보내면 발생합니다. window.mobileApp.postMessage(...) 페이지에서 |
addListener | Will be triggered whenever a screenshot is captured from the plugin API, the native screenshot button, or the injected JavaScript bridge. |
addListener | 플러그인 __CAPGO_KEEP_0__에서 스크린샷을 캡처하거나, 네이티브 스크린샷 버튼, 또는 주입된 자바스크립트 브리지에서 스크린샷을 캡처할 때마다 발생합니다. |
addListener | 페이지가 로드될 때 발생합니다. |
addListener | 페이지 로드 오류 시 발생합니다. handleDownloads: true 네이티브 다운로드 처리가 로컬로 파일을 저장할 때 발생합니다. |
addListener | 웹뷰를 열 때 handleDownloads: true 네이티브 다운로드 처리가 실패할 때 발생합니다. |
addListener | 웹뷰를 열 때 executeScript, postMessage, show, hide페이지가 팝업/새 창을 열 때 발생합니다. close. |
addListener | 리턴된 팝업 id를 사용하여 addProxyHandler() __CAPGO_KEEP_0__ |
addListener | JavaScript 콘솔 출력이 관리 페이지에서 발생할 때 이를 감지하세요. captureConsoleLogs: true __CAPGO_KEEP_1__ |
handleProxyRequest | 웹뷰를 열 때. addProxyHandler() __CAPGO_KEEP_2__ phase __CAPGO_KEEP_3__ proxyRequest __CAPGO_KEEP_4__ |
removeAllListeners | __CAPGO_KEEP_5__ |
reload | 이 플러그인의 모든 리스너를 제거합니다. |
updateDimensions | 현재 웹 페이지를 다시 로드합니다. id 웹뷰의 크기와 위치를 런타임에 변경할 수 있습니다. __CAPGO_KEEP_6__가 생략되면 현재 활성 웹뷰를 대상으로합니다. |
setEnabledSafeTopMargin | 웹뷰의 enabled safe top margin을 런타임에 설정합니다. __CAPGO_KEEP_6__이 생략되면 현재 활성 웹뷰를 대상으로합니다. id is 생략, 활성 웹뷰를 대상으로합니다. 웹에서 이 메서드는 레이아웃을 변경하지 않고 무효화됩니다. |
setEnabledSafeBottomMargin | 사용자 경험을 위한 안전한 하단 여백을 활성화합니다. 이 메서드는 런타임에 웹뷰의 enabled safe bottom margin을 설정합니다. id is 생략, 활성 웹뷰를 대상으로합니다. 웹에서 이 메서드는 레이아웃을 변경하지 않고 무효화됩니다. |
openSecureWindow | 보안 인증 2.0 창을 열고, 웹에서 리다이렉트 URL을 반환합니다. 모바일에서 사용자 앱 구성에서 커스텀 리다이렉트 URI를 등록합니다. 자세한 내용은 시작 가이드를 참조하세요. BroadcastChannel원본 |
원본
이 참조는에서 src/definitions.ts __CAPGO_KEEP_0__-inappbrowser capacitor에서 __CAPGO_KEEP_1__-inappbrowser로 계속 진행하세요..
capgo에서 capacitor-inappbrowser로 계속 진행하세요.
capgo에서 capacitor-inappbrowser로 계속 진행하세요.만약 __CAPGO_KEEP_0__을 사용하고 있다면 @capgo/capacitor-inappbrowser __CAPGO_KEEP_0__을 native plugin 작업에 계획하고 있다면, __CAPGO_KEEP_0__을 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-inappbrowser와 연결하세요. @capgo/capacitor-inappbrowser를 사용하여 capgo native 기능을 사용하세요. @capgo/capacitor-inappbrowser를 사용하여 capgo native 기능을 사용하세요. Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리를 사용하여 Capgo 제품 워크플로우를 사용하세요. Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capacitor 플러그인들에 대한 구현 세부 사항을 Capgo에 사용하세요. __CAPGO_KEEP_0__ 플러그인 추가 또는 업데이트 __CAPGO_KEEP_0__ 플러그인 추가 또는 업데이트에 대한 구현 세부 사항을 __CAPGO_KEEP_0__ 플러그인 추가 또는 업데이트에 사용하세요. Ionic Enterprise 플러그인 대체품 Capgo 제품 워크플로우에 대한 Ionic Enterprise Plugin 대체 항목입니다.