iOS Universal Links का समर्थन करने के लिए WKWebView राउटिंग को कॉन्फ़िगर कैसे करें

opoinstall
2026-10-07
5 min read

मैं iOS WKWebView के भीतर यूनिवर्सल लिंक्स (Universal Links) को कैसे सक्षम करूँ? यूनिवर्सल लिंक्स पहले से ही WKWebView के भीतर पात्र लिंक्स से रिज़ॉल्व हो सकते हैं। WKNavigationDelegate को लागू करने से होस्ट एप्लिकेशन को राउटिंग नीतियों को कस्टमाइज़ करने की अनुमति मिलती है—जैसे ऐप-स्वामित्व वाले गंतव्यों को इंटरसेप्ट करना, decidePolicyForNavigationAction के माध्यम से बाहरी हैंडऑफ़ को नियंत्रित करना, और फ्रेम-स्तरीय सुरक्षा लागू करना।

iOS एप्लिकेशन आर्किटेक्चर में, WKWebView नेविगेशन इंटरसेप्शन होस्ट एप्लिकेशन को यूनिवर्सल लिंक्स, कस्टम URL स्कीम्स और वेब गंतव्यों के लिए राउटिंग नीतियों को कस्टमाइज़ करने की अनुमति देता है। WKNavigationDelegate के भीतर नेविगेशन अनुरोध मेटाडेटा का मूल्यांकन करके, एप्लिकेशन ऐप-स्वामित्व वाले गंतव्यों को आंतरिक रूप से रूट कर सकता है, बाहरी लक्ष्यों को सिस्टम हैंडलर्स को सौंप सकता है, और फ्रेम-स्तरीय सुरक्षा नीतियों को लागू कर सकता है।

शब्द परिभाषा संबंधित एंटिटी खोज उद्देश्य की भूमिका
WebView एक एम्बेडेड WebKit-आधारित व्यू कंपोनेंट जो iOS एप्लिकेशन के भीतर इंटरैक्टिव वेब सामग्री रेंडर करता है। iOS SDK सूचनात्मक / वाणिज्यिक
Universal Links सत्यापित वेब डोमेन को नेटिव iOS एप्लिकेशन व्यू से जोड़ने वाला एक मानक HTTPS तंत्र। डीप लिंक राउटिंग तकनीकी / सूचनात्मक
Custom URL Scheme एक ऐप-परिभाषित URI स्कीमा जिसका उपयोग URL को नेटिव एप्लिकेशन में रूट करने के लिए किया जाता है। मोबाइल डीप लिंकिंग सूचनात्मक

iOS पर WKWebView और यूनिवर्सल लिंक राउटिंग कैसे इंटरैक्ट करते हैं

WKNavigationDelegate यह तय करता है कि WebKit लोड करे, आंतरिक रूप से रूट करे, हैंडऑफ़ करे या रद्द करे।

WebKit नेविगेशन लाइफसाइकिल और ऐप-स्वामित्व वाली राउटिंग नीतियां

Apple यूनिवर्सल लिंक्स को एक सिस्टम-स्तरीय राउटिंग तंत्र के रूप में लागू करता है जो Safari और WKWebView वातावरण में समर्थित है। जब कोई उपयोगकर्ता एम्बेडेड WKWebView के भीतर किसी पात्र लिंक पर टैप करता है, तो प्लेटफ़ॉर्म डोमेन एसोसिएशन को रिज़ॉल्व कर सकता है और ऑपरेटिंग सिस्टम की नीतियों के अनुसार निष्पादन को रूट कर सकता है।

जबकि सिस्टम-मान्यता प्राप्त यूनिवर्सल लिंक्स निष्पादन को नेटिव हैंडलर्स को सौंप सकते हैं, एम्बेडेड ब्राउज़र वातावरण को अक्सर एप्लिकेशन-विशिष्ट राउटिंग तर्क की आवश्यकता होती है। उदाहरण के लिए, जब कोई लिंक होस्ट एप्लिकेशन के अपने डोमेन को लक्षित करता है, तो डेवलपर्स अक्सर पूर्ण बाहरी ऐप री-लॉन्च को ट्रिगर किए बिना नेटिव व्यू कंट्रोलर्स के माध्यम से सीधे नेविगेट करना पसंद करते हैं। WKNavigationDelegate को लागू करने से होस्ट एप्लिकेशन को लिंक मूल्यांकन पर सूक्ष्म नियंत्रण मिलता है, जिससे टीमें कस्टम अलाउलिस्ट लागू कर सकती हैं और आंतरिक गंतव्यों को अनुमानित रूप से रूट कर सकती हैं।

