안드로이드 WebView로 웹 페이지 콘텐츠 가져오는 방법 – 단계별 완벽 가이드

안드로이드 앱을 개발하다 보면 WebView에 웹 페이지를 표시하는 것뿐만 아니라, 로드된 페이지의 실제 콘텐츠(HTML 소스)를 가져와야 하는 경우가 있습니다. 이 글에서는 Android Studio에서 WebView를 설정하고 웹 페이지 콘텐츠를 불러오는 전체 과정을 단계별로 살펴보겠습니다.

1단계 — 새 프로젝트 생성

Android Studio를 실행한 뒤 File → New Project 메뉴로 이동합니다. 프로젝트 이름과 패키지명 등 필수 항목을 모두 입력하여 새 프로젝트를 생성합니다.

2단계 — 레이아웃 파일(activity_main.xml) 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가해 화면 전체를 차지하는 WebView를 배치합니다.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <WebView
        android:id="@+id/webView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</RelativeLayout>

3단계 — MainActivity.java 작성

src/MainActivity.java에 다음 코드를 추가합니다. findViewById()로 WebView 객체를 얻은 뒤 loadUrl() 메서드에 원하는 웹 페이지 주소를 지정하면 됩니다.

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.webkit.WebView;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        WebView webView = findViewById(R.id.webView);
        webView.loadUrl("https://www.tutorialspoint.com");
    }
}

4단계 — AndroidManifest.xml 설정

인터넷에 접속하려면 반드시 인터넷 권한을 선언해야 합니다. androidManifest.xml에 아래와 같이 <uses-permission> 태그를 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.com.sample">

    <uses-permission android:name="android.permission.INTERNET"/>

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">

        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>

    </application>
</manifest>

5단계 — 앱 실행 및 결과 확인

실제 안드로이드 기기를 컴퓨터에 연결한 상태에서 Android Studio 툴바의 Run(실행) 버튼을 클릭합니다. 실행 대상으로 연결된 모바일 기기를 선택하면, 앱이 실행되면서 WebView에 지정한 웹 페이지가 화면에 나타납니다.

웹 페이지의 HTML 콘텐츠를 문자열로 가져오기

WebView에 페이지가 표시되는 것만으로는 부족하고, 로드된 페이지의 HTML 소스 자체가 필요하다면 evaluateJavascript()를 활용할 수 있습니다. 페이지 로딩이 끝난 시점(onPageFinished)에 자바스크립트로 DOM 전체를 반환받는 방식입니다.

import android.webkit.ValueCallback;
import android.webkit.WebView;
import android.webkit.WebViewClient;

webView.setWebViewClient(new WebViewClient() {
    @Override
    public void onPageFinished(WebView view, String url) {
        view.evaluateJavascript(
            "(function() { return document.documentElement.outerHTML; })();",
            new ValueCallback<String>() {
                @Override
                public void onReceiveValue(String html) {
                    // 여기서 웹 페이지의 HTML 콘텐츠를 활용할 수 있습니다.
                }
            });
    }
});

이 방법은 API 19(KitKat) 이상에서 동작하며, 결과는 비동기 콜백으로 전달됩니다. 참고로 onReceiveValue()로 받는 값은 JSON 문자열 형태이므로, 필요하다면 따옴표 등을 제거하는 후처리 과정이 추가로 필요할 수 있습니다.

마무리

지금까지 안드로이드에서 WebView를 사용해 웹 페이지를 로드하고, 매니페스트 권한 설정부터 HTML 콘텐츠 추출까지 전 과정을 살펴봤습니다. WebView는 하이브리드 앱이나 간단한 웹 뷰어 형태의 앱을 만들 때 매우 유용한 컴포넌트이므로, 위 예제를 응용해 다양한 기능을 직접 구현해 보시기 바랍니다.