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

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

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

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

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

Firebase और डाइनैमिक लिंक SDK टूल सेट अप करना

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

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

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

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

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

1. Firebase कंसोल में, डाइनैमिक लिंक सेक्शन खोलें.

2. अगर आपने पहले से सेवा की शर्तें स्वीकार नहीं की हैं और अपने डाइनैमिक लिंक के लिए यूआरआई प्रीफ़िक्स सेट किया है, तो निर्देश मिलने पर यह तरीका अपनाएं.

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

   

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

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

   अपने डाइनैमिक लिंक डोमेन पर होस्ट की गई apple-app-site-association फ़ाइल को खोलकर, पुष्टि करें कि आपका Firebase प्रोजेक्ट, iOS ऐप्लिकेशन में डाइनैमिक लिंक इस्तेमाल करने के लिए सही तरीके से कॉन्फ़िगर किया गया है. 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 और पुष्टि करने की सुविधा का इस्तेमाल करने के लिए:

   स्विफ़्टयूआई

   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 शेयर किए गए इंस्टेंस को कॉन्फ़िगर करें:

   स्विफ़्टयूआई

   // 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 के निर्देश देखें.

   स्विफ़्टयूआई

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

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

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

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

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

पैरामीटर से डाइनैमिक लिंक बनाना

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

यहां दिए गए छोटे से उदाहरण से, 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);

छोटा डाइनैमिक लिंक बनाने के लिए, इसी तरह 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);
}];
      

डिफ़ॉल्ट रूप से, 17 वर्णों के लिंक के सफ़िक्स के साथ छोटे डाइनैमिक लिंक जनरेट होते हैं. इस वजह से, किसी मान्य डाइनैमिक लिंक का अनुमान लगाना मुश्किल हो जाता है. अगर आपके इस्तेमाल के उदाहरण में, छोटे लिंक का अनुमान लगाने में कोई नुकसान नहीं हुआ है, तो हो सकता है कि आप सिर्फ़ उन सफ़िक्स को जनरेट करना चाहें जो यूनीक होने के लिए ज़रूरी हों. ऐसा करने के लिए, 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);
}];
      

डाइनैमिक लिंक पैरामीटर

डाइनैमिक लिंक बनाने के लिए, इस्तेमाल किए जा सकने वाले किसी भी पैरामीटर के साथ डाइनैमिक लिंक बनाने के लिए, डाइनैमिक लिंक बिल्डर एपीआई का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, एपीआई का रेफ़रंस देखें.

यह उदाहरण कई सामान्य पैरामीटर सेट वाला डाइनैमिक लिंक बनाता है:

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);

डाइनैमिक लिंक पैरामीटर को नीचे दिए गए ऑब्जेक्ट और प्रॉपर्टी के साथ सेट किया जा सकता है:

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

लंबे डाइनैमिक लिंक को छोटा करना

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

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);
}];

डाइनैमिक लिंक के लिए कस्टम यूआरएल स्कीम तय करना

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

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

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. कोई भी डाइनैमिक लिंक बनाने पर, आपको अपने ऐप्लिकेशन में इस्तेमाल की जाने वाली कस्टम यूआरएल स्कीम बतानी होगी. Firebase कंसोल से यह काम किया जा सकता है. इसके लिए, Builder API में customScheme सेट करना, अपने यूआरएल में ius पैरामीटर की जानकारी देना या REST API को iosCustomScheme पैरामीटर भेजना

अगले चरण

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

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