كيفية تهيئة توجيه WKWebView لدعم روابط Universal Links على نظام iOS

opoinstall
2026-10-07
5 min read

كيف يمكنني تفعيل روابط Universal Links داخل WKWebView على نظام iOS؟ يمكن لروابط Universal Links العمل بالفعل من خلال الروابط المؤهلة داخل WKWebView. يتيح تنفيذ WKNavigationDelegate للتطبيق المضيف تخصيص سياسات التوجيه - مثل اعتراض الوجهات المملوكة للتطبيق، والتحكم في عمليات التسليم الخارجية عبر decidePolicyForNavigationAction، وفرض الأمان على مستوى الإطار (Frame-level security).

في هندسة تطبيقات iOS، يسمح اعتراض التنقل في WKWebView للتطبيق المضيف بتخصيص سياسات التوجيه عبر روابط Universal Links، ومخططات URL المخصصة، ووجهات الويب. من خلال تقييم بيانات تعريف طلب التنقل داخل WKNavigationDelegate، يمكن للتطبيق توجيه الوجهات الخاصة به داخلياً، وتفويض الأهداف الخارجية إلى معالجات النظام، وفرض سياسات أمان على مستوى الإطار.

المصطلح التعريف الكيان ذو الصلة دور نية البحث
WebView مكون عرض مضمن يعتمد على WebKit يعرض محتوى الويب التفاعلي داخل تطبيقات iOS. iOS SDK معلوماتي / تجاري
Universal Links آلية HTTPS قياسية تربط نطاقات الويب الموثقة بعروض التطبيقات الأصلية على iOS. توجيه الروابط العميقة تقني / معلوماتي
Custom URL Scheme مخطط URI محدد بواسطة التطبيق يُستخدم لتوجيه الروابط إلى تطبيق أصلي. الروابط العميقة للهاتف المحمول معلوماتي

كيفية تفاعل WKWebView مع توجيه Universal Links على iOS

يقرر WKNavigationDelegate ما إذا كان WebKit سيقوم بالتحميل، أو التوجيه داخلياً، أو التسليم، أو الإلغاء.

دورات حياة تنقل WebKit وسياسات التوجيه الخاصة بالتطبيقات

تطبق Apple روابط Universal Links كآلية توجيه على مستوى النظام مدعومة عبر Safari وبيئات WKWebView. عندما ينقر المستخدم على رابط مؤهل داخل WKWebView مضمن، يمكن للمنصة حل ارتباطات النطاق وتوجيه التنفيذ وفقاً لسياسات نظام التشغيل.

بينما يمكن لروابط Universal Links المعترف بها من قبل النظام تسليم التنفيذ إلى المعالجات الأصلية، تتطلب بيئات المتصفح المضمنة غالباً منطق توجيه خاص بالتطبيق. على سبيل المثال، عندما يستهدف رابط ما نطاق التطبيق المضيف، يفضل المطورون غالباً التنقل مباشرة عبر وحدات التحكم في العرض الأصلية (Native View Controllers) دون تشغيل عمليات إعادة تشغيل كاملة للتطبيق الخارجي. يوفر تنفيذ WKNavigationDelegate للتطبيق المضيف تحكماً دقيقاً في تقييم الروابط، مما يسمح للفرق بفرض قوائم سماح مخصصة وتوجيه الوجهات الداخلية بشكل يمكن التنبؤ به.

عائق تجربة المستخدم: عندما تحبس متصفحات الويب داخل التطبيق المستخدمين في حلقات إعادة توجيه الويب

يتم نشر WebViews المضمنة بشكل متكرر لاستضافة صفحات ترويجية، ومراكز مساعدة، وكتالوجات شركاء، وصفحات هبوط تسويقية داخل تطبيقات iOS. عندما تتضمن صفحة ويب داخل التطبيق روابط تهدف إلى نقل المستخدمين إلى أقسام أخرى من التطبيق المضيف (على سبيل المثال، أزرار "عرض في التطبيق") أو إلى تطبيقات الشركاء، فقد يؤدي التنقل الافتراضي إلى عرض زائد عن الحاجة:

  • عرض الويب الزائد: بدلاً من عرض وحدات التحكم في العرض الأصلية، قد يتم تقديم إصدارات ويب متجاوبة من صفحات التطبيق للمستخدم، مما يتطلب عمليات مصادقة متكررة ويقلل من الاتساق البصري.
  • حصار الويب: قد يصبح المستخدمون محاصرين داخل أكوام تنقل ويب عميقة دون طرق بديهية للعودة إلى واجهات التطبيق الأصلية الرئيسية.
  • فشل الانتقالات من تطبيق إلى تطبيق: تتطلب الروابط التي تشير إلى خدمات الطرف الثالث (مثل تطبيقات الملاحة، أو حوارات المشاركة الاجتماعية، أو بوابات الدفع) تفويضاً صريحاً إذا كانت تلك الخدمات تعتمد على مخططات URL مخصصة.

