WKWebView에 AppBox bridge handler와 JavaScript shim을 연결합니다.
자체 WebView 연동 | Appbox iOS SDK 가이드
자체 WebView 연동
WebView 연결
WebView 연결
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
webView | 필수 | AppBox bridge를 사용할 앱 소유 WKWebView | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 없음 | 반환값과 callback이 모두 없습니다 |
연결만으로 bridge handler와 shim이 주입됩니다.
- 동일한 WebView에 반복 연결하지 않습니다.
- 첫 bridge message 전에 native에서 JavaScript를 보내야 하면
setActiveWebView(_:)도 호출합니다. - 화면 폐기 시 동일한 WebView를
detachWebView(_:)에 전달합니다.
WebView 연결 해제
WebView 연결 해제
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
webView | 필수 | 연결을 해제할 WKWebView | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 없음 | 반환값과 callback이 모두 없습니다 |
attachWebView(_:)에 전달했던 같은 인스턴스를 사용합니다. Navigation 관찰도 연결했다면 detachNavigationObservation(_:)도 호출합니다. 활성 대상으로 지정했다면 먼저 clearActiveWebView(_:)로 해제합니다.
모든 WebView 연결 해제
모든 WebView 연결 해제
Request 항목 정의
Response 항목 정의
| Response 결과값 | |
|---|---|
| 없음 | 반환값과 callback이 모두 없습니다 |
여러 WebView를 한꺼번에 폐기하거나 사용자 세션을 전환할 때 사용합니다. 계속 사용할 WebView까지 모두 해제되므로 개별 화면 종료에는 detachWebView(_:)를 권장합니다.
활성 WebView 지정
활성 WebView 지정
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
webView | 필수 | 활성 대상으로 지정할 연결된 WKWebView | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 없음 | 반환값과 callback이 모두 없습니다 |
먼저 attachWebView(_:)로 연결합니다. bridge message가 들어오면 해당 WebView가 활성 대상으로 자동 갱신됩니다. 첫 message 전에 silent Push나 AppsFlyer 결과를 웹에 전달해야 할 때 명시적으로 지정합니다.
활성 WebView 해제
활성 WebView 해제
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
webView | 필수 | 활성 상태를 해제할 WKWebView | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 없음 | 반환값과 callback이 모두 없습니다 |
다른 WebView가 활성 대상이면 그 상태를 변경하지 않습니다. 화면 폐기 전에 호출한 뒤 WebView 연결도 해제합니다.
활성 WebView 진단
활성 WebView 진단
Request 항목 정의
Response 항목 정의
| Response 결과값 | |
|---|---|
| 없음 | 반환값과 callback이 모두 없습니다 |
개발 중 bridge 연결 상태를 확인하는 진단용 함수입니다. 운영 기능의 성공, 실패 분기에 사용하지 않습니다. 활성 WebView가 없으면 웹에 전달되지 않습니다.