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