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

Firebase Dynamic Links बिल्डर एपीआई की मदद से, छोटे या लंबे 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 में, अपना ऐप्लिकेशन प्रोजेक्ट खोलकर, फ़ाइल > पैकेज जोड़ें पर जाएं.
2. जब कहा जाए, तब Firebase के Apple प्लैटफ़ॉर्म के SDK टूल का रिपॉज़िटरी जोड़ें:

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

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

अब, कॉन्फ़िगरेशन के लिए यह तरीका अपनाएं:

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

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

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

   

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

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

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

       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. अपने 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;
   // ...
         

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 कंसोल का इस्तेमाल करना

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

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

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

पैरामीटर से 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 को shortenURL(url:options:) के साथ-साथ DynamicLinkComponentsOptions ऑब्जेक्ट में पास करें:Dynamic Link

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 कंसोल में जाकर, बिल्डर एपीआई में customScheme सेट करें, अपने यूआरएल में ius पैरामीटर डालें या iosCustomScheme पैरामीटर को REST API पर भेजें

अगले चरण

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

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