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

Firebase Dynamic Links Builder API की मदद से, छोटे या लंबे Dynamic Links बनाए जा सकते हैं. यह एपीआई, Dynamic Link या Dynamic Link पैरामीटर वाले ऑब्जेक्ट को स्वीकार करता है. साथ ही, यहां दिए गए उदाहरणों की तरह यूआरएल दिखाता है:

https://example.com/link/WXYZ
https://example.page.link/WXYZ

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

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

Firebase और Dynamic Links SDK टूल सेट अप करना

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

1. Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलें. इसके बाद, File > Add Packages पर जाएं.
2. प्रॉम्प्ट मिलने पर, Firebase Apple प्लैटफ़ॉर्म SDK टूल की रिपॉज़िटरी जोड़ें:

  https://github.com/firebase/firebase-ios-sdk.git

3. Dynamic Links लाइब्रेरी चुनें.
4. अपने टारगेट की बिल्ड सेटिंग के अन्य लिंकर फ़्लैग सेक्शन में, -ObjC फ़्लैग जोड़ें.
5. Dynamic Links का बेहतर अनुभव पाने के लिए, हमारा सुझाव है कि आप अपने Firebase प्रोजेक्ट में Google Analytics को चालू करें. साथ ही, अपने ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल जोड़ें. आपके पास आईडीएफ़ए कलेक्शन के बिना या आईडीएफ़ए कलेक्शन वाली लाइब्रेरी चुनने का विकल्प है. Google Analytics for Firebase SDK में मॉड्यूल के नए संगठन के बारे में अक्सर पूछे जाने वाले सवाल देखें.
6. इसके बाद, Xcode बैकग्राउंड में आपकी डिपेंडेंसी से जुड़ी समस्या को हल करना और उन्हें डाउनलोड करना शुरू कर देगा.

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

1. Firebase कंसोल में, Dynamic Links सेक्शन खोलें.

2. अगर आपने अब तक सेवा की शर्तें स्वीकार नहीं की हैं और अपने Dynamic Links के लिए यूआरआई प्रीफ़िक्स सेट नहीं किया है, तो पूछे जाने पर ऐसा करें.

   अगर आपके पास पहले से ही Dynamic Links यूआरआई प्रीफ़िक्स है, तो उसे नोट कर लें. प्रोग्राम के हिसाब से Dynamic Links बनाते समय, आपको यह जानकारी देनी होगी.

   

3. सुझाव: अपने डीप लिंक और फ़ॉलबैक लिंक में, अनुमति वाले यूआरएल पैटर्न की जानकारी दें. ऐसा करने से, बिना अनुमति वाली इकाइयां Dynamic Links नहीं बना पाती हैं. ये इकाइयां, आपके डोमेन से उन साइटों पर रीडायरेक्ट करती हैं जिन पर आपका कंट्रोल नहीं होता. यूआरएल के कुछ पैटर्न को अनुमति दें देखें.

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

   पुष्टि करें कि आपके Firebase प्रोजेक्ट को सही तरीके से कॉन्फ़िगर किया गया हो, ताकि आपके iOS ऐप्लिकेशन में Dynamic Links का इस्तेमाल किया जा सके. इसके लिए, अपने Dynamic Links डोमेन पर होस्ट की गई apple-app-site-association फ़ाइल खोलें. Firebase, डोमेन के रूट और .well-known सबडायरेक्ट्री से apple-app-site-association फ़ाइल उपलब्ध कराएगा. उदाहरण के लिए:

       https://example.com/apple-app-site-association
       https://example.com/.well-known/apple-app-site-association
       

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

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

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

अपने ऐप्लिकेशन में Firebase जोड़ना

1. FirebaseCore मॉड्यूल को अपने UIApplicationDelegate में इंपोर्ट करें. साथ ही, ऐसे अन्य 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;
   // ...
         

2. अपने ऐप्लिकेशन डेलिगेट के 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];

3. अगर 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()
         }
       }
     }
   }
         

Firebase कंसोल का इस्तेमाल करना