مقارنة WKWebView مقابل SFSafariViewController لعمليات التسليم من الويب إلى التطبيق

عند تصميم تصفح الويب داخل التطبيق على iOS، يجب على الفرق الهندسية الاختيار بين WKWebView و SFSafariViewController:

  • SFSafariViewController: يوفر واجهة تصفح Safari مدارة من قبل النظام ومكتفية ذاتياً مع ميزات مثل التعبئة التلقائية وحظر المحتوى. لا يمكن للتطبيق المضيف فحص نشاط التصفح أو بيانات الموقع، ويقتصر تخصيص واجهة المستخدم على ألوان التظليل.
  • WKWebView: مكون عرض مضمن يُستضاف داخل عملية واجهة مستخدم التطبيق أثناء تشغيل محتوى الويب في عمليات WebKit منفصلة. يسمح بتخصيص عميق لواجهة المستخدم، وجسور JavaScript، وتكامل تخطيط مخصص، مما يتطلب تنفيذاً صريحاً لـ WKNavigationDelegate لتخصيص سياسات التوجيه ومعالجة المخططات المخصصة المحددة من قبل التطبيق.

كيف يعترض decidePolicyForNavigationAction توجيه WebKit

خط أنابيب سياسة التنقل: فهم WKNavigationAction، وrequest، وdecisionHandler

للتحكم في تدفق التنقل داخل WKWebView، يقوم المطورون بتعيين مفوض مخصص يتوافق مع إرشادات مطوري Apple حول WKNavigationDelegate. نقطة الاعتراض الأساسية هي طريقة المفوض:

func webView(
    _ webView: WKWebView,
    decidePolicyFor navigationAction: WKNavigationAction,
    decisionHandler: @escaping (WKNavigationActionPolicy) -> Void
)

تمر إجراءات التنقل الناتجة عن تفاعلات المستخدم، أو عمليات إعادة التوجيه البرمجية، أو عمليات إرسال النماذج عبر هذه الطريقة. يوفر كائن WKNavigationAction بيانات تعريف رئيسية:

  • navigationAction.request.url: عنوان URL المستهدف المطلوب.
  • navigationAction.navigationType: نوع المشغل (.linkActivated، .other، .formSubmitted).
  • navigationAction.sourceFrame: معلومات بخصوص الإطار الذي بدأ طلب التنقل.
  • navigationAction.targetFrame: معلومات بخصوص الإطار الوجهة حيث يُقصد تحميل المحتوى.

يعتبر decisionHandler إغلاقاً للإكمال يخبر WebKit بما إذا كان سيسمح بالتنقل المطلوب أو يلغيه.

متى يتم إرجاع .allow مقابل .cancel: التحكم في دورة حياة تحميل موارد WebKit

تتحكم سياسة WKNavigationActionPolicy التي يتم تمريرها إلى decisionHandler فيما إذا كان WebKit سيتابع التنقل:

  • .allow: يخبر WebKit بالمتابعة في التنقل المطلوب داخل عرض الويب.
  • .cancel: يوجه WebKit لإلغاء التنقل المطلوب. يتم تنفيذ هذه السياسة كلما اعترض التطبيق المضيف مخططاً مخصصاً، أو وجه رابط Universal Link مملوكاً للتطبيق داخلياً، أو فوض هدفاً خارجياً إلى UIApplication.shared.open().

يجب استدعاء decisionHandler مرة واحدة بالضبط لكل إجراء تنقل لضمان استمرار حل سياسة التنقل دون تعطل.

تقييم أنواع التنقل: التمييز بين نقرات المستخدم (.linkActivated) وعمليات إعادة التوجيه المؤتمتة

