Android WebViewのデフォルトテキストエンコードを設定する方法

概要

この記事では、AndroidのWebViewにおいて、Webページを正しく表示するためのデフォルトのテキストエンコード（文字コード）を設定する方法を解説します。

WebViewはsetDefaultTextEncodingName()メソッドを使うことで、ページのデコードに使用する文字エンコーディングを指定できます。日本語などマルチバイト文字を含むサイトを表示する際に文字化けを防ぐために重要な設定です。

ステップ1：プロジェクトの作成

Android Studioで新しいプロジェクトを作成します。メニューから「File」⇒「New Project」を選択し、必要な項目をすべて入力してプロジェクトを作成してください。

ステップ2：レイアウトファイル（activity_main.xml）の編集

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>

上記のコードでは、facebook.com を表示するためのWebViewを配置しています。

ステップ3：MainActivity.java の編集

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.webkit.WebChromeClient;
import android.webkit.WebSettings;
import android.webkit.WebView;
import android.webkit.WebViewClient;

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().setDefaultTextEncodingName("utf-8");
      web_view.getSettings().setJavaScriptEnabled(true);
      web_view.loadUrl("https://touch.facebook.com/");
      web_view.setWebViewClient(new WebViewClient() {
         @Override
         public boolean shouldOverrideUrlLoading(WebView view, String url) {
            view.loadUrl(url);
            return true;
         }
      });
      web_view.setWebChromeClient(new WebChromeClient() {
         public void onProgressChanged(WebView view, int progress) {
            if (progress < 100) {
               progressDialog.show();
            }
            if (progress == 100) {
               progressDialog.dismiss();
            }
         }
      });
   }
}

ここで最も重要なのは次の1行です。

web_view.getSettings().setDefaultTextEncodingName("utf-8");

このメソッドは、WebViewがWebページのHTMLをデコードする際に使用するデフォルトの文字エンコーディングを指定します。UTF-8を明示的に設定することで、多言語対応のページでも文字化けを防げます。あわせてsetJavaScriptEnabled(true)でJavaScriptを有効化し、読み込み中の進捗状況をProgressDialogで表示しています。

補足： ProgressDialogはAPIレベル26（Android 8.0）以降で非推奨となっているため、最新のプロジェクトではProgressBarウィジェットやDialogFragmentの利用が推奨されます。

ステップ4：AndroidManifest.xml への権限追加

AndroidManifest.xml に以下のコードを追加します。インターネット通信を行うため、INTERNET権限の宣言が必要です。

<?xml version = "1.0" encoding = "utf-8"?>
<manifest xmlns:android = "https://schemas.android.com/apk/res/android"
    package = "com.example.myapplication">
    <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>

アプリの実行

それでは、アプリケーションを実行してみましょう。実際のAndroid端末をパソコンに接続しているものとします。Android Studioからアプリを実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーの実行アイコンをクリックします。表示された選択肢から接続したモバイルデバイスを選ぶと、端末に以下のような画面が表示されます。