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

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

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

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

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

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

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

छोटा डाइनैमिक लिंक बनाने के लिए, 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

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

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

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

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

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

अगले चरण

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

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