يسمح WKNavigationAction.navigationType للمطورين بالتمييز بين تفاعلات المستخدم الصريحة والبرامج النصية المؤتمتة:

  • .linkActivated: قام المستخدم مادياً بالنقر على علامة ربط HTML (<a href="...">).
  • .other: يمثل عمليات التنقل البرمجية، مثل تحديثات window.location.href، أو عمليات التحديث التلقائي (meta refreshes)، أو استدعاءات webView.load() الأولية.
  • .formSubmitted / .formResubmitted: يمثل عمليات إرسال نماذج POST أو GET.

يتيح تقييم navigationType للتطبيقات فرض سياسة ارتباط صريحة ومحافظة على مستوى التطبيق. بالنسبة لاستدعاءات المخطط المخصص الخارجي أو تسليمات تطبيقات الطرف الثالث، يساعد اشتراط .linkActivated كبوابة سياسة في منع البرامج النصية الخلفية غير المطلوبة من إطلاق عمليات تشغيل تلقائية للتطبيقات الخارجية.

معالجة سياسات القرار غير المتزامنة دون دورات احتفاظ (Retain Cycles)

عندما تتطلب مراجعة المسار أو فحوصات الإذن الاستعلام عن ذاكرة التخزين المؤقت المحلية أو أدوات التحقق من الأمان قبل إرجاع قرار:

  1. تأكد من تنفيذ decisionHandler عبر جميع مسارات التنفيذ، بما في ذلك حالات الخطأ والحماية.
  2. استخدم مراجع ضعيفة ([weak self]) داخل الإغلاقات الهروبية لمنع دورات الاحتفاظ بين WKWebView، ومفوضه، و UIViewController الأب.

التمييز بين النطاقات المرتبطة بالتطبيق المضيف وروابط Universal Links الخارجية

روابط Universal Links المملوكة للتطبيق يجب أن تتحقق وتوجه داخلياً من WKWebView.

إدارة الوجهات المملوكة للتطبيق مقابل تفويض الروابط على مستوى النظام

بالنسبة للمسارات المملوكة للتطبيق، تجنب محاولة إعادة دخول نفس التطبيق من خلال بحث زائد عن الحاجة لـ Universal Link. تعامل مع الوجهات المملوكة للتطبيق مباشرة من خلال الموجه الداخلي للتطبيق المضيف، واستخدم فتح النظام بشكل أساسي للوجهات التي يجب أن تترك التطبيق الحالي أو يتم حلها بواسطة خدمات خارجية.

يضمن هذا الفصل الهندسي تنقلاً سلساً:

  • النطاقات المرتبطة بالتطبيق المضيف: إذا كان مضيف URL يطابق النطاق المرتبط بالتطبيق المضيف (app.example.com)، قم بإلغاء تنقل عرض الويب (decisionHandler(.cancel))، وتحقق من مسار الطريق، ومرر المعلمات التي تم تحليلها مباشرة إلى موجه التنقل الداخلي للتطبيق.
  • التطبيقات الخارجية: إذا كان URL يشير إلى وجهة شريك خارجي أو مخطط مخصص مسموح به، طبق بوابة ارتباط صريحة على مستوى التطبيق (navigationType == .linkActivated)، وقم بإلغاء تنقل عرض الويب، ووجه الطلب إلى UIApplication.shared.open(url) للسماح لنظام التشغيل بتشغيل التطبيق الخارجي.

هندسة التحقق من المسار الداخلي: استخراج المسارات ومعلمات الاستعلام عبر AppRouteValidator

عندما يطابق URL الوارد النطاق المرتبط بالتطبيق المضيف، يجب أن يمر سلسلة URL عبر مدقق توجيه صارم قبل تشغيل انتقالات وحدة التحكم في العرض.

نموذج AppRouteValidator:

  • يتحقق من مسار URL مقابل قائمة سماح للمسارات الداخلية المدعومة (على سبيل المثال، /open/، /product/، /promo/، /checkout/).
  • يستخرج معلمات الاستعلام (على سبيل المثال، id، promo، utm_source).
  • يفرض قيود مجموعة الأحرف، وحدود الطول، ورفض المفاتيح المكررة، ويعيد هيكل بيانات ValidatedAppRoute نظيفاً.

معالجة روابط Universal Links الخارجية الخاصة بأطراف ثالثة عبر تفويض نظام UIApplication