उपयोगकर्ता अनुभव बाधा: जब इन-ऐप वेब ब्राउजिंग उपयोगकर्ताओं को वेब रिडायरेक्शन लूप में फंसाती है

एम्बेडेड WebViews को अक्सर iOS ऐप्स के भीतर प्रचार माइक्रोसाइट्स, सहायता केंद्रों, पार्टनर कैटलॉग और मार्केटिंग लैंडिंग पेजों को होस्ट करने के लिए तैनात किया जाता है। जब एक इन-ऐप वेब पेज में ऐसे लिंक्स शामिल होते हैं जो उपयोगकर्ताओं को होस्ट एप्लिकेशन के अन्य अनुभागों (जैसे, “View in App” बटन) या पार्टनर एप्लिकेशन पर ले जाने के लिए होते हैं, तो डिफ़ॉल्ट नेविगेशन अनावश्यक रेंडरिंग का कारण बन सकता है:

  • अनावश्यक वेब रेंडरिंग: नेटिव व्यू कंट्रोलर्स को रेंडर करने के बजाय, उपयोगकर्ता को इन-ऐप पेजों के रिस्पॉन्सिव वेब संस्करण दिखाए जा सकते हैं, जिसके लिए बार-बार प्रमाणीकरण की आवश्यकता होती है और दृश्य स्थिरता कम हो जाती है।
  • वेब ट्रैपिंग: उपयोगकर्ता मुख्य नेटिव ऐप इंटरफेस पर वापस लौटने के सहज तरीकों के बिना डीप वेब नेविगेशन स्टैक के भीतर फंस सकते हैं।
  • विफल ऐप-टू-ऐप ट्रांज़िशन: तीसरे पक्ष की सेवाओं (जैसे नेविगेशन ऐप्स, सोशल शेयरिंग डायलॉग, या पेमेंट गेटवे) की ओर इशारा करने वाले लिंक्स पर टैप करने के लिए स्पष्ट डेलिगेशन की आवश्यकता होती है यदि वे सेवाएं कस्टम URL स्कीम्स पर निर्भर करती हैं।

वेब-टू-ऐप हैंडऑफ़ के लिए WKWebView बनाम SFSafariViewController की तुलना

iOS पर इन-ऐप वेब ब्राउजिंग को आर्किटेक्ट करते समय, इंजीनियरिंग टीमों को WKWebView और SFSafariViewController के बीच चयन करना होगा:

  • SFSafariViewController: ऑटोफ़िल और कंटेंट ब्लॉकिंग जैसी सुविधाओं के साथ एक सिस्टम-प्रबंधित, स्व-निहित सफारी ब्राउजिंग इंटरफेस प्रदान करता है। होस्ट एप्लिकेशन ब्राउजिंग गतिविधि या वेबसाइट डेटा का निरीक्षण नहीं कर सकता है, और UI कस्टमाइज़ेशन टेंट रंगों तक सीमित है।
  • WKWebView: ऐप की UI प्रक्रिया के भीतर होस्ट किया गया एक एम्बेडेड व्यू कंपोनेंट, जो अलग WebKit प्रक्रियाओं में वेब सामग्री चलाता है। यह गहन UI कस्टमाइज़ेशन, JavaScript ब्रिज और कस्टम लेआउट एकीकरण की अनुमति देता है, जिसके लिए राउटिंग नीतियों को कस्टमाइज़ करने और ऐप-परिभाषित कस्टम स्कीम्स को संभालने के लिए WKNavigationDelegate के स्पष्ट कार्यान्वयन की आवश्यकता होती है।

decidePolicyForNavigationAction, WebKit राउटिंग को कैसे इंटरसेप्ट करता है

नेविगेशन नीति पाइपलाइन: WKNavigationAction, request, और decisionHandler को समझना

