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

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

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

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

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

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

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

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

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

3. Dynamic Links लाइब्रेरी चुनें.
4. अपने टारगेट की बिल्ड सेटिंग के अन्य लिंकर फ़्लैग सेक्शन में -ObjC फ़्लैग जोड़ें.
5. Dynamic Links के साथ बेहतर अनुभव के लिए, हमारा सुझाव है कि Google Analytics को चालू किया जा रहा है जोड़ना होगा. साथ ही, अपने ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल जोड़ना होगा. आप बिना IDFA कलेक्शन वाली या IDFA कलेक्शन वाली लाइब्रेरी चुनें.
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 apple-app-site-association फ़ाइल जिसे आपके Dynamic Links डोमेन. 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. अपने इसमें 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. कॉन्फ़िगर करें FirebaseApp आपके ऐप्लिकेशन डेलिगेट के में शेयर किया गया इंस्टेंस application(_:didFinishLaunchingWithOptions:) तरीका:

   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 के ज़रिए अपने App निर्देश को या NSApplicationDelegateAdaptor. आपको ऐप्लिकेशन सौंपने की सुविधा को स्वाइप करने की सुविधा भी बंद करनी होगी. इसके लिए ज़्यादा जानकारी के लिए, 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 ऐप्लिकेशन के साथ खुलता है Android पर iOS और ऐप्लिकेशन 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);
}];
      

डिफ़ॉल्ट रूप से, 17 वर्णों के लिंक के सफ़िक्स के साथ छोटे Dynamic Links जनरेट होते हैं सही 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 Links बनाने के लिए, Dynamic Link Builder API का इस्तेमाल किया जा सकता है. इसके लिए, इनमें से किसी एक तरीके का इस्तेमाल करें इस्तेमाल किए जा सकने वाले पैरामीटर हैं. ज़्यादा जानकारी के लिए, एपीआई का संदर्भ देखें.

इस उदाहरण से, कई सामान्य पैरामीटर वाला 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 पैरामीटर तय करके या iosCustomScheme पैरामीटर को REST API

अगले चरण

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

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