إذا كان Android تطبيقك يستخدمWebView
لعرض محتوى الويب، ننصحك بتحسين سلوك النقر للأسباب التالية:
WebView
لا يتوافق مع التصفح المبوَّب. ويؤدي النقر على أحد الروابط إلى فتح المحتوى في متصفح الويب التلقائي.
- لا يتوافق
WebView
مع مخطّطات عناوين URL المخصّصة التي يمكن عرضها في الإعلانات إذا كانت وجهة النقرة تؤدي إلى تطبيق منفصل. على سبيل المثال، قد يستخدم عنوان URL للنقرة في Google Play الحالةmarket://
.
- تسجيل الدخول بحساب Google
وتسجيل الدخول إلى Facebook
غير
متاحَين في
WebView
.
يوفّر هذا الدليل خطوات مقترَحة لتحسين سلوك النقر في طرق عرض الويب على الأجهزة الجوّالة مع الحفاظ على محتوى ملف عرض الويب.
المتطلبات الأساسية
- أكمل دليل إعداد عرض الويب.
التنفيذ
اتّبِع الخطوات التالية لتحسين سلوك النقر في
WebView
المثيل:
ألغِ
shouldOverrideUrlLoading()
فيWebViewClient
. يتم استدعاء هذه الطريقة عندما يكون عنوان URL على وشك التحميل فيWebView
الحالية.حدِّد ما إذا كنت تريد إلغاء سلوك عنوان URL للنقر.
يتحقّق مقتطف الرمز أدناه ممّا إذا كان النطاق الحالي مختلفًا عن النطاق الهدف. هذا نهج واحد فقط، حيث قد تختلف المعايير التي تستخدمها.
حدِّد ما إذا كنت تريد فتح عنوان URL في متصفح خارجي أو في علامات تبويب Android المخصّصة أو في عرض الويب الحالي. يوضح هذا الدليل كيفية فتح عناوين URL بعيدًا عن الموقع الإلكتروني من خلال تشغيل Android Custom Tabs.
مثال التعليمة البرمجية
أضِف أولاً التبعية 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 المقصود.
- عند الرجوع إلى التطبيق، لا تتم إعادة ضبط عدّاد صفحة الاختبار إلى الصفر للتحقق من الحفاظ على حالة الصفحة.