एक WKWebView के भीतर नेविगेशन प्रवाह को नियंत्रित करने के लिए, डेवलपर्स एक कस्टम डेलिगेट असाइन करते हैं जो WKNavigationDelegate पर Apple डेवलपर मार्गदर्शन का पालन करता है। मुख्य इंटरसेप्शन पॉइंट डेलिगेट विधि है:

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 संसाधन लोडिंग लाइफसाइकिल को नियंत्रित करना

decisionHandler को पास किया गया WKNavigationActionPolicy नियंत्रित करता है कि WebKit नेविगेशन के साथ आगे बढ़ेगा या नहीं:

  • .allow: WebKit को वेब व्यू के भीतर अनुरोधित नेविगेशन के साथ आगे बढ़ने के लिए सूचित करता है।
  • .cancel: WebKit को अनुरोधित नेविगेशन को रद्द करने का निर्देश देता है। यह नीति तब निष्पादित होती है जब होस्ट एप्लिकेशन किसी कस्टम स्कीम को इंटरसेप्ट करता है, ऐप-स्वामित्व वाले यूनिवर्सल लिंक को आंतरिक रूप से रूट करता है, या बाहरी लक्ष्य को UIApplication.shared.open() को सौंपता है।

यह सुनिश्चित करने के लिए कि नेविगेशन नीति रिज़ॉल्यूशन बिना रुके आगे बढ़े, प्रत्येक नेविगेशन क्रिया के लिए decisionHandler को ठीक एक बार लागू किया जाना चाहिए।

नेविगेशन प्रकारों का मूल्यांकन: उपयोगकर्ता क्लिक (.linkActivated) को स्वचालित रिडायरेक्ट से अलग करना

WKNavigationAction.navigationType डेवलपर्स को स्पष्ट उपयोगकर्ता इंटरैक्शन को स्वचालित स्क्रिप्ट से अलग करने की अनुमति देता है:

  • .linkActivated: उपयोगकर्ता ने भौतिक रूप से एक HTML एंकर टैग (<a href="...">) पर टैप किया है।
  • .other: प्रोग्रामेटिक नेविगेशन का प्रतिनिधित्व करता है, जैसे window.location.href अपडेट, मेटा रिफ्रेश, या प्रारंभिक webView.load() कॉल।
  • .formSubmitted / .formResubmitted: फॉर्म POST या GET सबमिशन का प्रतिनिधित्व करता है।

navigationType का मूल्यांकन करने से एप्लिकेशन को रूढ़िवादी, एप्लिकेशन-स्तरीय स्पष्ट-लिंक नीति लागू करने में मदद मिलती है। बाहरी कस्टम स्कीम इनवोकेशन या तीसरे पक्ष के ऐप हैंडऑफ़ के लिए, नीति गेट के रूप में .linkActivated की आवश्यकता होने से स्वचालित बाहरी ऐप लॉन्च को ट्रिगर करने वाली अनचाही बैकग्राउंड स्क्रिप्ट को रोकने में मदद मिलती है।

रिटेन साइकिल के बिना एसिंक्रोनस निर्णय नीतियों को संभालना

जब मार्ग सत्यापन या अनुमति जांच के लिए निर्णय वापस करने से पहले स्थानीय कैश या सुरक्षा वैलिडेटर से पूछताछ करने की आवश्यकता होती है:

  1. सुनिश्चित करें कि decisionHandler सभी निष्पादन पथों में लागू किया गया है, जिसमें त्रुटि और गार्ड स्थितियां शामिल हैं।
  2. WKWebView, उसके डेलिगेट, और पैरेंट UIViewController के बीच रिटेन साइकिल को रोकने के लिए एस्केपिंग क्लोजर के भीतर कमजोर संदर्भों ([weak self]) का उपयोग करें।

होस्ट ऐप एसोसिएटेड डोमेन को बाहरी यूनिवर्सल लिंक्स से अलग करना

ऐप-स्वामित्व वाले यूनिवर्सल लिंक्स को WKWebView से आंतरिक रूप से मान्य और रूट करना चाहिए।

ऐप-स्वामित्व वाले गंतव्य बनाम सिस्टम-स्तरीय लिंक डेलिगेशन का प्रबंधन

