자체 WebView 연동

WebView 연결

앱이 소유한 WKWebView에 AppBox bridge handler와 JavaScript shim을 연결합니다.

WebView 연결

AppBox.attachWebView(_ webView: WKWebView)

Swift
1 import WebKit
2
3 let webView = WKWebView()
4 AppBox.attachWebView(webView)
1 @import WebKit;
2
3 WKWebView *webView = [[WKWebView alloc] init];
4 [AppBox attachWebView:webView];

Request 항목 정의

Request 항목필수여부설명기본값
webView필수AppBox bridge를 사용할 앱 소유 WKWebView-

Response 항목 정의

Response 결과값
없음반환값과 callback이 모두 없습니다


연결만으로 bridge handler와 shim이 주입됩니다.

  • 동일한 WebView에 반복 연결하지 않습니다.
  • 첫 bridge message 전에 native에서 JavaScript를 보내야 하면 setActiveWebView(_:)도 호출합니다.
  • 화면 폐기 시 동일한 WebView를 detachWebView(_:)에 전달합니다.

WebView 연결 해제

지정한 앱 WebView에서 AppBox bridge 연결을 제거합니다.

WebView 연결 해제

AppBox.detachWebView(_ webView: WKWebView)

Swift
1 AppBox.detachWebView(webView)
1 [AppBox detachWebView:webView];

Request 항목 정의

Request 항목필수여부설명기본값
webView필수연결을 해제할 WKWebView-

Response 항목 정의

Response 결과값
없음반환값과 callback이 모두 없습니다


attachWebView(_:)에 전달했던 같은 인스턴스를 사용합니다. Navigation 관찰도 연결했다면 detachNavigationObservation(_:)도 호출합니다. 활성 대상으로 지정했다면 먼저 clearActiveWebView(_:)로 해제합니다.

모든 WebView 연결 해제

SDK에 연결된 모든 앱 WebView의 bridge 연결을 제거합니다.

모든 WebView 연결 해제

AppBox.detachAllWebViews()

Swift
1 AppBox.detachAllWebViews()
1 [AppBox detachAllWebViews];

Request 항목 정의

인자가 없습니다.

Response 항목 정의

Response 결과값
없음반환값과 callback이 모두 없습니다


여러 WebView를 한꺼번에 폐기하거나 사용자 세션을 전환할 때 사용합니다. 계속 사용할 WebView까지 모두 해제되므로 개별 화면 종료에는 detachWebView(_:)를 권장합니다.

활성 WebView 지정

native에서 JavaScript 이벤트를 보낼 앱 WebView를 활성 대상으로 지정합니다.

활성 WebView 지정

AppBox.setActiveWebView(_ webView: WKWebView)

Swift
1 AppBox.attachWebView(webView)
2 AppBox.setActiveWebView(webView)
1 [AppBox attachWebView:webView];
2 [AppBox setActiveWebView:webView];

Request 항목 정의

Request 항목필수여부설명기본값
webView필수활성 대상으로 지정할 연결된 WKWebView-

Response 항목 정의

Response 결과값
없음반환값과 callback이 모두 없습니다


먼저 attachWebView(_:)로 연결합니다. bridge message가 들어오면 해당 WebView가 활성 대상으로 자동 갱신됩니다. 첫 message 전에 silent Push나 AppsFlyer 결과를 웹에 전달해야 할 때 명시적으로 지정합니다.

활성 WebView 해제

지정한 WebView가 현재 활성 대상일 때만 활성 상태를 해제합니다.

활성 WebView 해제

AppBox.clearActiveWebView(_ webView: WKWebView)

Swift
1 AppBox.clearActiveWebView(webView)
1 [AppBox clearActiveWebView:webView];

Request 항목 정의

Request 항목필수여부설명기본값
webView필수활성 상태를 해제할 WKWebView-

Response 항목 정의

Response 결과값
없음반환값과 callback이 모두 없습니다


다른 WebView가 활성 대상이면 그 상태를 변경하지 않습니다. 화면 폐기 전에 호출한 뒤 WebView 연결도 해제합니다.

활성 WebView 진단

현재 활성 앱 WebView에 연결이 살아 있는지 확인하는 신호를 보냅니다.

활성 WebView 진단

AppBox.sendDebugPingToActiveWebView()

Swift
1 #if DEBUG
2 AppBox.sendDebugPingToActiveWebView()
3 #endif
1 #if DEBUG
2 [AppBox sendDebugPingToActiveWebView];
3 #endif

Request 항목 정의

인자가 없습니다.

Response 항목 정의

Response 결과값
없음반환값과 callback이 모두 없습니다


개발 중 bridge 연결 상태를 확인하는 진단용 함수입니다. 운영 기능의 성공, 실패 분기에 사용하지 않습니다. 활성 WebView가 없으면 웹에 전달되지 않습니다.

www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.