WebView في Flutter يعرض صفحة ويب باستخدام محرك النظام، لكنه لا يحول أي موقع إلى تطبيق آمن تلقائيًا. تغيرت واجهة webview_flutter منذ أمثلة WebView(initialUrl) القديمة. يستخدم هذا الدرس WebViewController لتحميل الرابط وإدارة التنقل وWebViewWidget لعرض المحتوى، مع سياسة واضحة للنطاق المسموح.
إعداد المنصة قبل التشغيل
اختُبر الكود مع webview_flutter 4.14.1. راجع متطلبات المنصات في صفحة الحزمة بدل الاعتماد على رقم minSdk قديم. على Android تحقق من إذن INTERNET في manifest المناسب للإنتاج. هذه الحزمة ليست تنفيذ WebView موحدًا لكل منصات Flutter؛ اختبر المنصات التي يدعمها الإصدار.
التحكم في الروابط
يفحص allowedPage البروتوكول والنطاق والمنفذ وغياب بيانات الاعتماد. لا تكفي startsWith لأن عنوانًا مثل geecoders.com.evil.example ليس نطاق الموقع. يرفض المثال الوجهات الخارجية، ويمكن فتح وجهة موثوقة في المتصفح الخارجي عبر مسار منفصل بعد التحقق منها.
JavaScript والجسور الأصلية
يعطل المثال JavaScript افتراضيًا لأن عرض النص لا يحتاج منحه صلاحيات إضافية. إذا كانت صفحة موثوقة تحتاجه، فعله لسبب محدد وراجع أي JavaScriptChannel بعناية. لا تحمل HTML من مستخدم مجهول مع جسر يسمح بقراءة ملفات أو تنفيذ أوامر أصلية.
عرض الخطأ واختبار الرجوع
يعرض المثال خطأ للشاشة الرئيسية عند فشل التحميل بدل ترك صفحة بيضاء. أضف سياسة إعادة محاولة مناسبة ولا تخف أخطاء HTTP. اختبر زر الرجوع وسجل التنقل وتسجيل الدخول والروابط خارج النطاق على جهاز حقيقي؛ اختبارات الدالة هنا تتحقق من سياسة URL ولا تشغّل محرك WebView الأصلي.
الإعداد
flutter pub add webview_flutterمثال تطبيقي
المقطع التالي مستقل في ملف Dart. اختُبر منطق Dart والواجهات المشار إليها، وتبقى إعدادات المنصة والتجربة على جهاز فعلي مطلوبة قبل النشر.
import 'package:flutter/material.dart';
import 'package:webview_flutter/webview_flutter.dart';
bool allowedPage(String value) {
final uri = Uri.tryParse(value);
return uri != null && uri.scheme == 'https' && uri.host == 'geecoders.com' &&
uri.userInfo.isEmpty && uri.port == 443;
}
class ArticleWebPage extends StatefulWidget {
const ArticleWebPage({super.key});
@override
State<ArticleWebPage> createState() => _ArticleWebPageState();
}
class _ArticleWebPageState extends State<ArticleWebPage> {
late final WebViewController controller;
String? error;
@override
void initState() {
super.initState();
controller = WebViewController()
..setJavaScriptMode(JavaScriptMode.disabled)
..setNavigationDelegate(NavigationDelegate(
onNavigationRequest: (request) => allowedPage(request.url)
? NavigationDecision.navigate : NavigationDecision.prevent,
onWebResourceError: (failure) {
if (mounted && failure.isForMainFrame == true) {
setState(() => error = 'تعذر تحميل الصفحة');
}
},
onHttpError: (_) {
if (mounted) setState(() => error = 'استجابة غير متوقعة من الموقع');
},
))
..loadRequest(Uri.parse('https://geecoders.com/flutter_package/'));
}
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(title: const Text('المقال')),
body: error == null ? WebViewWidget(controller: controller)
: Center(child: Text(error!)),
);
}
تطبيق WebView في Flutter في مشروعك
انتقل من WebView القديم إلى Controller وWidget، واقصر التنقل على مصادر موثوقة؛ لا تمنح JavaScript أو الجسور وصولًا أوسع من حاجة الصفحة.
مراجع الموضوع: pub.dev — webview_flutter