ऐप-स्वामित्व वाले मार्गों के लिए, एक अनावश्यक यूनिवर्सल लिंक लुकअप के माध्यम से उसी एप्लिकेशन में फिर से प्रवेश करने का प्रयास करने से बचें। ऐप-स्वामित्व वाले गंतव्यों को सीधे होस्ट एप्लिकेशन के आंतरिक राउटर के माध्यम से संभालें, और सिस्टम ओपनिंग का उपयोग मुख्य रूप से उन गंतव्यों के लिए करें जिन्हें वर्तमान एप्लिकेशन छोड़ देना चाहिए या बाहरी सेवाओं द्वारा रिज़ॉल्व किया जाना चाहिए।

यह वास्तुशिल्प पृथक्करण सहज नेविगेशन सुनिश्चित करता है:

  • होस्ट ऐप एसोसिएटेड डोमेन: यदि URL होस्ट होस्ट ऐप के अपने एसोसिएटेड डोमेन (app.example.com) से मेल खाता है, तो वेब व्यू नेविगेशन रद्द करें (decisionHandler(.cancel)), मार्ग पथ को मान्य करें, और पार्स किए गए मापदंडों को सीधे एप्लिकेशन के आंतरिक नेविगेशन राउटर को पास करें।
  • बाहरी एप्लिकेशन: यदि URL किसी बाहरी पार्टनर गंतव्य या अनुमति प्राप्त कस्टम स्कीम की ओर इशारा करता है, तो एप्लिकेशन-स्तरीय स्पष्ट-लिंक गेट (navigationType == .linkActivated) लागू करें, वेब व्यू नेविगेशन रद्द करें, और अनुरोध को UIApplication.shared.open(url) पर अग्रेषित करें ताकि ऑपरेटिंग सिस्टम बाहरी ऐप लॉन्च कर सके।

आंतरिक मार्ग सत्यापन की आर्किटेक्चर: AppRouteValidator के माध्यम से पथ और क्वेरी पैरामीटर निकालना

जब कोई आने वाला URL होस्ट एप्लिकेशन के एसोसिएटेड डोमेन से मेल खाता है, तो view controller ट्रांज़िशन को ट्रिगर करने से पहले URL स्ट्रिंग को एक सख्त राउटिंग वैलिडेटर से गुजरना होगा।

AppRouteValidator मॉडल:

  • समर्थित आंतरिक मार्गों (जैसे, /open/, /product/, /promo/, /checkout/) की अलाउलिस्ट के खिलाफ URL पथ को मान्य करता है।
  • क्वेरी पैरामीटर निकालता है (जैसे, id, promo, utm_source)।
  • कैरेक्टर सेट प्रतिबंध, लंबाई की सीमाएं, और डुप्लिकेट की अस्वीकृति लागू करता है, एक साफ ValidatedAppRoute डेटा संरचना लौटाता है।

सिस्टम UIApplication डेलिगेशन के माध्यम से बाहरी तीसरे पक्ष के यूनिवर्सल लिंक्स को संभालना

बाहरी यूनिवर्सल लिंक्स नेटिव हैंडऑफ़ का प्रयास कर सकते हैं और वेब पर वापस आ सकते हैं।

जब WKWebView के भीतर एक वेब पेज बाहरी सेवाओं (जैसे पार्टनर ऐप्स, सोशल प्लेटफॉर्म, या बाहरी उपयोगिताओं) से लिंक करता है, तो होस्ट एप्लिकेशन राउटिंग को iOS सिस्टम को सौंप सकता है:

let options: [UIApplication.OpenExternalURLOptionsKey: Any] = [
    .universalLinksOnly: true
]
UIApplication.shared.open(url, options: options) { success in
    if !success {
        // एप्लिकेशन नीति फॉलबैक: वेब गंतव्य लोड करें यदि कोई नेटिव ऐप यूनिवर्सल लिंक को नहीं संभालता है
    }
}

एप्लिकेशन नीति के रूप में .universalLinksOnly का उपयोग यह सुनिश्चित करता है कि उपयोगकर्ता को वर्तमान ऐप के बाहर केवल तभी ट्रांज़िशन किया जाए जब यूनिवर्सल लिंक को संभालने के लिए एक सत्यापित नेटिव एप्लिकेशन इंस्टॉल हो।

