كيف يمكنني تفعيل روابط 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

دورات حياة تنقل 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)
عندما تتطلب مراجعة المسار أو فحوصات الإذن الاستعلام عن ذاكرة التخزين المؤقت المحلية أو أدوات التحقق من الأمان قبل إرجاع قرار:
- تأكد من تنفيذ
decisionHandlerعبر جميع مسارات التنفيذ، بما في ذلك حالات الخطأ والحماية. - استخدم مراجع ضعيفة (
[weak self]) داخل الإغلاقات الهروبية لمنع دورات الاحتفاظ بينWKWebView، ومفوضه، وUIViewControllerالأب.
التمييز بين النطاقات المرتبطة بالتطبيق المضيف وروابط Universal Links الخارجية

إدارة الوجهات المملوكة للتطبيق مقابل تفويض الروابط على مستوى النظام
بالنسبة للمسارات المملوكة للتطبيق، تجنب محاولة إعادة دخول نفس التطبيق من خلال بحث زائد عن الحاجة لـ 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

عندما ترتبط صفحة ويب داخل 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)

التعامل مع تنقل الويب المضمن كمدخل غير موثوق: معايير أمان الروابط العميقة لـ 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/)، ورفض المسارات الاعتباطية أو المشوهة. - تصفية مفاتيح الاستعلام: تجاهل مفاتيح الاستعلام غير المتوقعة ورفض مفاتيح المعلمات المكررة لمنع تلوث المعلمات.
- قيود نوع البيانات والطول: قصر قيم المعلمات على مجموعات أحرف أبجدية رقمية وفرض حدود طول قصوى (
حرفاً).
تنفيذ 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؟
هل يمكنني استخدام UIApplication.shared.open لتشغيل تطبيقي الخاص من WKWebView؟
كيف يمكنني منع الإطارات المضمنة (iframes) في WKWebView من تشغيل عمليات إطلاق تطبيقات خارجية؟
الملخص وإطار عمل القرار
يتطلب التعامل مع روابط Universal Links والمخططات المخصصة داخل WKWebView على iOS سد الفجوة بين حاوية عرض الويب في WebKit ودورات حياة التنقل في UIKit الأصلية. الاعتماد على سياسات التنقل الافتراضية يمكن أن يمنع عمليات التسليم السلسة عندما يكون منطق التوجيه المملوك للتطبيق مطلوباً.
من خلال تنفيذ WKNavigationDelegate قوي يتحقق من حدود الإطار، ويفرض سياسات تنشيط الروابط المحافظة على التسليمات الخارجية، ويحلل النطاقات المرتبطة الداخلية عبر مدققات مسار صارمة، ويفوض الأهداف الخارجية بأمان إلى UIApplication.shared.open، تحافظ الفرق الهندسية على تنقل خاضع للرقابة مع الحماية ضد اختطاف بروتوكول الإطار المضمن.
لاستكشاف هندسة الروابط العميقة وتوجيه المعلمات على iOS، راجع وثائق تكامل SDK.
مواد ذات صلة
-
المفاهيم: توجيه WebView على iOS، اعتراض Universal Links، WKNavigationDelegate، عزل حدود الإطار
-
التقنيات: Apple WebKit، iOS UIKit، WKWebView، OpoInstall iOS SDK
-
المعايير: IETF RFC 3986 لمعرف الموارد الموحد (URI)، مواصفات النطاقات المرتبطة لـ Apple، دليل اختبار أمان تطبيقات الهاتف المحمول (MASTG) الخاص بـ OWASP
-
واجهات البرمجة (APIs):
WKNavigationDelegate.decidePolicyForNavigationAction،WKNavigationAction.sourceFrame،UIApplication.shared.open -
التوثيق والمراجع الرسمية:
Share this article