अगर आपको टेस्टिंग के लिए या अपनी मार्केटिंग टीम के लिए, एक Dynamic Link जनरेट करना है, ताकि वे आसानी से ऐसा लिंक बना सकें जिसका इस्तेमाल सोशल मीडिया पोस्ट जैसी चीज़ों में किया जा सके, तो सबसे आसान तरीका यह होगा कि आप Firebase कंसोल पर जाएं और सिलसिलेवार तरीके से फ़ॉर्म भरकर, मैन्युअल तरीके से लिंक बनाएं.

iOS Builder API का इस्तेमाल करना

iOS Builder API का इस्तेमाल करके, पैरामीटर से Dynamic Links बनाए जा सकते हैं या किसी लंबे Dynamic Link को छोटा किया जा सकता है.

पैरामीटर से Dynamic Link बनाना

Dynamic Link बनाने के लिए, नया DynamicLinkComponents ऑब्जेक्ट बनाएं और ऑब्जेक्ट की संबंधित प्रॉपर्टी सेट करके, Dynamic Link पैरामीटर तय करें. इसके बाद, ऑब्जेक्ट की url प्रॉपर्टी से लंबा लिंक पाएं या shorten() को कॉल करके छोटा लिंक पाएं.

नीचे दिए गए उदाहरण में, Dynamic Link से https://www.example.com/my-page तक का एक लंबा यूआरएल बनाया गया है. यह यूआरएल, iOS पर आपके iOS ऐप्लिकेशन और Android पर com.example.android ऐप्लिकेशन के साथ खुलता है:

guard let link = URL(string: "https://www.example.com/my-page") else { return }
let dynamicLinksDomainURIPrefix = "https://example.com/link"
let linkBuilder = DynamicLinkComponents(link: link, domainURIPrefix: dynamicLinksDomainURIPRefix)
linkBuilder.iOSParameters = DynamicLinkIOSParameters(bundleID: "com.example.ios")
linkBuilder.androidParameters = DynamicLinkAndroidParameters(packageName: "com.example.android")

guard let longDynamicLink = linkBuilder.url else { return }
print("The long URL is: \(longDynamicLink)")

NSURL *link = [[NSURL alloc] initWithString:@"https://www.example.com/my-page"];
NSString *dynamicLinksDomainURIPrefix = @"https://example.com/link";
FIRDynamicLinkComponents *linkBuilder = [[FIRDynamicLinkComponents alloc]
                                         initWithLink:link
                                               domainURIPrefix:dynamicLinksDomainURIPrefix];
linkBuilder.iOSParameters = [[FIRDynamicLinkIOSParameters alloc]
                             initWithBundleID:@"com.example.ios"];
linkBuilder.androidParameters = [[FIRDynamicLinkAndroidParameters alloc]
                                 initWithPackageName:@"com.example.android"];

NSLog(@"The long URL is: %@", linkBuilder.url);

शॉर्ट Dynamic Link बनाने के लिए, उसी तरीके से DynamicLinkComponents बनाएं और फिर shorten() को कॉल करें.

छोटा लिंक बनाने के लिए, नेटवर्क कॉल की ज़रूरत होती है. इसलिए, सीधे लिंक दिखाने के बजाय, shorten() एक कंप्लीशन हैंडलर को स्वीकार करता है. अनुरोध पूरा होने पर, इसे कॉल किया जाता है. उदाहरण के लिए:

linkBuilder.shorten() { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

[linkBuilder shortenWithCompletion:^(NSURL * _Nullable shortURL,
                                     NSArray<NSString *> * _Nullable warnings,
                                     NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];
      

डिफ़ॉल्ट रूप से, छोटे Dynamic Links 17-वर्ण वाले लिंक सफ़िक्स के साथ जनरेट होते हैं. इससे, किसी व्यक्ति के लिए मान्य Dynamic Link का अनुमान लगाना बेहद मुश्किल हो जाता है. अगर आपके इस्तेमाल के उदाहरण के लिए, किसी व्यक्ति के छोटे लिंक का अनुमान लगाने से कोई नुकसान नहीं होता है, तो हो सकता है कि आप ऐसे सफ़िक्स जनरेट करना चाहें जो यूनीक होने के लिए ज़रूरी हों. इसके लिए, dynamicLinkComponentsOptions प्रॉपर्टी को सेट करें:

linkBuilder.options = DynamicLinkComponentsOptions()
linkBuilder.options.pathLength = .short
linkBuilder.shorten() { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

linkBuilder.dynamicLinkComponentsOptions = [[FIRDynamicLinkComponentsOptions alloc] init];
linkBuilder.dynamicLinkComponentsOptions.pathLength = FIRShortDynamicLinkPathLengthShort;
[linkBuilder shortenWithCompletion:^(NSURL * _Nullable shortURL,
                                     NSArray<NSString *> * _Nullable warnings,
                                     NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];
      

Dynamic Link पैरामीटर

Dynamic Link Builder API का इस्तेमाल करके, Dynamic Links बनाए जा सकते हैं. इसके लिए, इनमें से किसी भी पैरामीटर का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, एपीआई का संदर्भ देखें.

यहां दिए गए उदाहरण में, कई सामान्य पैरामीटर सेट करके Dynamic Link बनाया गया है:

guard let link = URL(string: "https://www.example.com/my-page") else { return }
let dynamicLinksDomainURIPrefix = "https://example.com/link"
let linkBuilder = DynamicLinkComponents(link: link, domainURIPRefix: dynamicLinksDomainURIPrefix)

linkBuilder.iOSParameters = DynamicLinkIOSParameters(bundleID: "com.example.ios")
linkBuilder.iOSParameters.appStoreID = "123456789"
linkBuilder.iOSParameters.minimumAppVersion = "1.2.3"

linkBuilder.androidParameters = DynamicLinkAndroidParameters(packageName: "com.example.android")
linkBuilder.androidParameters.minimumVersion = 123

linkBuilder.analyticsParameters = DynamicLinkGoogleAnalyticsParameters(source: "orkut",
                                                                       medium: "social",
                                                                       campaign: "example-promo")

linkBuilder.iTunesConnectParameters = DynamicLinkItunesConnectAnalyticsParameters()
linkBuilder.iTunesConnectParameters.providerToken = "123456"
linkBuilder.iTunesConnectParameters.campaignToken = "example-promo"

linkBuilder.socialMetaTagParameters = DynamicLinkSocialMetaTagParameters()
linkBuilder.socialMetaTagParameters.title = "Example of a Dynamic Link"
linkBuilder.socialMetaTagParameters.descriptionText = "This link works whether the app is installed or not!"
linkBuilder.socialMetaTagParameters.imageURL = "https://www.example.com/my-image.jpg"

guard let longDynamicLink = linkBuilder.url else { return }
print("The long URL is: \(longDynamicLink)")

NSURL *link = [[NSURL alloc] initWithString:@"https://www.example.com/my-page"];
NSString *dynamicLinksDomainURIPrefix = @"https://example.com/link";
FIRDynamicLinkComponents *linkBuilder = [[FIRDynamicLinkComponents alloc]
                                         initWithLink:link
                                         domainURIPrefix:dynamicLinksDomainURIPrefix];

linkBuilder.iOSParameters = [[FIRDynamicLinkIOSParameters alloc]
                             initWithBundleID:@"com.example.ios"];
linkBuilder.iOSParameters.appStoreID = @"123456789";
linkBuilder.iOSParameters.minimumAppVersion = @"1.2.3";

linkBuilder.androidParameters = [[FIRDynamicLinkAndroidParameters alloc]
                                 initWithPackageName:@"com.example.android"];
linkBuilder.androidParameters.minimumVersion = 123;

linkBuilder.analyticsParameters = [[FIRDynamicLinkGoogleAnalyticsParameters alloc]
                                   initWithSource:@"orkut"
                                           medium:@"social"
                                         campaign:@"example-promo"];

linkBuilder.iTunesConnectParameters = [[FIRDynamicLinkItunesConnectAnalyticsParameters alloc] init];
linkBuilder.iTunesConnectParameters.providerToken = @"123456";
linkBuilder.iTunesConnectParameters.campaignToken = @"example-promo";

linkBuilder.socialMetaTagParameters = [[FIRDynamicLinkSocialMetaTagParameters alloc] init];
linkBuilder.socialMetaTagParameters.title = @"Example of a Dynamic Link";
linkBuilder.socialMetaTagParameters.descriptionText = @"This link works whether the app is installed or not!";
linkBuilder.socialMetaTagParameters.imageURL = @"https://www.example.com/my-image.jpg";

NSLog(@"The long URL is: %@", linkBuilder.url);

इन ऑब्जेक्ट और प्रॉपर्टी की मदद से, Dynamic Link पैरामीटर सेट किए जा सकते हैं:

https://example.com/link
https://example.page.link

लंबे Dynamic Link को छोटा करना

लंबे Dynamic Link को छोटा करने के लिए, लंबे Dynamic Link को shortenURL(url:options:) में पास करें. साथ ही, अगर आपको छोटे सफ़िक्स वाला लिंक जनरेट करना है, तो DynamicLinkComponentsOptions ऑब्जेक्ट भी पास करें:

DynamicLinkComponents.shortenURL(url: longLinkUrl, options: nil) { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

[FIRDynamicLinkComponents shortenURL:longLinkUrl
                             options:nil
                          completion:^(NSURL * _Nullable shortURL,
                                       NSArray<NSString *> * _Nullable warnings,
                                       NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];

Dynamic Links के लिए कस्टम यूआरएल स्कीम तय करना

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

हालांकि, जो डेवलपर पहले से ही अन्य कामों के लिए कस्टम यूआरएल स्कीम का इस्तेमाल कर रहे हैं वे अपने Dynamic Links के लिए भी इसी कस्टम यूआरएल स्कीम का इस्तेमाल कर सकते हैं. अगर आप इस स्थिति में हैं, तो इन चरणों का पालन करके अपने Firebase Dynamic Links के लिए कोई दूसरी यूआरएल स्कीम तय की जा सकती है:

1. अपना ऐप्लिकेशन सेट अप करते समय, पक्का करें कि आपने डिफ़ॉल्ट यूआरएल स्कीम तय की हो. इसका इस्तेमाल, आपके ऐप्लिकेशन को FirebaseApp शेयर किए गए इंस्टेंस को कॉन्फ़िगर करने से पहले करना होगा:

   Swift

   ध्यान दें: Firebase का यह प्रॉडक्ट macOS, Mac Catalyst, tvOS या watchOS टारगेट पर उपलब्ध नहीं है.

   func application(_ application: UIApplication,
                    didFinishLaunchingWithOptions launchOptions: [UIApplication
                      .LaunchOptionsKey: Any]?) -> Bool {
     // Set deepLinkURLScheme to the custom URL scheme you defined in your
     // Xcode project.
     FirebaseOptions.defaultOptions()?.deepLinkURLScheme = customURLScheme
     FirebaseApp.configure()
   
     return true
   }

   Objective-C

   ध्यान दें: Firebase का यह प्रॉडक्ट macOS, Mac Catalyst, tvOS या watchOS टारगेट पर उपलब्ध नहीं है.

   - (BOOL)application:(UIApplication *)application
       didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
     // Set deepLinkURLScheme to the custom URL scheme you defined in your
     // Xcode project.
     [FIROptions defaultOptions].deepLinkURLScheme = CUSTOM_URL_SCHEME;
     [FIRApp configure];
   
     return YES;
   }

2. जब भी कोई Dynamic Link बनाया जाता है, तो आपको कस्टम यूआरएल स्कीम की जानकारी देनी होगी. यह वह स्कीम होती है जिसका इस्तेमाल आपका ऐप्लिकेशन करता है. ऐसा करने के लिए, Firebase कंसोल का इस्तेमाल करें. इसके लिए, Builder API में customScheme सेट करें, अपने यूआरएल में ius पैरामीटर की जानकारी दें या REST API को iosCustomScheme पैरामीटर भेजें

अगले चरण

अब आपने Dynamic Links बना लिया है, तो आपको Dynamic Links पाने के लिए अपना ऐप्लिकेशन सेट अप करना होगा. साथ ही, उपयोगकर्ताओं को आपके ऐप्लिकेशन में सही जगह पर भेजना होगा.

अपने ऐप्लिकेशन में Dynamic Links पाने के लिए, iOS, Android, C++, और Unity के लिए दस्तावेज़ देखें.