HTTPS यूनिवर्सल लिंक्स के साथ कस्टम URL स्कीम फॉलबैक (myapp://) का प्रबंधन

जबकि HTTPS यूनिवर्सल लिंक्स iOS पर मानक डीप लिंकिंग का प्रतिनिधित्व करते हैं, ऐप-परिभाषित कस्टम स्कीम्स (myapp:// या partnerapp://) प्रचार अभियानों और पार्टनर एकीकरण में आम हैं।

एक एकीकृत WKNavigationDelegate कार्यान्वयन में:

  • गैर-HTTP/HTTPS स्कीम्स का पहले निरीक्षण किया जाता है। यदि स्कीम एक अनुमति प्राप्त कस्टम प्रोटोकॉल से मेल खाती है और स्पष्ट-लिंक नीति (navigationType == .linkActivated) को संतुष्ट करती है, तो डेलिगेट UIApplication.shared.open() पर भेजने से पहले होस्ट, पथ और मापदंडों को सत्यापित करता है।
  • अनजान स्कीम्स या अनचाहे बैकग्राउंड स्कीम इनवोकेशन तुरंत रद्द कर दिए जाते हैं, जिससे अनपेक्षित नेविगेशन त्रुटियां या स्क्रिप्ट-संचालित इंटेंट फ्लडिंग को रोका जा सकता है।
[उपयोगकर्ता iOS WKWebView के भीतर लिंक के साथ इंटरैक्ट करता है]
                       │
                       ▼
[WKNavigationDelegate: decidePolicyForNavigationAction]
                       │
         ┌─────────────┴─────────────┐
         ▼                           ▼
[!action.sourceFrame.isMainFrame] [action.sourceFrame.isMainFrame]
         │                           │
         ▼                           ▼
[सबफ्रेम सुरक्षा गेट]       [लक्ष्य स्कीम और होस्ट का निरीक्षण करें]
├─ HTTP(S) -> .allow                 │
└─ Non-Web -> .cancel    ┌───────────┼───────────┐
   (सबफ्रेम को दबाएं)   ▼           ▼           ▼
                   [होस्ट डोमेन] [बाहरी वेब] [कस्टम स्कीम]
                         │           │           │
                         ▼           ▼           ▼
                   [AppRoute]    [लिंक की जांच करें]   [लिंक की जांच करें]
                   ├─ मान्य ->   ├─ पार्टनर->   ├─ मान्य और क्लिक->
                   │  आंतरिक   │  ओपन ऐप    │  ओपन ऐप
                   └─ अमान्य->  └─ वेब ->      └─ अमान्य/स्वत:->
                      .cancel       .allow         .cancel

मेन फ्रेम सुरक्षा कैसे लागू करें और Iframe हाइजैकिंग को कैसे रोकें

WKNavigationAction फ्रेम ओरिजिन और लक्ष्य संदर्भ सुरक्षित नेविगेशन नीति निर्धारित करते हैं।

एम्बेडेड वेब नेविगेशन को अविश्वसनीय इनपुट के रूप में मानना: OWASP डीप लिंक सुरक्षा मानक

असुरक्षित डीप लिंक्स पर OWASP मोबाइल एप्लिकेशन सुरक्षा परीक्षण गाइड मार्गदर्शन के अनुसार, मोबाइल नेविगेशन हैंडलर्स द्वारा संसाधित सभी URLs और पैरामीटर पेलोड को अविश्वसनीय, बाहरी इनपुट माना जाना चाहिए।

WKWebView के भीतर रेंडर किए गए वेब पेज तीसरे पक्ष की स्क्रिप्ट, विज्ञापन बैनर, या उपयोगकर्ता द्वारा उत्पन्न सामग्री लोड कर सकते हैं। यदि कोई नेविगेशन डेलिगेट सत्यापन के बिना मनमाने URLs को नेटिव व्यू कंट्रोलर्स या UIApplication.shared.open() पर अग्रेषित करता है, तो अनपेक्षित पैरामीटर संवेदनशील आंतरिक एप्लिकेशन मार्गों को लक्षित कर सकते हैं।

एम्बेडेड Iframes और नई विंडो लक्ष्यों से मेन फ्रेम नेविगेशन को अलग करना

WKNavigationAction पर Apple डेवलपर दस्तावेज़ीकरण के अनुसार, फ्रेम सुरक्षा का मूल्यांकन करने के लिए शुरुआती फ्रेम की जांच करना आवश्यक है:

  • sourceFrame.isMainFrame == true: नेविगेशन सीधे प्राथमिक, शीर्ष-स्तरीय दस्तावेज़ फ्रेम द्वारा शुरू किया गया था।
  • sourceFrame.isMainFrame == false: नेविगेशन एक एम्बेडेड सबफ्रेम या iframe द्वारा शुरू किया गया था।
  • targetFrame == nil: नेविगेशन एक नई विंडो लक्ष्य का अनुरोध करता है (जैसे target="_blank" के साथ एक एंकर)।

Iframe हाइजैकिंग को रोकने के लिए—जहां एक एम्बेडेड iframe बैकग्राउंड में बाहरी एप्लिकेशन लॉन्च करने या नेटिव व्यू ट्रांज़िशन को ट्रिगर करने का प्रयास करता है—डेलिगेट को sourceFrame.isMainFrame का मूल्यांकन करना चाहिए। यदि शुरुआती फ्रेम एक iframe है (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
}

क्लाइंट राउटिंग में सख्त पथ और क्वेरी पैरामीटर अलाउलिस्ट लागू करना

आंतरिक एसोसिएटेड डोमेन URLs और बाहरी कस्टम स्कीम्स दोनों को निष्पादन से पहले सख्त वैलिडेटर मॉडल से गुजरना होगा:

  • पथ उपसर्ग अलाउलिस्टिंग: स्वीकृत मार्ग उपसर्गों (जैसे, /open/, /product/, /promo/, /checkout/) को लागू करें, मनमाने या विकृत पथों को अस्वीकार करें।
  • क्वेरी की फ़िल्टरिंग: पैरामीटर प्रदूषण को रोकने के लिए अनपेक्षित क्वेरी कीज़ को त्यागें और डुप्लिकेट पैरामीटर कीज़ को अस्वीकार करें।
  • डेटा-प्रकार और लंबाई की बाधाएं: पैरामीटर मानों को अल्फ़ान्यूमेरिक कैरेक्टर सेट तक सीमित करें और अधिकतम लंबाई सीमाएं (≤64\le 64 अक्षर) लागू करें।

Swift में प्रोडक्शन WKNavigationDelegate कार्यान्वयन

Swift में CustomWebViewController और डेलिगेट आर्किटेक्चर को व्यवस्थित करना

एक प्रोडक्शन WKWebView कंट्रोलर वेब कॉन्फ़िगरेशन, नेविगेशन नीति मूल्यांकन, आंतरिक राउटिंग, और बाहरी डेलिगेशन का समन्वय करता है। कार्यान्वयन सत्यापन नियमों को समर्पित वैलिडेटर कक्षाओं (AppRouteValidator और CustomSchemeValidator) के भीतर एनकैप्सुलेट करता है ताकि डेलिगेट कॉलबैक साफ, परीक्षण योग्य और सुरक्षित रहें।

AppRouteValidator और CustomSchemeValidator मॉडल लागू करना

वैलिडेटर मॉडल सख्त फेल-क्लोज सुरक्षा लागू करते हैं:

  • AppRouteValidator आंतरिक एसोसिएटेड डोमेन को मान्य करता है, पथ उपसर्गों की जांच करता है और क्वेरी पैरामीटर्स को एक संरचित ValidatedAppRoute ऑब्जेक्ट में सैनिटाइज़ करता है।
  • CustomSchemeValidator अधिकृत कस्टम स्कीम्स (myapp) को सत्यापित करता है, अनुमति प्राप्त होस्ट (open, product, event) को मान्य करता है, और क्वेरी मानों को सैनिटाइज़ करता है।

OpoInstall को एट्रिब्यूशन और आस्थगित पैरामीटर रिकवरी के लिए एप्लिकेशन-स्वामित्व वाली राउटिंग परत के साथ एकीकृत किया जा सकता है। व्यापक एकीकरण गाइड के लिए SDK एकीकरण दस्तावेज़ीकरण की समीक्षा करें।

नीचे दिया गया तकनीकी कार्यान्वयन दिखाता है कि Swift में एक सुरक्षित WKNavigationDelegate को कैसे कॉन्फ़िगर किया जाए:

// iOS: सख्त WKNavigationDelegate राउटिंग और फ्रेम सुरक्षा के साथ CustomWebViewController
// संदर्भ एकीकरण उदाहरण। अपनी तैनात आर्किटेक्चर के खिलाफ विधि हस्ताक्षरों और डोमेन मैपिंग को सत्यापित करें।
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. सुरक्षित नेविगेशन नीति इंटरसेप्शन के साथ WKWebView को होस्ट करने वाला UIViewController
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: iframe हाइजैकिंग को रोकने के लिए शुरुआती फ्रेम सीमा (sourceFrame) लागू करें
        if !navigationAction.sourceFrame.isMainFrame {
            let scheme = url.scheme?.lowercased() ?? ""
            if scheme == "http" || scheme == "https" {
                decisionHandler(.allow) // मानक HTTP(S) सबफ्रेम नेविगेशन की अनुमति दें
            } else {
                decisionHandler(.cancel) // सबफ्रेम्स/iframes से गैर-वेब स्कीम्स को दबाएं
            }
            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) // आंतरिक रूप से रूट करने के लिए इन-वेबव्यू लोडिंग रद्द करें
            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) // अनियंत्रित स्कीम त्रुटियों को रोकने के लिए इन-वेबव्यू लोडिंग रद्द करें
            return
        }

        // सुरक्षा जांच 4: बाहरी गंतव्यों और नई-विंडो (target="_blank") अनुरोधों को संभालें
        if scheme == "http" || scheme == "https" {
            let host = url.host?.lowercased() ?? ""
            
            // सत्यापित पार्टनर यूनिवर्सल लिंक्स को स्पष्ट-लिंक नीति के साथ बाहरी ऐप को सौंपें
            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 शून्य है (नया विंडो अनुरोध), तो वर्तमान 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 व्यू कंट्रोलर ट्रांज़िशन निष्पादित करें
    }
}