روابط Universal Links الخارجية يمكن أن تحاول التسليم الأصلي والعودة إلى الويب.

عندما ترتبط صفحة ويب داخل WKWebView بخدمات خارجية (مثل تطبيقات الشركاء، أو منصات التواصل الاجتماعي، أو الأدوات المساعدة الخارجية)، يمكن للتطبيق المضيف تفويض التوجيه إلى نظام iOS:

let options: [UIApplication.OpenExternalURLOptionsKey: Any] = [
    .universalLinksOnly: true
]
UIApplication.shared.open(url, options: options) { success in
    if !success {
        // سياسة التطبيق الاحتياطية: تحميل وجهة الويب إذا لم يعالج أي تطبيق أصلي رابط Universal Link
    }
}

إدارة احتياطيات مخطط URL المخصص (myapp://) جنباً إلى جنب مع روابط HTTPS Universal Links

بينما تمثل روابط HTTPS Universal Links الروابط العميقة القياسية على iOS، لا تزال المخططات المخصصة المحددة من قبل التطبيق (myapp:// أو partnerapp://) شائعة عبر الحملات الترويجية وتكاملات الشركاء.

في تنفيذ موحد لـ WKNavigationDelegate:

  • يتم فحص المخططات غير HTTP/HTTPS أولاً. إذا كان المخطط يطابق بروتوكولاً مخصصاً مسموحاً به ويستوفي سياسة الارتباط الصريح (navigationType == .linkActivated)، يتحقق المفوض من المضيف، والمسار، والمعلمات قبل الإرسال إلى UIApplication.shared.open().
  • يتم إلغاء المخططات غير المعترف بها أو استدعاءات المخطط الخلفية غير المطلوبة على الفور، مما يمنع أخطاء التنقل غير المعالجة أو فيض النية المدفوع بالنصوص البرمجية.
[المستخدم يتفاعل مع رابط داخل iOS WKWebView]
                       │
                       ▼
[WKNavigationDelegate: decidePolicyForNavigationAction]
                       │
         ┌─────────────┴─────────────┐
         ▼                           ▼
[!action.sourceFrame.isMainFrame] [action.sourceFrame.isMainFrame]
         │                           │
         ▼                           ▼
[بوابة أمان الإطار الفرعي]       [فحص مخطط ومضيف الوجهة]
├─ HTTP(S) -> .allow                 │
└─ غير ويب -> .cancel    ┌───────────┼───────────┐
   (قمع الإطار الفرعي)   ▼           ▼           ▼
                   [نطاق المضيف] [ويب خارجي] [مخطط مخصص]
                         │           │           │
                         ▼           ▼           ▼
                   [AppRoute]    [فحص الرابط]   [فحص الرابط]
                   ├─ صالح ->   ├─ شريك->   ├─ صالح & نقرة->
                   │  داخلي     │  فتح تطبيق    │  فتح تطبيق
                   └─ غير صالح->  └─ ويب ->      └─ غير صالح/تلقائي->
                      .cancel       .allow         .cancel

كيفية فرض أمان الإطار الرئيسي ومنع اختطاف الإطار المضمن (Iframe Hijacking)

أصل إطار WKNavigationAction وسياق الهدف يحددان سياسة التنقل الآمن.

التعامل مع تنقل الويب المضمن كمدخل غير موثوق: معايير أمان الروابط العميقة لـ OWASP

وفقاً لـ دليل اختبار أمان تطبيقات الهاتف المحمول الخاص بـ OWASP حول الروابط العميقة غير الآمنة، يجب التعامل مع جميع روابط URL وحمولات المعلمات التي تتم معالجتها بواسطة معالجات تنقل الهاتف المحمول كمدخلات خارجية غير موثوقة.

قد تقوم صفحات الويب المعروضة داخل WKWebView بتحميل نصوص برمجية لأطراف ثالثة، أو لافتات إعلانية، أو محتوى من إنشاء المستخدم. إذا قام مفوض التنقل بتمرير عناوين URL اعتباطية إلى وحدات تحكم في العرض أصلية أو إلى UIApplication.shared.open() دون تحقق، فقد تستهدف معلمات غير متوقعة مسارات تطبيق داخلية حساسة.

عزل عمليات تنقل الإطار الرئيسي عن الإطارات المضمنة (Iframes) وأهداف النافذة الجديدة

وفقاً لـ وثائق مطوري Apple حول WKNavigationAction، يتطلب تقييم أمان الإطار التحقق من الإطار البادئ:

  • sourceFrame.isMainFrame == true: تم بدء التنقل مباشرة بواسطة إطار المستند الأساسي أو الأعلى مستوى.
  • sourceFrame.isMainFrame == false: تم بدء التنقل بواسطة إطار فرعي مضمن أو iframe.
  • targetFrame == nil: يطلب التنقل هدف نافذة جديدة (مثل مرساة بـ target="_blank").

لمنع اختطاف الإطار المضمن (iframe hijacking)—حيث يحاول إطار مضمن تشغيل تطبيقات خارجية أو تشغيل انتقالات عرض أصلية في الخلفية—يجب على المفوض تقييم sourceFrame.isMainFrame. إذا كان الإطار البادئ هو إطار مضمن (sourceFrame.isMainFrame == false)، اسمح بتنقل الإطار الفرعي القياسي HTTP/HTTPS (.allow)، ولكن قم بحظر أي مخططات مخصصة غير ويب أو تسليمات توجيه أصلية (.cancel).

منع استدعاءات بروتوكول الإطار الفرعي الخبيثة وفيض المخطط في الخلفية

يمنع فرض فحوصات الإطار البادئ الإطارات الفرعية من تشغيل استدعاءات مخطط خارجي غير مطلوبة:

if !navigationAction.sourceFrame.isMainFrame {
    let scheme = url.scheme?.lowercased() ?? ""
    if scheme == "http" || scheme == "https" {
        decisionHandler(.allow) // السماح بتنقل الإطار الفرعي القياسي HTTP(S)
    } else {
        decisionHandler(.cancel) // قمع المخططات غير الويب من الإطارات الفرعية
    }
    return
}

فرض قوائم سماح صارمة للمسار ومعلمات الاستعلام في توجيه العميل

يجب أن تمر كل من روابط النطاق المرتبط الداخلي والمخططات المخصصة الخارجية عبر نماذج مدقق صارمة قبل التنفيذ:

  • قائمة سماح بادئة المسار: فرض بادئات المسار المعتمدة (على سبيل المثال، /open/، /product/، /promo/، /checkout/)، ورفض المسارات الاعتباطية أو المشوهة.
  • تصفية مفاتيح الاستعلام: تجاهل مفاتيح الاستعلام غير المتوقعة ورفض مفاتيح المعلمات المكررة لمنع تلوث المعلمات.
  • قيود نوع البيانات والطول: قصر قيم المعلمات على مجموعات أحرف أبجدية رقمية وفرض حدود طول قصوى (≤64\le 64 حرفاً).

تنفيذ WKNavigationDelegate للإنتاج بلغة Swift

هيكلة CustomWebViewController وهندسة المفوض في Swift

ينسق جهاز تحكم WKWebView الخاص بالإنتاج تهيئة الويب، وتقييم سياسة التنقل، والتوجيه الداخلي، والتفويض الخارجي. يغلف التنفيذ قواعد التحقق داخل فئات مدقق مخصصة (AppRouteValidator و CustomSchemeValidator) للحفاظ على استدعاءات المفوض نظيفة وقابلة للاختبار وآمنة.

تنفيذ نماذج AppRouteValidator و CustomSchemeValidator

تفرض نماذج المدقق أماناً صارماً (فشل مغلق):

  • يتحقق AppRouteValidator من النطاقات المرتبطة الداخلية، ويفحص بادئات المسار ويعقم معلمات الاستعلام في كائن ValidatedAppRoute مهيكل.
  • يتحقق CustomSchemeValidator من المخططات المخصصة المصرح بها (myapp)، ويتحقق من المضيفين المسموح بهم (open، product، event)، ويعقم قيم الاستعلام.

يمكن دمج OpoInstall جنباً إلى جنب مع طبقة توجيه مملوكة للتطبيق من أجل الإسناد واسترداد المعلمات المؤجل. راجع وثائق تكامل SDK للحصول على أدلة تكامل شاملة.

يوضح التنفيذ التقني أدناه كيفية تهيئة WKNavigationDelegate آمن بلغة Swift:

// iOS: CustomWebViewController مع توجيه WKNavigationDelegate صارم وأمان الإطار
// مثال تكامل مرجعي. تحقق من توقيعات الطريقة وتعيينات النطاق مقابل هندستك المنشورة.
import UIKit
import WebKit

struct ValidatedAppRoute {
    let path: String
    let queryParams: [String: String]
}

// 1. مدقق النطاق المرتبط بالتطبيق المضيف (المسارات الداخلية)
class AppRouteValidator {
    private static let allowedPrefixes = ["/open/", "/product/", "/promo/", "/checkout/"]
    private static let allowedQueryKeys = Set(["target", "id", "promo", "utm_source"])

    static func validate(url: URL) -> ValidatedAppRoute? {
        let path = url.path
        // فرض قائمة سماح بادئة المسار المعتمدة
        guard allowedPrefixes.contains(where: { path.hasPrefix($0) }) else {
            return nil
        }

        var sanitizedParams: [String: String] = [:]
        var seenKeys = Set<String>()

        if let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
           let queryItems = components.queryItems {
            let validChars = CharacterSet(charactersIn: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-")
            
            for item in queryItems {
                // التحقق بأسلوب الفشل المغلق: رفض URL إذا كانت مفاتيح الاستعلام غير مصرح بها أو توجد مفاتيح مكررة
                guard allowedQueryKeys.contains(item.name), !seenKeys.contains(item.name) else { return nil }
                seenKeys.insert(item.name)

                let value = item.value ?? ""
                if value.count <= 64 && value.rangeOfCharacter(from: validChars.inverted) == nil {
                    sanitizedParams[item.name] = value
                } else {
                    return nil
                }
            }
        }

        return ValidatedAppRoute(path: path, queryParams: sanitizedParams)
    }
}

// 2. مدقق المخططات المخصصة الخارجية (myapp://)
class CustomSchemeValidator {
    private static let allowedSchemes = Set(["myapp"])
    private static let allowedHosts = Set(["open", "product", "event"])
    private static let allowedPathPrefixes = ["/detail/", "/view/", "/main/"]
    private static let allowedQueryKeys = Set(["target", "id", "promo", "utm_source"])

    static func validate(url: URL) -> URL? {
        guard let scheme = url.scheme?.lowercased(), allowedSchemes.contains(scheme) else {
            return nil
        }
        guard let host = url.host?.lowercased(), allowedHosts.contains(host) else {
            return nil
        }

        let path = url.path
        if !path.isEmpty && !allowedPathPrefixes.contains(where: { path.hasPrefix($0) }) {
            return nil
        }

        var seenKeys = Set<String>()
        if let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
           let queryItems = components.queryItems {
            let validChars = CharacterSet(charactersIn: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-")
            for item in queryItems {
                guard allowedQueryKeys.contains(item.name), !seenKeys.contains(item.name) else { return nil }
                seenKeys.insert(item.name)

                let value = item.value ?? ""
                if value.count > 64 || value.rangeOfCharacter(from: validChars.inverted) != nil {
                    return nil
                }
            }
        }

        return url
    }
}

// 3. UIViewController يستضيف WKWebView مع اعتراض سياسة التنقل الآمن
class CustomWebViewController: UIViewController, WKNavigationDelegate {

    var webView: WKWebView!
    private let hostAssociatedDomain = "app.example.com"
    private let allowedExternalPartnerHosts = Set(["partner.example.com"])

    override func viewDidLoad() {
        super.viewDidLoad()

        let configuration = WKWebViewConfiguration()
        webView = WKWebView(frame: view.bounds, configuration: configuration)
        webView.navigationDelegate = self
        view.addSubview(webView)
    }

    func webView(
        _ webView: WKWebView,
        decidePolicyFor navigationAction: WKNavigationAction,
        decisionHandler: @escaping (WKNavigationActionPolicy) -> Void
    ) {
        guard let url = navigationAction.request.url else {
            decisionHandler(.allow)
            return
        }

        // فحص الأمان 1: فرض حدود الإطار البادئ (sourceFrame) لمنع اختطاف الإطار المضمن
        if !navigationAction.sourceFrame.isMainFrame {
            let scheme = url.scheme?.lowercased() ?? ""
            if scheme == "http" || scheme == "https" {
                decisionHandler(.allow) // السماح بتنقل الإطار الفرعي القياسي HTTP(S)
            } else {
                decisionHandler(.cancel) // قمع المخططات غير الويب من الإطارات الفرعية/المضمنة
            }
            return
        }

        let scheme = url.scheme?.lowercased() ?? ""
        let isExplicitLinkActivation = (navigationAction.navigationType == .linkActivated)

        // فحص الأمان 2: التعامل مع النطاق المرتبط بالتطبيق المضيف نفسه
        // التوجيه داخلياً بدلاً من استدعاء UIApplication.shared.open
        if scheme == "https", let host = url.host?.lowercased(), host == hostAssociatedDomain {
            if let validatedRoute = AppRouteValidator.validate(url: url) {
                AppInternalRouter.shared.navigate(to: validatedRoute)
            }
            decisionHandler(.cancel) // إلغاء تحميل داخل webview للتوجيه داخلياً
            return
        }

        // فحص الأمان 3: التعامل مع المخططات المخصصة المسموح بها (myapp://) مع سياسة تنشيط الرابط
        if scheme != "http" && scheme != "https" && scheme != "about" {
            // فرض أن عمليات تشغيل التطبيق الخارجي للمخطط المخصص تتطلب تنشيط رابط مستخدم صريح
            if isExplicitLinkActivation, let validatedURL = CustomSchemeValidator.validate(url: url) {
                UIApplication.shared.open(validatedURL, options: [:], completionHandler: nil)
            }
            decisionHandler(.cancel) // إلغاء تحميل داخل webview لمنع أخطاء المخطط غير المعالجة
            return
        }

        // فحص الأمان 4: التعامل مع الوجهات الخارجية وطلبات النافذة الجديدة (target="_blank")
        if scheme == "http" || scheme == "https" {
            let host = url.host?.lowercased() ?? ""
            
            // تفويض روابط Universal Links الخاصة بالشريك الموثوق إلى تطبيق خارجي مع سياسة الارتباط الصريح
            if allowedExternalPartnerHosts.contains(host) && isExplicitLinkActivation {
                let options: [UIApplication.OpenExternalURLOptionsKey: Any] = [
                    .universalLinksOnly: true
                ]
                UIApplication.shared.open(url, options: options) { [weak self] success in
                    if !success {
                        // سياسة التطبيق الاحتياطية: تحميل وجهة الشريك الخارجي داخل عرض الويب إذا لم يعالجها أي تطبيق أصلي
                        guard let self = self else { return }
                        self.webView.load(navigationAction.request)
                    }
                }
                decisionHandler(.cancel)
                return
            }

            // إذا كان targetFrame هو nil (طلب نافذة جديدة)، تحميل بأمان في webView الحالي
            if navigationAction.targetFrame == nil {
                webView.load(navigationAction.request)
                decisionHandler(.cancel)
                return
            }

            // محتوى الويب القياسي يستمر في التحميل داخل WKWebView
            decisionHandler(.allow)
            return
        }

        decisionHandler(.allow)
    }
}

// نائب موجه داخلي خاص بالتطبيق (ليس OpoInstall SDK API)
class AppInternalRouter {
    static let shared = AppInternalRouter()

    func navigate(to route: ValidatedAppRoute) {
        // تنفيذ انتقال وحدة تحكم عرض UI داخلية بناءً على المسار ومعلمات الاستعلام
    }
}

التنفيذ الآمن للخيوط: ضمان تنفيذ انتقالات واجهة المستخدم على الممثل الرئيسي (Main Actor)

في نماذج التزامن الحالية في Swift، يتم عزل استدعاءات WKNavigationDelegate على الممثل الرئيسي. يتم تنفيذ توجيه التطبيق وانتقالات وحدة التحكم في العرض على الممثل الرئيسي، مما يحافظ على أمان الخيوط عبر سير عمل التنقل الأصلي.

أخطاء تنقل الروابط العميقة في WKWebView ومصفوفة التشخيص

دليل استكشاف أخطاء الروابط العميقة في iOS WKWebView الشامل

توضح المصفوفة أدناه أنماط الفشل الشائعة التي تمت مواجهتها عند إدارة الروابط العميقة والمخططات المخصصة داخل WKWebView على iOS، إلى جانب الأسباب الجذرية الأولية والمعالجات الهندسية الموصى بها:

توقيع الخطأ / العرض السبب الجذري الأولي إصدارات iOS المعمول بها نقطة التحقق التشخيصية المعالجة الموصى بها
تحميل Universal Link في الويب نطاق مملوك للتطبيق غير معترض iOS 9+ decidePolicyForNavigationAction غير معالج اعتراض نطاق المضيف، تحليل المسار، التوجيه داخلياً، .cancel
فشل رابط النطاق الذاتي في التوجيه استدعاء UIApplication.open على النطاق الخاص iOS 9+ UIApplication.shared.open تم استدعاؤه على المضيف الخاص تجنب الفتح الذاتي الخارجي؛ توجيه إلى الموجه الداخلي مباشرة
فشل المخطط المخصص بصمت بروتوكول غير HTTP لم يتعرف عليه WebKit iOS 9+ المخطط لم يتم تفويضه إلى UIApplication اعتراض المخطط في المفوض، التحقق من قائمة السماح، الفتح عبر UIApplication
اختطاف بروتوكول الإطار المضمن إطار فرعي يشغل مخطط مخصص خارجي iOS 9+ sourceFrame.isMainFrame غير مفحوص الحماية بـ if !sourceFrame.isMainFrame وقمع المخططات غير الويب
تحذير تسليم واجهة المستخدم أو مشكلة انتقال انتقالات واجهة المستخدم منفذة خارج الخيط الرئيسي iOS 9+ فقدان إرسال الممثل الرئيسي ضمان تنفيذ الممثل الرئيسي للموجه الداخلي وانتقالات وحدة تحكم العرض

الأسئلة الشائعة (FAQ)

كيف يمكن للمطورين اعتراض روابط Universal Links في WKWebView؟
يقوم المطورون بتنفيذ `WKNavigationDelegate` وفحص عناوين URL الواردة داخل `decidePolicyForNavigationAction`. إذا تطابق عنوان URL مع وجهة مملوكة للتطبيق، يقوم المفوض بإلغاء تنقل داخل webview بـ `.cancel` ويمرر المعلمات التي تم التحقق منها مباشرة إلى موجه التنقل الداخلي للتطبيق.
هل يمكنني استخدام UIApplication.shared.open لتشغيل تطبيقي الخاص من WKWebView؟
تحدد وثائق Apple أن استدعاء `UIApplication.shared.open()` على رابط Universal Link يشير إلى النطاق المرتبط بالتطبيق المضيف نفسه لن يفتح الرابط في التطبيق كرابط Universal Link. بالنسبة لروابط النطاق الخاص، يجب على التطبيق إلغاء تنقل webview واستدعاء موجه التنقل الداخلي الخاص به مباشرة.
كيف يمكنني منع الإطارات المضمنة (iframes) في WKWebView من تشغيل عمليات إطلاق تطبيقات خارجية؟
لمنع اختطاف الإطار المضمن (iframe hijacking)، تحقق من `navigationAction.sourceFrame.isMainFrame` داخل `decidePolicyForNavigationAction`. إذا كان `isMainFrame` هو `false`، اسمح بتنقل الإطار الفرعي القياسي HTTP(S) بـ `.allow`، ولكن قم بإلغاء المخططات المخصصة غير الويب بـ `.cancel` لمنع إطارات الأطراف الثالثة من تنفيذ عمليات إطلاق خارجية غير مطلوبة.

الملخص وإطار عمل القرار

يتطلب التعامل مع روابط Universal Links والمخططات المخصصة داخل WKWebView على iOS سد الفجوة بين حاوية عرض الويب في WebKit ودورات حياة التنقل في UIKit الأصلية. الاعتماد على سياسات التنقل الافتراضية يمكن أن يمنع عمليات التسليم السلسة عندما يكون منطق التوجيه المملوك للتطبيق مطلوباً.

من خلال تنفيذ WKNavigationDelegate قوي يتحقق من حدود الإطار، ويفرض سياسات تنشيط الروابط المحافظة على التسليمات الخارجية، ويحلل النطاقات المرتبطة الداخلية عبر مدققات مسار صارمة، ويفوض الأهداف الخارجية بأمان إلى UIApplication.shared.open، تحافظ الفرق الهندسية على تنقل خاضع للرقابة مع الحماية ضد اختطاف بروتوكول الإطار المضمن.

لاستكشاف هندسة الروابط العميقة وتوجيه المعلمات على iOS، راجع وثائق تكامل SDK.

مواد ذات صلة

Share this article