आपके ऐप को खोलने में विफल रहने वाले यूनिवर्सल लिंक्स को डीबग करने में एक व्यवस्थित दृष्टिकोण शामिल होता है, जिसमें आपके ऐप की कॉन्फ़िगरेशन और आपके वेब सर्वर सेटअप दोनों की जाँच की जाती है। यहाँ एक व्यापक गाइड दी गई है: 1. बुनियादी सेटअप और परीक्षण वातावरण सत्यापित करें वास्तविक डिवाइस, सिम्युलेटर नहीं: यूनिवर्सल लिंक्स अक्सर सिम्युलेटर पर अलग तरह से काम करते हैं। हमेशा किसी भौतिक iOS डिवाइस पर परीक्षण करें। ऐप को हटाएँ और फिर से इंस्टॉल करें: बदलाव करने के बाद, हमेशा अपने डिवाइस से ऐप को हटा दें और उसे फिर से इंस्टॉल करें। यह iOS को apple-app-site-association (AASA) फ़ाइल को फिर से डाउनलोड करने के लिए मजबूर करता है। उपयुक्त स्रोतों से परीक्षण करें: यदि आप यूनिवर्सल लिंक को सीधे ब्राउज़र के URL बार में पेस्ट करते हैं तो वे काम नहीं करेंगे। Notes, Mail, iMessage, या Slack जैसे अन्य ऐप्स से लिंक पर टैप करके परीक्षण करें। इंस्टाग्राम, ट्विटर, या फेसबुक जैसे कुछ ऐप्स सीधे यूनिवर्सल लिंक का समर्थन नहीं कर सकते हैं। 2. apple-app-site-association (AASA) फ़ाइल की जाँच करें AASA फ़ाइल यूनिवर्सल लिंक्स के लिए महत्वपूर्ण है। iOS आपके वेब सर्वर से इस फ़ाइल को डाउनलोड करता है ताकि यह निर्धारित किया जा सके कि आपका ऐप कौन से लिंक संभाल सकता है। फ़ाइल का स्थान: AASA फ़ाइल को https://yourdomain.com/apple-app-site-association या https://yourdomain.com/.well-known/apple-app-site-association पर होस्ट किया जाना चाहिए। HTTPS और कोई रीडायरेक्ट नहीं: फ़ाइल को HTTPS पर और किसी भी 3xx रीडायरेक्ट के बिना परोसा जाना चाहिए। Content-Type हेडर: सुनिश्चित करें कि सर्वर AASA फ़ाइल के लिए सही Content-Type हेडर लौटाता है। JSON वैधता: AASA फ़ाइल एक मान्य JSON होनी चाहिए और निर्दिष्ट स्कीमा का पालन करनी चाहिए। आप इसकी शुद्धता की जाँच करने के लिए ऑनलाइन वैलिडेटर (जैसे Branch.io का AASA वैलिडेटर) का उपयोग कर सकते हैं। appID और पथ: सत्यापित करें कि आपकी AASA फ़ाइल में appID आपके ऐप के टीम आईडी और बंडल पहचानकर्ता (जैसे, ABC123DEF.com.example.app) से मेल खाता है। साथ ही, सुनिश्चित करें कि paths ऐरे में उन URL पथों को सही ढंग से निर्दिष्ट किया गया है जिन्हें आपके ऐप को हैंडल करना चाहिए। सर्वर लॉग: यह पुष्टि करने के लिए अपने वेब सर्वर के HTTPS लॉग्स की जाँच करें कि जब आपका ऐप इंस्टॉल होता है तो iOS द्वारा AASA फ़ाइल डाउनलोड की जा रही है। 3. Xcode में ऐप कॉन्फ़िगरेशन एसोसिएटेड डोमेन्स एंटिटलमेंट: अपने Xcode प्रोजेक्ट में, "Signing & Capabilities" टैब पर जाएँ और सुनिश्चित करें कि "Associated Domains" सक्षम है। अपने डोमेन को applinks:yourdomain.com प्रारूप में जोड़ें। डिबग बनाम रिलीज़: यदि विकास में डिबगिंग कर रहे हैं, तो सुनिश्चित करें कि आप "साइनिंग और क्षमताएं" के डिबग संस्करण को संपादित कर रहे हैं। विकास में Apple यूनिवर्सल लिंक्स CDN को बायपास करने के लिए, अपने डिबग डोमेन को applinks:yourdomain.com?mode=developer जैसे प्रारूप में कॉन्फ़िगर करें। ऐप डेलिगेट/सीन डेलिगेट: सत्यापित करें कि आपके ऐप का AppDelegate (या iOS 13+ के लिए SceneDelegate) यूनिवर्सल लिंक्स के लिए आने वाले NSUserActivity ऑब्जेक्ट्स को संभालने के लिए application(_:continueUserActivity:restorationHandler:) मेथड को सही ढंग से लागू करता है। 4. डिवाइस-विशिष्ट डिबगिंग कंसोल लॉग: अपने डिवाइस को Xcode से कनेक्ट करें और कंसोल खोलें (Window > Devices and Simulators > [Your Device] > Open Console)। यह देखने के लिए कि आपका यूनिवर्सल लिंक रजिस्टर हुआ या नहीं, लॉग्स को "swcd" (Shared Web Credentials Daemon) के लिए फ़िल्टर करें। डेवलपर सेटिंग्स (iOS 13+): Settings > Privacy & Security > Developer Mode में "डेवलपर मोड" सक्षम करें। Settings > Developer > Universal Links में, "Associated Domains Development" को सक्षम करें। Universal Links अनुभाग में "Diagnostics" टूल का उपयोग करके अपना Universal Link URL दर्ज करें और जांचें कि यह आपके इंस्टॉल किए गए ऐप के लिए मान्य है या नहीं। डिवाइस को पुनः आरंभ करें: अपने डिवाइस को पुनः आरंभ करने से iOS यूनिवर्सल लिंक कैश साफ़ हो सकते हैं और समस्याएं हल हो सकती हैं। विभिन्न डिवाइसों/iOS संस्करणों पर परीक्षण करें: इससे डिवाइस-विशिष्ट कॉन्फ़िगरेशन समस्याओं को खारिज करने में मदद मिलती है। यूनिवर्सल लिंक को पुनः सक्षम करें: यदि कोई यूनिवर्सल लिंक पहले सफारी में खुला था, तो वह उस विशिष्ट लिंक के लिए अक्षम किया गया हो सकता है। Notes जैसे ऐप में लिंक को लंबे समय तक दबाएं और उसे फिर से सक्षम करने के लिए "Open in [Your App Name]" चुनें। यदि आप Safari में Smart App Banner देखते हैं, तो बैनर में "OPEN" पर टैप करने से भी Universal Links फिर से सक्षम हो सकते हैं। 5. उन्नत समस्या निवारण sysdiagnose लॉग: गहरी जानकारी के लिए, आप अपने iOS डिवाइस पर sysdiagnose लॉग (Settings > Privacy & Security > Analytics & Improvements > Analytics Data) एक्सेस कर सकते हैं। ये लॉग इस बारे में विस्तृत जानकारी प्रदान कर सकते हैं कि iOS आपके यूनिवर्सल लिंक को कैसे प्रोसेस कर रहा है। तृतीय-पक्ष उपकरण: अपनी वेबसाइट के विन्यास को सत्यापित करने के लिए Apple के ऐप सर्च API वैलिडेशन टूल या अन्य तृतीय-पक्ष वैलिडेटर जैसे उपकरणों का उपयोग करें। इन चरणों को व्यवस्थित रूप से अपनाकर, आप उन अधिकांश समस्याओं की पहचान कर सकते हैं और उन्हें हल कर सकते हैं जो आपके यूनिवर्सल लिंक को आपके ऐप को खोलने से रोक रही हैं।