थ्रेड-सुरक्षित निष्पादन: यह सुनिश्चित करना कि UI ट्रांज़िशन Main Actor पर निष्पादित हों

वर्तमान Swift कंकरेंसी मॉडल में, WKNavigationDelegate कॉलबैक main-actor आइसोलेटेड हैं। एप्लिकेशन राउटिंग और व्यू कंट्रोलर ट्रांज़िशन main-actor पर निष्पादित होते हैं, जो नेटिव नेविगेशन वर्कफ़्लो में थ्रेड सुरक्षा बनाए रखते हैं।

WKWebView डीप लिंक नेविगेशन त्रुटियां और डायग्नोस्टिक मैट्रिक्स

व्यापक iOS WKWebView डीप लिंकिंग ट्रबलशूटिंग गाइड

नीचे दिया गया मैट्रिक्स iOS WKWebView के भीतर डीप लिंक्स और कस्टम स्कीम्स को प्रबंधित करते समय आने वाली सामान्य विफलता मोड की रूपरेखा देता है, साथ ही प्राथमिक मूल कारण और अनुशंसित इंजीनियरिंग सुधार शामिल हैं:

त्रुटि सिग्नेचर / लक्षण प्राथमिक मूल कारण लागू iOS संस्करण डायग्नोस्टिक चेकपॉइंट अनुशंसित सुधार
यूनिवर्सल लिंक वेब में लोड होता है ऐप-स्वामित्व वाला डोमेन इंटरसेप्ट नहीं हुआ iOS 9+ decidePolicyForNavigationAction अनहैंडल्ड होस्ट डोमेन को इंटरसेप्ट करें, पथ पार्स करें, आंतरिक रूप से रूट करें, .cancel
स्व-डोमेन लिंक रूट करने में विफल स्वयं के डोमेन पर UIApplication.open कॉल करना iOS 9+ UIApplication.shared.open स्वयं के होस्ट पर कॉल किया गया बाहरी स्व-ओपन से बचें; सीधे आंतरिक राउटर पर रूट करें
कस्टम स्कीम चुपचाप विफल WebKit द्वारा गैर-HTTP प्रोटोकॉल अपरिचित iOS 9+ स्कीम UIApplication को नहीं सौंपी गई डेलिगेट में स्कीम इंटरसेप्ट करें, अलाउलिस्ट मान्य करें, UIApplication के माध्यम से खोलें
Iframe प्रोटोकॉल हाइजैकिंग सबफ्रेम द्वारा बाहरी कस्टम स्कीम को ट्रिगर करना iOS 9+ sourceFrame.isMainFrame अनचेक्ड if !sourceFrame.isMainFrame के साथ गार्ड करें और गैर-वेब स्कीम्स को दबाएं
UI हैंडऑफ़ चेतावनी या ट्रांज़िशन समस्या UI ट्रांज़िशन मेन थ्रेड के बाहर निष्पादित iOS 9+ मेन-एक्टर डिस्पैच गायब आंतरिक राउटर और व्यू कंट्रोलर ट्रांज़िशन के लिए मेन-एक्टर निष्पादन सुनिश्चित करें

