iOS पर डाइनैमिक लिंक पाएं

आपने जो Firebase Dynamic Links बनाया है उसे पाने के लिए, आपको अपने ऐप्लिकेशन में Dynamic Links SDK टूल शामिल करना होगा. साथ ही, जब आपका ऐप्लिकेशन लोड हो, तब handleUniversalLink: और dynamicLinkFromCustomSchemeURL: मेथड को कॉल करना होगा, ताकि Dynamic Link में पास किया गया डेटा मिल सके.

ज़रूरी शर्तें

शुरू करने से पहले, पक्का करें कि आपने अपने iOS प्रोजेक्ट में Firebase जोड़ा हो.

Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift Package Manager का इस्तेमाल करें.

  1. Xcode में, अपने ऐप्लिकेशन प्रोजेक्ट को खोलें. इसके बाद, File > Add Packages पर जाएं.
  2. जब आपसे कहा जाए, तब Firebase Apple प्लैटफ़ॉर्म SDK टूल की रिपॉज़िटरी जोड़ें:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Dynamic Links लाइब्रेरी चुनें.
  5. टारगेट की बिल्ड सेटिंग के Other Linker Flags सेक्शन में -ObjC फ़्लैग जोड़ें.
  6. Dynamic Links का बेहतर तरीके से इस्तेमाल करने के लिए, हमारा सुझाव है कि आप अपने Firebase प्रोजेक्ट में Google Analytics चालू करें. साथ ही, अपने ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल जोड़ें. आपके पास, आईडीएफ़ए इकट्ठा करने की सुविधा के बिना या आईडीएफ़ए इकट्ठा करने की सुविधा के साथ लाइब्रेरी चुनने का विकल्प होता है. Firebase SDK के लिए Google Analytics में मॉड्यूल के नए संगठन के बारे में अक्सर पूछे जाने वाले सवाल देखें.
  7. इसके बाद, Xcode आपके पैकेज की डिपेंडेंसी से जुड़ी समस्या को हल करना शुरू कर देगा और उन्हें बैकग्राउंड में डाउनलोड करेगा.

