안드로이드 웹뷰(WebView)에서 HTML 콘텐츠 로드하는 방법

이 예제는 안드로이드 웹뷰(WebView)에서 HTML 콘텐츠를 로드하는 방법을 단계별로 소개합니다.

1단계: 새 프로젝트 생성

Android Studio에서 새 프로젝트를 만듭니다. 상단 메뉴에서 File ⇒ New Project를 선택한 뒤, 프로젝트 생성에 필요한 정보를 모두 입력합니다.

2단계: 레이아웃 파일 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.

<?xml version = "1.0" encoding = "utf-8"?>
<LinearLayout xmlns:android = "https://schemas.android.com/apk/res/android"
   xmlns:app = "https://schemas.android.com/apk/res-auto"
   xmlns:tools = "https://schemas.android.com/tools"
   android:layout_width = "match_parent"
   android:gravity = "center"
   android:layout_height = "match_parent"
   tools:context = ".MainActivity"
   android:orientation = "vertical">
   <WebView
      android:id = "@+id/web_view"
      android:layout_width = "match_parent"
      android:layout_height = "match_parent" />
</LinearLayout>

위 코드에서는 HTML 콘텐츠를 화면에 표시하기 위해 웹뷰(WebView) 위젯을 배치했습니다.

3단계: MainActivity 코드 작성

src/MainActivity.java 파일에 아래 코드를 추가합니다.

package com.example.myapplication;
import android.app.ProgressDialog;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.RequiresApi;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.webkit.WebChromeClient;
import android.webkit.WebSettings;
import android.webkit.WebView;
import android.widget.EditText;
public class MainActivity extends AppCompatActivity {
    @RequiresApi(api = Build.VERSION_CODES.P)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        final ProgressDialog progressDialog = new ProgressDialog(this);
        progressDialog.setMessage("Loading Data...");
        progressDialog.setCancelable(false);
        WebView web_view = findViewById(R.id.web_view);
        web_view.requestFocus();
        web_view.getSettings().setLightTouchEnabled(true);
        web_view.getSettings().setJavaScriptEnabled(true);
        web_view.getSettings().setGeolocationEnabled(true);
        web_view.setSoundEffectsEnabled(true);
        web_view.loadData("<html><body>Hello, world!</body></html>",
        "text/html", "UTF-8");
        web_view.setWebChromeClient(new WebChromeClient() {
            public void onProgressChanged(WebView view, int progress) {
                if (progress < 100) {
                    progressDialog.show();
                }
                if (progress == 100) {
                    progressDialog.dismiss();
                }
            }
        });
    }
}

위 코드의 핵심 부분을 살펴보면 다음과 같습니다.

setJavaScriptEnabled(true): 웹뷰 내부에서 자바스크립트 실행을 허용합니다.
loadData(): URL 없이 문자열 형태의 HTML을 직접 로드하는 메서드입니다. MIME 타입(text/html)과 인코딩 방식(UTF-8)을 함께 지정합니다.
WebChromeClient: onProgressChanged() 콜백으로 로딩 진행률을 전달받아, 진행 중에는 ProgressDialog를 표시하고 완료되면 닫습니다.

애플리케이션 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 실행(Run) 아이콘을 클릭하고, 목록에서 본인의 모바일 기기를 선택하세요. 그러면 기기 화면에 아래와 같이 웹뷰에 로드된 HTML 콘텐츠가 표시됩니다.

안드로이드 웹뷰(WebView)에서 HTML 콘텐츠 로드하는 방법

참고: ProgressDialog는 최신 안드로이드 버전에서 공식적으로 지원 중단(deprecated)되었으므로, 실제 서비스 개발 시에는 ProgressBar 위젯을 사용하는 것이 좋습니다. 또한 외부 웹페이지나 상대 경로 리소스를 함께 다룰 때는 loadDataWithBaseURL() 메서드를 사용하는 편이 더 안전합니다.