अक्सर पूछे जाने वाले प्रश्न (FAQ)

डेवलपर्स WKWebView में यूनिवर्सल लिंक्स को कैसे इंटरसेप्ट कर सकते हैं?
डेवलपर्स `WKNavigationDelegate` लागू करते हैं और `decidePolicyForNavigationAction` के भीतर आने वाले URLs का निरीक्षण करते हैं। यदि URL ऐप-स्वामित्व वाले गंतव्य से मेल खाता है, तो डेलिगेट `.cancel` के साथ इन-वेबव्यू नेविगेशन रद्द कर देता है और सत्यापित मापदंडों को सीधे एप्लिकेशन के आंतरिक राउटर पर पास कर देता है।
क्या मैं WKWebView से अपने स्वयं के ऐप को लॉन्च करने के लिए UIApplication.shared.open का उपयोग कर सकता हूँ?
Apple दस्तावेज़ीकरण निर्दिष्ट करता है कि होस्ट एप्लिकेशन के अपने एसोसिएटेड डोमेन की ओर इशारा करने वाले यूनिवर्सल लिंक पर `UIApplication.shared.open()` कॉल करने से लिंक यूनिवर्सल लिंक के रूप में ऐप में नहीं खुलेगा। स्वयं-डोमेन लिंक्स के लिए, एप्लिकेशन को वेबव्यू नेविगेशन रद्द करना चाहिए और अपने आंतरिक नेविगेशन राउटर को सीधे लागू करना चाहिए।
मैं WKWebView में एम्बेडेड iframes को बाहरी ऐप लॉन्च को ट्रिगर करने से कैसे रोकूँ?
Iframe हाइजैकिंग को रोकने के लिए, `decidePolicyForNavigationAction` के भीतर `navigationAction.sourceFrame.isMainFrame` की जांच करें। यदि `isMainFrame` `false` है, तो `.allow` के साथ मानक HTTP(S) सबफ्रेम नेविगेशन की अनुमति दें, लेकिन तीसरे पक्ष के iframes को अनचाहे बाहरी लॉन्च निष्पादित करने से रोकने के लिए गैर-वेब कस्टम स्कीम्स को `.cancel` के साथ रद्द करें।

