고객 WebView 연결 | 화면과 WebView | Appbox Android SDK 가이드

고객 WebView 연결

앱이 소유한 WebView에 AppBox bridge를 연결합니다. 자체 화면 구조를 유지하면서 웹페이지에서 브릿지 기능을 쓰게 하고 싶을 때 사용합니다.

고객 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 actioninapp.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 활성 상태 갱신이 멈춥니다.
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.