화면과 WebView 개요 | 화면과 WebView | Appbox Android SDK 가이드
Android SDK 연동
화면과 WebView 개요
| 전제 | 내용 |
|---|---|
| 필요 artifact | appbox-webview (+ AppBox 관리 화면은 초기화 설정의 webView) |
| 웹 브릿지 대응 | 고객 WebView에서 gmenu.* 등 대부분의 브릿지 action 동작. 지원 범위는 고객 WebView 연결 참고 |
화면을 다루는 방식은 두 가지입니다: AppBox 관리 화면을 주 화면으로 쓰거나(AppBox.start), 앱이 소유한 WebView에 브릿지를 연결하거나(attachWebView).
usageMode는 화면 동작 조건이 아니라 푸시 클릭 라우팅 설정입니다. SERVICE_APP 상태에서도 관리 화면은 열립니다. 이름 때문에 화면 모드로 오해하기 쉽습니다.
⚠️ 이 장의 함수 대부분은 반환값, 콜백이 없어 실패를 알리지 않습니다. artifact 누락, 초기화 전 호출 모두 조용히 무시되므로 호출 순서가 유일한 안전장치입니다.
연결, 설정 여부는 웹페이지에서 appbox.getDeviceUserId를 호출해 확인할 수 있습니다.
관리 화면 설정 함수의 호출 시점은 다음과 같습니다. 셋 다 초기화 전 호출은 조용히 무시됩니다.
| 함수 | 권장 호출 시점 | start 후 호출 시 |
|---|---|---|
setLoadingData | start 전 | - |
setSystemBarAppearance | start 전, 후 모두 가능 | 표시 중인 화면에 즉시 반영 |
setPullDownRefresh | start 전 | - |