웹뷰(WebView) 환경 지원 정책
개요
eXBuilder6 런타임은 표준 웹 브라우저(데스크톱·모바일)에서 동작을 검증합니다. 모바일 앱 안에 들어간 웹뷰(WebView)에서도 같은 웹 표준 API로 동작하지만, 웹뷰는 앱이 기능을 켜고 끄는 환경이라 표준 브라우저와 동작이 다를 수 있습니다. 이 문서는 웹뷰 환경에서 지원하는 범위와, 웹뷰를 쓰는 화면을 만들기 전에 확인할 사항을 안내합니다.
적용 대상
| 구분 | 예 |
|---|---|
| 표준 브라우저 (검증 기준) | Chrome, Edge, Safari, Firefox, Samsung Internet 등 |
| 웹뷰 (이 문서의 대상) | Android WebView, iOS WKWebView, 하이브리드 앱 프레임워크나 인앱 브라우저 안에서 화면을 여는 경우 |
지원 범위
- 런타임이 제공하는 API와 컨트롤은 웹뷰에서도 표준 브라우저와 같은 방식으로 동작하도록 만들어져 있습니다.
- 런타임은 웹뷰를 따로 구분하지 않으며, 웹뷰 전용 처리도 하지 않습니다.
- 다만 웹뷰는 제조사, OS 버전, 앱의 웹뷰 설정에 따라 브라우저 기능이 제한될 수 있습니다. 이 때문에 생기는 기능 제한이나 동작 차이는 런타임의 보장 범위에 포함되지 않습니다.
웹뷰에서 달라질 수 있는 기능
아래 기능은 앱이 웹뷰에서 해당 기능을 허용하거나 직접 구현해야 동작합니다. 앱 설정에 따라 표준 브라우저와 결과가 다를 수 있습니다.
| 기능 | 웹뷰에서 확인할 점 |
|---|---|
| 파일 다운로드 | 앱이 다운로드 요청을 처리해야 파일이 저장됩니다. |
| 파일 업로드 (파일 선택) | 앱이 파일 선택 창을 연결해야 선택 창이 열립니다. |
새 창·팝업 (window.open, 링크 새 창) |
다중 창 허용 여부에 따라 열리지 않거나 같은 화면에서 열릴 수 있습니다. |
브라우저 대화상자 (alert, confirm, prompt) |
앱이 대화상자를 처리하지 않으면 표시되지 않을 수 있습니다. |
| 로컬 저장소·쿠키 | DOM Storage, 쿠키 허용 설정에 따라 값이 유지되지 않을 수 있습니다. |
| 클립보드, 카메라, 위치 정보 등 권한 기능 | 앱 권한과 웹뷰 권한을 모두 허용해야 합니다. |
| 인쇄 | 웹뷰는 인쇄 기능을 기본으로 제공하지 않는 경우가 많습니다. |
| 화면 크기·가상 키보드 | 키보드가 올라올 때 화면 크기 변경 방식이 앱 설정에 따라 다릅니다. |
웹뷰 환경 도입 전 확인 사항
웹뷰에서 화면을 제공하려면 기획 단계에서 아래를 먼저 검토해 주십시오.
- 대상 앱과 웹뷰 종류(Android WebView, iOS WKWebView 등), 지원할 OS 버전을 정합니다.
- 화면에서 쓰는 기능 중 위 표에 해당하는 것이 있는지 확인합니다.
- 해당 기능을 앱에서 허용·구현할 수 있는지 앱 개발 담당자와 확인합니다.
- 실제 대상 기기와 앱에서 주요 화면을 미리 점검합니다.
문의 시 전달할 정보
웹뷰 환경에서 문제가 생기면 아래 정보를 함께 보내 주십시오. 같은 증상이 표준 브라우저에서도 나는지에 따라 원인 확인 방법이 달라집니다.
- 기기 모델, OS 버전
- 앱 종류와 웹뷰 종류, 웹뷰 버전
- 같은 화면을 표준 브라우저(Chrome, Safari)에서 열었을 때의 결과
- 관련 웹뷰 설정 (파일 접근, 다중 창, DOM Storage 등)
면책 사항
본 런타임은 표준 브라우저 환경을 기준으로 동작을 검증합니다. 웹뷰(WebView) 환경에서는 제조사와 앱의 설정 차이로 일부 기능이 제한되거나 정상적으로 동작하지 않을 수 있으며, 표준 브라우저에서 재현되지 않고 웹뷰 설정으로 인해 발생하는 문제는 본 런타임의 보장 범위에 포함되지 않습니다.
댓글 없음