सारांश और निर्णय ढांचा

iOS WKWebView के भीतर यूनिवर्सल लिंक्स और कस्टम स्कीम्स को संभालना WebKit के वेब रेंडरिंग कंटेनर और नेटिव UIKit नेविगेशन लाइफसाइकिल के बीच की सीमा को पाटने का काम करता है। डिफ़ॉल्ट नेविगेशन नीतियों पर निर्भर रहने से तब हैंडऑफ़ में बाधा आ सकती है जब एप्लिकेशन-स्वामित्व वाले राउटिंग तर्क की आवश्यकता होती है।

एक मजबूत WKNavigationDelegate लागू करके जो फ्रेम सीमाओं को सत्यापित करता है, बाहरी हैंडऑफ़ पर रूढ़िवादी लिंक-सक्रियण नीतियां लागू करता है, सख्त मार्ग वैलिडेटर्स के माध्यम से आंतरिक एसोसिएटेड डोमेन को पार्स करता है, और बाहरी लक्ष्यों को सुरक्षित रूप से UIApplication.shared.open को सौंपता है, इंजीनियरिंग टीमें Iframe प्रोटोकॉल हाइजैकिंग से बचाव करते हुए नियंत्रित नेविगेशन बनाए रखती हैं।

नेटिव iOS डीप लिंकिंग और पैरामीटर राउटिंग आर्किटेक्चर का पता लगाने के लिए, SDK एकीकरण दस्तावेज़ीकरण देखें।

संबंधित सामग्री

Share this article