تحسين سلوك النقر على WebView

إذا كان Android تطبيقك يستخدم WebView لعرض محتوى الويب، قد تحتاج إلى التفكير في تحسين سلوك النقر للأسباب التالية:

• WebView لا التصفّح المبوَّب يؤدي النقر على رابط إلى فتح المحتوى في متصفّح الويب التلقائي.

• لا يتوافق WebView مع مخططات عناوين URL المخصصة والذي يمكن عرضه في الإعلانات إذا كانت وجهة النقرات إلى تطبيق منفصل. على سبيل المثال، قد يستخدم عنوان URL للنقرة في Google Play السمة market://.

• تسجيل الدخول باستخدام حساب Google وتسجيل الدخول إلى Facebook لا متوفرة في WebView.

يوفّر هذا الدليل الخطوات المقترَحة لتحسين سلوك النقر في الأجهزة الجوّالة. طرق عرض الويب مع الحفاظ على محتوى عرض الويب.

المتطلبات الأساسية

• أكمِل إعداد عرض الويب. الدليل.

التنفيذ

اتّبِع الخطوات التالية لتحسين سلوك النقر في WebView مثيل:

1. إلغاء shouldOverrideUrlLoading() في WebViewClient. يتم استدعاء هذه الطريقة عندما يكون عنوان URL على وشك التحميل في ملف WebView

2. حدّد ما إذا كنت تريد إلغاء سلوك عنوان URL للنقر.

   يتحقق مقتطف الرمز أدناه مما إذا كان النطاق الحالي مختلفًا عن النطاق المستهدف. هذا مجرد نهج واحد حيث يمكن أن تختلف المعايير التي تستخدمها.

3. حدِّد ما إذا كنت تريد فتح عنوان URL في متصفِّح خارجي، Android Custom (تخصيص Android). أو علامات التبويب، أو ضمن عرض الويب الحالي. يوضح هذا الدليل كيفية فتح عناوين URL مع الانتقال من الموقع من خلال إطلاق علامات تبويب Android المخصصة.

مثال على الرمز البرمجي

أضف أولاً تبعية 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, 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;
          }
        });
  }
}

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

اختبار التنقّل في صفحتك

لاختبار تغييرات التنقل في الصفحة، حمّل

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

إلى عرض الويب الخاص بك. انقر على كل نوع من أنواع الروابط المختلفة للتعرّف على كيفية المستخدم في تطبيقك.

وفي ما يلي بعض النقاط التي يجب التحقق منها:

• يفتح كل رابط عنوان URL المقصود.
• عند الرجوع إلى التطبيق، لا تتم إعادة ضبط عدّاد الصفحة الاختبارية على صفر والتحقق من أنه تم حفظ حالة الصفحة.