고객 WebView 연결 | 화면과 WebView | Appbox Android SDK 가이드
고객 WebView 연결
고객 WebView 연결
AppBox.attachWebView(webView)
Kotlin
1
val webView: WebView = findViewById(R.id.webView)
2
webView.settings.javaScriptEnabled = true
3
webView.webViewClient = MyWebViewClient() // client는 연결 전에 설정합니다
4
5
AppBox.attachWebView(webView)
6
webView.loadUrl("<SERVICE_URL>")
1
WebView webView = findViewById(R.id.webView);
2
webView.getSettings().setJavaScriptEnabled(true);
3
webView.setWebViewClient(new MyWebViewClient()); // client는 연결 전에 설정합니다
4
5
AppBox.attachWebView(webView);
6
webView.loadUrl("<SERVICE_URL>");
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| webView | 필수 | Activity의 context로 생성한 android.webkit.WebView. applicationContext로 만든 WebView는 연결되지 않습니다 | - |
- 로드할 웹페이지에는 웹 SDK 스크립트 선언이 필요합니다. 웹 가이드의 초기 설정
- 반환값, 콜백이 없으며 오류 전달이 없습니다. 연결 여부는 웹에서
appbox.getDeviceUserId를 호출해 확인합니다.
브릿지 지원 범위와 제약 요약
상세 동작은 아래 동작 설명에 있습니다.
| 항목 | 동작 |
|---|---|
| bridge action | inapp.requestShow 하나만 차단(-8000). 네이티브에서는 showInAppCampaign 사용 |
gmenu.* 7개 | 동작함. 단 그 WebView의 하단 모서리에 고정 표시 (관리 화면과 다름) |
| 스레드 | SDK가 관리: 웹으로 보내는 응답은 항상 main thread |
WebChromeClient | 감싸지 않음. 파일 선택, JS dialog, 새 창은 앱 책임 (SDK fallback 없음) |
webViewClient | 연결 전에 설정, 이후 교체 금지: 교체 시 페이지 로드 추적, 이벤트 전달 중단 |
| 동시 연결 | hosted WebView 1개만 공식 지원, 연결 해제 함수 없음 |
동작 설명
- 오류가 전달되지 않는 실패에는 artifact 누락, context 문제, 내부 오류가 모두 포함됩니다.
inapp.requestShow는 고객 WebView에 캠페인 컨텍스트가 없어SERVICE_UNAVAILABLE(-8000)로 거절됩니다.gmenu.*는 SDK가 해당 WebView 영역에 오버레이를 만들어 붙입니다. WebView가 화면에서 떨어지면 메뉴도 함께 사라지고, 스크롤 연동 자동 숨김은 관리 화면 전용이라 고객 WebView에서는 고정 표시됩니다. 오버레이를 만들 수 없는 호스트에서는FEATURE_UNAVAILABLE(-5000)로 실패합니다.- bridge 요청은 WebView의 백그라운드 스레드로 들어오지만 SDK가 처리 스레드를 관리하므로 앱이 신경 쓸 일이 없습니다.
WebChromeClient미래핑의 영향: 웹 페이지에서<input type="file">(onShowFileChooser)이나window.open을 쓴다면 앱이 직접WebChromeClient를 설정해야 합니다.- 기존
WebViewClient는 SDK가 delegate로 보존한 wrapper로 감쌉니다. 연결 후 교체하면 bridge 호출 자체는 계속 동작하지만 SDK의 페이지 로드 추적이 끊겨, native에서 웹으로 보내는 이벤트 전달(AppsFlyer 딥링크 결과 등)과 브라우저 메뉴의 back/forward 활성 상태 갱신이 멈춥니다.