رفتار کلیکی WebView را بهینه کنید

اگر برنامه شما WebView برای نمایش محتوای وب استفاده می‌کند، ممکن است بخواهید به دلایل زیر بهینه‌سازی رفتار کلیک را در نظر بگیرید:

  • WebView از مرور تب‌ها پشتیبانی نمی‌کند. کلیک روی یک لینک، محتوا را در مرورگر وب پیش‌فرض باز می‌کند.
  • WebView از طرح‌های URL سفارشی پشتیبانی نمی‌کند، طرح‌هایی که اگر مقصد کلیک به یک برنامه جداگانه باشد، می‌توانند در تبلیغات بازگردانده شوند. برای مثال، یک URL کلیک از طریق گوگل پلی ممکن است market:// استفاده کند.

این راهنما مراحل توصیه‌شده‌ای را برای بهینه‌سازی رفتار کلیک در نماهای وب موبایل و در عین حال حفظ محتوای نمای وب ارائه می‌دهد.

پیش‌نیازها

پیاده‌سازی

برای بهینه‌سازی رفتار کلیک در نمونه WebView خود، این مراحل را دنبال کنید:

  1. تابع shouldOverrideUrlLoading() ‎ را در WebViewClient نادیده بگیرید. این متد زمانی فراخوانی می‌شود که یک URL در حال بارگذاری در WebView فعلی است.

  2. تعیین کنید که آیا رفتار URL کلیک را لغو کنید یا خیر.

    این کد بررسی می‌کند که آیا دامنه فعلی با دامنه هدف متفاوت است یا خیر. این فقط یک رویکرد است زیرا معیارهایی که استفاده می‌کنید می‌توانند متفاوت باشند.

  3. تصمیم بگیرید که آیا می‌خواهید URL را در یک مرورگر خارجی، تب‌های سفارشی اندروید یا در نمای وب موجود باز کنید. این راهنما نحوه باز کردن URLها را در حالی که از سایت خارج می‌شوید با راه‌اندازی تب‌های سفارشی اندروید نشان می‌دهد.

مثال کد

ابتدا وابستگی androidx.browser را به فایل build.gradle در سطح ماژول خود، که معمولاً app/build.gradle است، اضافه کنید. این برای تب‌های سفارشی مورد نیاز است:

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

قطعه کد زیر نحوه پیاده‌سازی shouldOverrideUrlLoading() را نشان می‌دهد:

جاوا

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 and no scheme, return early.
            if (request.getUrl().getHost() == null && request.getUrl().getScheme() == 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;
          }
        });
  }
}

کاتلین

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 and no scheme, return early.
        if (request?.url?.host == null && request.url.scheme == null) {
          return false
        }
        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
        }

        val targetDomain = request.url.host

        // 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
      }
    }
  }
}

پیمایش صفحه خود را آزمایش کنید

برای آزمایش تغییرات ناوبری صفحه، موارد زیر را بارگذاری کنید:

https://google.github.io/webview-ads/test/#click-behavior-tests

به نمای وب خود. روی هر یک از انواع مختلف پیوند کلیک کنید تا ببینید چگونه در برنامه شما رفتار می‌کنند.

در اینجا مواردی برای بررسی وجود دارد:

  • هر لینک، آدرس اینترنتی (URL) مورد نظر را باز می‌کند.
  • هنگام بازگشت به برنامه، شمارنده صفحه آزمایشی برای تأیید حفظ وضعیت صفحه، به صفر بازنشانی نمی‌شود.