HTML5 웹 콘텐츠를 별도의 브라우저 없이 실행되는 독립형 안드로이드 앱으로 만들고 싶다면, WebView를 활용하는 것이 가장 간단한 방법입니다. 아래 단계를 따라 하면 기존의 HTML5 코드를 네이티브 앱처럼 패키징할 수 있습니다.
1. 이클립스(Eclipse)로 안드로이드 프로젝트 생성
먼저 Eclipse(또는 Android Studio)에서 새로운 안드로이드 애플리케이션 프로젝트를 생성합니다. 이 프로젝트가 HTML5 콘텐츠를 담을 그릇 역할을 합니다.
2. HTML 코드를 /assets 폴더로 이동
작성한 HTML, CSS, JavaScript 파일을 프로젝트의 /assets 폴더에 복사합니다.
Assets 폴더는 텍스트, XML, 음악, 폰트, 동영상 등 임의의 파일을 애플리케이션에 그대로 포함시킬 수 있는 공간입니다. APK 빌드 시 이 폴더의 파일들이 앱에 함께 패키징되므로, 오프라인 상태에서도 웹 콘텐츠를 실행할 수 있습니다.
3. WebView로 파일 로드하기
레이아웃에 WebView를 배치한 뒤, android_asset/ 경로를 통해 에셋 폴더 내의 파일을 불러올 수 있습니다.
WebView w = new WebView(this);
w.loadUrl("file:///android_asset/index.html");위 코드에서 file:///android_asset/은 앱 내부의 assets 폴더를 가리키는 특수 URI입니다. 원격 사이트를 로드하고 싶다면 일반 URL을 사용하면 됩니다.
WebView w = new WebView(this);
w.loadUrl("https://www.app.com/");4. 자바스크립트 활성화
HTML5 앱은 대부분 JavaScript에 의존하므로, WebView에서 자바스크립트 실행을 반드시 허용해야 합니다.
WebSettings settings = w.getSettings(); settings.setJavaScriptEnabled(true);
추가 팁
- 인터넷 권한: 외부 URL을 로드하는 경우
AndroidManifest.xml에<uses-permission android:name="android.permission.INTERNET"/>을 추가해야 합니다. - 백 버튼 처리: WebView의 히스토리를 활용해 뒤로 가기 동작을 구현하면 사용자 경험이 향상됩니다.
- 파일 엑세스: 로컬 파일 간 상호 작용이 필요하면
setAllowFileAccess(true)설정을 확인하세요.
이 과정을 거치면 HTML5로 작성된 웹 앱이 Google Play에 배포 가능한 독립형 안드로이드 앱으로 완성됩니다.