WebView のクリック動作を最適化する

Android アプリでWebView を使用してウェブ コンテンツを表示する場合は、次の理由からクリック動作の最適化を検討することをおすすめします。

  • WebView タブ ブラウジングは サポートしていません。リンクをクリックすると、デフォルトのウェブブラウザでコンテンツが開きます。
  • WebView ではカスタム URL スキームがサポートされていません。カスタム URL スキームは、クリック デスティネーションが別のアプリである場合に広告で返すことができます。たとえば、Google Play のリンク先 URL で market:// を使用することがあります。

このガイドでは、ウェブビューのコンテンツを保持しながら、モバイルウェブビューのクリック動作を最適化するための推奨手順について説明します。

前提条件

実装

WebView インスタンスでクリック動作を最適化する手順は次のとおりです。

  1. WebViewClientshouldOverrideUrlLoading() をオーバーライドします。このメソッドは、URL が現在の WebView に読み込まれるときに呼び出されます。

  2. クリック URL の動作をオーバーライドするかどうかを決定します。

    以下のコード スニペットでは、現在のドメインが移行先ドメインと異なるかどうかを確認します。使用する基準は異なる場合があるため、これは 1 つのアプローチにすぎません。

  3. URL を外部ブラウザ、Android カスタムタブで開くか、既存のウェブビュー内で開くかを決定します。このガイドでは、Android カスタムタブを起動して、そのサイトから移動する URL を開く方法について説明します。

サンプルコード

まず、androidx.browser 依存関係をモジュール レベルの build.gradle ファイル(通常は app/build.gradle)に追加します。これは、カスタムタブに必要です。

dependencies {
  implementation 'androidx.browser:browser:1.5.0'
}

次のコード スニペットは、shouldOverrideUrlLoading() の実装方法を示しています。

Java

public class MainActivity extends AppCompatActivity {

  private WebView webView;

  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // ... Register the WebView.

    webView = new WebView(this);
    WebSettings webSettings = webView.getSettings();
    webSettings.setJavaScriptEnabled(true);
    webView.setWebViewClient(
        new WebViewClient() {
          // 1. Implement the web view click handler.
          @Override
          public boolean shouldOverrideUrlLoading(
              WebView view,
              WebResourceRequest request) {
            // 2. Determine whether to override the behavior of the URL.
            // If the target URL has no host, return early.
            if (request.getUrl().getHost() == null) {
              return false;
            }

            // Handle custom URL schemes such as market:// by attempting to
            // launch the corresponding application in a new intent.
            if (!request.getUrl().getScheme().equals("http")
                && !request.getUrl().getScheme().equals("https")) {
              Intent intent = new Intent(Intent.ACTION_VIEW, request.getUrl());
              // If the URL cannot be opened, return early.
              try {
                MainActivity.this.startActivity(intent);
              } catch (ActivityNotFoundException exception) {
                Log.d("TAG", "Failed to load URL with scheme:" + request.getUrl().getScheme());
              }
              return true;
            }

            String currentDomain;
            // If the current URL's host cannot be found, return early.
            try {
              currentDomain = new URL(view.getUrl()).getHost();
            } catch (MalformedURLException exception) {
              // Malformed URL.
              return false;
            }
            String targetDomain = request.getUrl().getHost();

            // If the current domain equals the target domain, the
            // assumption is the user is not navigating away from
            // the site. Reload the URL within the existing web view.
            if (currentDomain.equals(targetDomain)) {
              return false;
            }

            // 3. User is navigating away from the site, open the URL in
            // Custom Tabs to preserve the state of the web view.
            CustomTabsIntent intent = new CustomTabsIntent.Builder().build();
            intent.launchUrl(MainActivity.this, request.getUrl());
            return true;
          }
        });
  }
}

Kotlin

class MainActivity : AppCompatActivity() {

  private lateinit var webView: WebView

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // ... Register the WebView.

    webView.webViewClient = object : WebViewClient() {
      // 1. Implement the web view click handler.
      override fun shouldOverrideUrlLoading(
          view: WebView?,
          request: WebResourceRequest?
      ): Boolean {
        // 2. Determine whether to override the behavior of the URL.
        // If the target URL has no host, return early.
        request?.url?.host?.let { targetDomain ->
          val currentDomain = URL(view?.url).host

          // Handle custom URL schemes such as market:// by attempting to
          // launch the corresponding application in a new intent.
          if (!request.url.scheme.equals("http") &&
              !request.url.scheme.equals("https")) {
            val intent = Intent(Intent.ACTION_VIEW, request.url)
            // If the URL cannot be opened, return early.
            try {
              this@MainActivity.startActivity(intent)
            } catch (exception: ActivityNotFoundException) {
              Log.d("TAG", "Failed to load URL with scheme: ${request.url.scheme}")
            }
            return true
          }

          // If the current domain equals the target domain, the
          // assumption is the user is not navigating away from
          // the site. Reload the URL within the existing web view.
          if (currentDomain.equals(targetDomain)) {
            return false
          }

          // 3. User is navigating away from the site, open the URL in
          // Custom Tabs to preserve the state of the web view.
          val customTabsIntent = CustomTabsIntent.Builder().build()
          customTabsIntent.launchUrl(this@MainActivity, request.url)
          return true
        }
        return false
      }
    }
  }
}

ページ ナビゲーションをテストする

ページ ナビゲーションの変更をテストするには、

https://webview-api-for-ads-test.glitch.me#click-behavior-tests

ウェブビューに統合されます各リンクタイプをクリックして、アプリでの動作を確認します。

その際は、次の点をよくご確認ください。

  • 各リンクをクリックすると、目的の URL が開きます。
  • アプリに戻ったときに、ページの状態が保持されたことを確認するために、テストページのカウンタがゼロにリセットされることはありません。