Mengoptimalkan perilaku klik WebView

Jika aplikasi Android Anda menggunakan WebView untuk menampilkan konten web, Anda mungkin ingin pertimbangkan untuk mengoptimalkan perilaku klik karena alasan berikut:

  • WebView tidak mendukung skema URL kustom yang dapat ditampilkan dalam iklan jika tujuan kliknya adalah aplikasi terpisah. Misalnya, URL klik-tayang Google Play mungkin menggunakan market://.

Panduan ini memberikan langkah-langkah yang direkomendasikan untuk mengoptimalkan perilaku klik di seluler tampilan web sambil mempertahankan konten tampilan web.

Prasyarat

Penerapan

Ikuti langkah-langkah berikut untuk mengoptimalkan perilaku klik di WebView :

  1. Mengganti shouldOverrideUrlLoading() di WebViewClient. Metode ini dipanggil ketika URL akan dimuat di WebView.

  2. Tentukan apakah akan mengganti perilaku URL klik.

    Cuplikan kode di bawah ini memeriksa apakah domain saat ini berbeda dengan domain domain target. Ini hanyalah salah satu pendekatan karena kriteria yang Anda gunakan dapat bervariasi.

  3. Tentukan apakah akan membuka URL di browser eksternal, Android Custom Tab, atau dalam tampilan web yang ada. Panduan ini menunjukkan cara membuka URL yang keluar dari halaman situs dengan meluncurkan Tab Khusus Android.

Contoh kode

Pertama-tama, tambahkan dependensi androidx.browser ke build.gradle level modul file, biasanya app/build.gradle. Tindakan ini diperlukan untuk Tab Khusus:

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

Cuplikan kode berikut menunjukkan cara menerapkan 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 URI(view.getUrl()).toURL().getHost();
            } catch (URISyntaxException | 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 = URI(view?.url).toURL().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
      }
    }
  }
}

Menguji navigasi halaman

Untuk menguji perubahan navigasi halaman Anda, muat

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

ke dalam tampilan web Anda. Klik setiap jenis penautan yang berbeda untuk melihat caranya berperilaku dalam aplikasi Anda.

Berikut ini beberapa hal yang perlu diperiksa:

  • Setiap link akan membuka URL yang diinginkan.
  • Saat kembali ke aplikasi, penghitung halaman pengujian tidak direset ke nol untuk memvalidasi bahwa status halaman dipertahankan.