अब, कॉन्फ़िगरेशन के कुछ चरण पूरे करें:

  1. Firebase कंसोल में, Dynamic Links सेक्शन खोलें. अगर आपसे सेवा की शर्तों को स्वीकार करने के लिए कहा जाता है, तो उन्हें स्वीकार करें.
  2. पक्का करें कि आपके ऐप्लिकेशन की सेटिंग में, ऐप्लिकेशन का App Store आईडी और ऐप्लिकेशन आईडी प्रीफ़िक्स दिया गया हो. अपने ऐप्लिकेशन की सेटिंग देखने और उनमें बदलाव करने के लिए, अपने Firebase प्रोजेक्ट के सेटिंग पेज पर जाएं और अपना iOS ऐप्लिकेशन चुनें.

    यह पुष्टि की जा सकती है कि आपके iOS ऐप्लिकेशन में Dynamic Links का इस्तेमाल करने के लिए, आपका Firebase प्रोजेक्ट सही तरीके से कॉन्फ़िगर किया गया है या नहीं. इसके लिए, यह यूआरएल खोलें:

    https://your_dynamic_links_domain/apple-app-site-association

    अगर आपका ऐप्लिकेशन कनेक्ट है, तो apple-app-site-association फ़ाइल में आपके ऐप्लिकेशन के ऐप्लिकेशन आईडी प्रीफ़िक्स और बंडल आईडी का रेफ़रंस होता है. उदाहरण के लिए:

    {"applinks":{"apps":[],"details":[{"appID":"1234567890.com.example.ios","paths":["NOT /_/*","/*"]}]}}

    अगर details फ़ील्ड खाली है, तो दोबारा जांच लें कि आपने अपने ऐप्लिकेशन आईडी का प्रीफ़िक्स डाला हो. ध्यान दें कि आपका ऐप्लिकेशन आईडी प्रीफ़िक्स, आपके टीम आईडी से अलग हो सकता है.

  3. ज़रूरी नहीं: Dynamic Links SDK टूल को iOS के क्लिपबोर्ड का इस्तेमाल करने से रोकें.

    डिफ़ॉल्ट रूप से, Dynamic Links SDK टूल, पोस्ट-इंस्टॉल डीप लिंक की विश्वसनीयता को बेहतर बनाने के लिए, क्लिपबोर्ड का इस्तेमाल करता है. पेस्टबोर्ड का इस्तेमाल करके, Dynamic Links यह पक्का कर सकता है कि जब कोई उपयोगकर्ता Dynamic Link खोलता है, लेकिन उसे पहले आपका ऐप्लिकेशन इंस्टॉल करना होता है, तो इंस्टॉल करने के बाद पहली बार ऐप्लिकेशन खोलने पर, उपयोगकर्ता तुरंत लिंक किए गए ओरिजनल कॉन्टेंट पर जा सके.

    हालांकि, इसका एक नुकसान यह है कि iOS 14 और उसके बाद के वर्शन पर, क्लिपबोर्ड का इस्तेमाल करने पर सूचना ट्रिगर होती है. इसलिए, जब उपयोगकर्ता पहली बार आपका ऐप्लिकेशन खोलते हैं और अगर क्लिपबोर्ड में कोई यूआरएल मौजूद होता है, तो उन्हें एक सूचना दिखेगी. इसमें बताया जाएगा कि आपके ऐप्लिकेशन ने क्लिपबोर्ड को ऐक्सेस किया है. इससे उपयोगकर्ताओं को भ्रम हो सकता है.

    इस सुविधा को बंद करने के लिए, अपने Xcode प्रोजेक्ट की Info.plist फ़ाइल में बदलाव करें. इसके बाद, FirebaseDeepLinkPasteboardRetrievalEnabled कुंजी को NO पर सेट करें.

  1. अपने ऐप्लिकेशन के Xcode प्रोजेक्ट के जानकारी टैब में, Dynamic Links के लिए इस्तेमाल किया जाने वाला नया यूआरएल टाइप बनाएं. Identifier फ़ील्ड को यूनीक वैल्यू पर सेट करें. साथ ही, URL scheme फ़ील्ड को बंडल आइडेंटिफ़ायर पर सेट करें. यह Dynamic Links की ओर से इस्तेमाल की जाने वाली डिफ़ॉल्ट यूआरएल स्कीम होती है.
  2. अपने ऐप्लिकेशन के Xcode प्रोजेक्ट के Capabilities टैब में जाकर, Associated Domains को चालू करें. इसके बाद, Associated Domains सूची में यह जोड़ें:
    applinks:your_dynamic_links_domain
  3. अगर आपको Dynamic Links को पूरी तरह से कस्टम डोमेन के साथ इस्तेमाल करना है, तो अपने Xcode प्रोजेक्ट की Info.plist फ़ाइल में, FirebaseDynamicLinksCustomDomains नाम की एक कुंजी बनाएं और उसे अपने ऐप्लिकेशन के Dynamic Links यूआरएल प्रीफ़िक्स पर सेट करें. उदाहरण के लिए:
    FirebaseDynamicLinksCustomDomains
    
      https://example.com/promos
      https://example.com/links/share
    
  4. अपने UIApplicationDelegate में FirebaseCore मॉड्यूल के साथ-साथ, ऐप्लिकेशन डेलिगेट इस्तेमाल करने वाले अन्य Firebase मॉड्यूल इंपोर्ट करें. उदाहरण के लिए, Cloud Firestore और Authentication का इस्तेमाल करने के लिए:

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Swift

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  5. अपने ऐप्लिकेशन डेलिगेट के application(_:didFinishLaunchingWithOptions:) तरीके में, शेयर किए गए इंस्टेंस FirebaseApp को कॉन्फ़िगर करें:

    SwiftUI

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  6. अगर SwiftUI का इस्तेमाल किया जा रहा है, तो आपको एक ऐप्लिकेशन डेलिगेट बनाना होगा. साथ ही, इसे UIApplicationDelegateAdaptor या NSApplicationDelegateAdaptor के ज़रिए अपनी App स्ट्रक्चर से जोड़ना होगा. आपको ऐप्लिकेशन के डेलिगेट स्विज़लिंग को भी बंद करना होगा. ज़्यादा जानकारी के लिए, SwiftUI के निर्देश देखें.

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  7. इसके बाद, application:continueUserActivity:restorationHandler: तरीके में, ऐप्लिकेशन पहले से इंस्टॉल होने पर, यूनिवर्सल लिंक के तौर पर मिले लिंक को मैनेज करें:

    Swift

    ध्यान दें: यह प्रॉडक्ट, macOS, Mac Catalyst, tvOS या watchOS टारगेट पर उपलब्ध नहीं है.
    func application(_ application: UIApplication, continue userActivity: NSUserActivity,
                     restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
      let handled = DynamicLinks.dynamicLinks()
        .handleUniversalLink(userActivity.webpageURL!) { dynamiclink, error in
          // ...
        }
    
      return handled
    }

    Objective-C

    ध्यान दें: यह प्रॉडक्ट, macOS, Mac Catalyst, tvOS या watchOS टारगेट पर उपलब्ध नहीं है.
    - (BOOL)application:(UIApplication *)application
    continueUserActivity:(nonnull NSUserActivity *)userActivity
     restorationHandler:
    #if defined(__IPHONE_12_0) && (__IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_12_0)
    (nonnull void (^)(NSArray<id> *_Nullable))restorationHandler {
    #else
        (nonnull void (^)(NSArray *_Nullable))restorationHandler {
    #endif  // __IPHONE_12_0
      BOOL handled = [[FIRDynamicLinks dynamicLinks] handleUniversalLink:userActivity.webpageURL
                                                              completion:^(FIRDynamicLink * _Nullable dynamicLink,
                                                                           NSError * _Nullable error) {
                                                                // ...
                                                              }];
      return handled;
    }
  8. आखिर में, application:openURL:options: आपके ऐप्लिकेशन के कस्टम यूआरएल स्कीम से मिले लिंक हैंडल करें. इस तरीके को तब कॉल किया जाता है, जब आपका ऐप्लिकेशन इंस्टॉल होने के बाद पहली बार खोला जाता है.

    अगर आपके ऐप्लिकेशन के पहले लॉन्च पर Dynamic Link नहीं मिलता है, तो इस तरीके को DynamicLink के url को nil पर सेट करके कॉल किया जाएगा. इससे पता चलता है कि SDK टूल को मैच करने वाला कोई भी Dynamic Link नहीं मिला.

    Swift

    ध्यान दें: यह प्रॉडक्ट, macOS, Mac Catalyst, tvOS या watchOS टारगेट पर उपलब्ध नहीं है.
    @available(iOS 9.0, *)
    func application(_ app: UIApplication, open url: URL,
                     options: [UIApplication.OpenURLOptionsKey: Any]) -> Bool {
      return application(app, open: url,
                         sourceApplication: options[UIApplication.OpenURLOptionsKey
                           .sourceApplication] as? String,
                         annotation: "")
    }
    
    func application(_ application: UIApplication, open url: URL, sourceApplication: String?,
                     annotation: Any) -> Bool {
      if let dynamicLink = DynamicLinks.dynamicLinks().dynamicLink(fromCustomSchemeURL: url) {
        // Handle the deep link. For example, show the deep-linked content or
        // apply a promotional offer to the user's account.
        // ...
        return true
      }
      return false
    }

    Objective-C

    ध्यान दें: यह प्रॉडक्ट, macOS, Mac Catalyst, tvOS या watchOS टारगेट पर उपलब्ध नहीं है.
    - (BOOL)application:(UIApplication *)app
                openURL:(NSURL *)url
                options:(NSDictionary *)options {
      return [self application:app
                       openURL:url
             sourceApplication:options[UIApplicationOpenURLOptionsSourceApplicationKey]
                    annotation:options[UIApplicationOpenURLOptionsAnnotationKey]];
    }
    
    - (BOOL)application:(UIApplication *)application
                openURL:(NSURL *)url
      sourceApplication:(NSString *)sourceApplication
             annotation:(id)annotation {
      FIRDynamicLink *dynamicLink = [[FIRDynamicLinks dynamicLinks] dynamicLinkFromCustomSchemeURL:url];
    
      if (dynamicLink) {
        if (dynamicLink.url) {
          // Handle the deep link. For example, show the deep-linked content,
          // apply a promotional offer to the user's account or show customized onboarding view.
          // ...
        } else {
          // Dynamic link has empty deep link. This situation will happens if
          // Firebase Dynamic Links iOS SDK tried to retrieve pending dynamic link,
          // but pending link is not available for this device/App combination.
          // At this point you may display default onboarding view.
        }
        return YES;
      }
      return NO;
    }