C++ का इस्तेमाल करके डाइनैमिक लिंक बनाएं

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

https://example.page.link/WXYZ

C++ SDK, Android और iOS, दोनों के लिए काम करता है. हालांकि, हर प्लैटफ़ॉर्म के लिए कुछ अतिरिक्त सेटअप की ज़रूरत होती है.

शुरू करने से पहले

Firebase Dynamic Links का इस्तेमाल करने से पहले, आपको ये काम करने होंगे:

  • अपने C++ प्रोजेक्ट को रजिस्टर करें और उसे Firebase का इस्तेमाल करने के लिए कॉन्फ़िगर करें.

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

  • अपने C++ प्रोजेक्ट में Firebase C++ SDK जोड़ें.

ध्यान दें कि अपने C++ प्रोजेक्ट में Firebase जोड़ने के लिए, आपको Firebase कंसोल और अपने खुले हुए C++ प्रोजेक्ट, दोनों में टास्क करने होंगे. उदाहरण के लिए, कंसोल से Firebase की कॉन्फ़िगरेशन फ़ाइलें डाउनलोड करें और फिर उन्हें अपने C++ प्रोजेक्ट में ले जाएं.

Android

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

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

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

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

iOS

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

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

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

  3. Firebase Dynamic Links C++ क्लाइंट लाइब्रेरी, लिंक प्रोसेस करने के लिए iOS पर कस्टम यूआरएल स्कीम का इस्तेमाल करती है. Dynamic Links पाने के लिए, आपको अपने ऐप्लिकेशन में कस्टम यूआरएल स्कीम जोड़नी होंगी:
    1. अपने प्रोजेक्ट का कॉन्फ़िगरेशन खोलने के लिए, बाईं ओर मौजूद ट्री व्यू में प्रोजेक्ट के नाम पर दो बार क्लिक करें. TARGETS सेक्शन में जाकर अपना ऐप्लिकेशन चुनें. इसके बाद, Info टैब चुनें और URL Types सेक्शन को बड़ा करें.
    2. + बटन पर क्लिक करें और अपने रिवर्स क्लाइंट आईडी के लिए यूआरएल स्कीम जोड़ें. यह वैल्यू ढूंढने के लिए, GoogleService-Info.plist कॉन्फ़िगरेशन फ़ाइल खोलें और REVERSED_CLIENT_ID कुंजी ढूंढें. उस कुंजी की वैल्यू को कॉपी करें और उसे कॉन्फ़िगरेशन पेज पर मौजूद यूआरएल स्कीम बॉक्स में चिपकाएं. अन्य फ़ील्ड खाली छोड़ दें.
    3. + बटन पर क्लिक करें और दूसरी यूआरएल स्कीम जोड़ें. यह आपके ऐप्लिकेशन के बंडल आईडी जैसा ही होता है. उदाहरण के लिए, अगर आपका बंडल आईडी com.example.ios है, तो उस वैल्यू को यूआरएल स्कीम बॉक्स में टाइप करें. अपने ऐप्लिकेशन का बंडल आईडी, प्रोजेक्ट कॉन्फ़िगरेशन (Identity > Bundle Identifier) के General टैब में देखा जा सकता है.

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

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

कस्टम डोमेन

goo.gl या page.link सबडोमेन के बजाय अपने डोमेन का इस्तेमाल करके, Dynamic Link की ब्रैंडिंग को बेहतर तरीके से कंट्रोल किया जा सकता है. अपने प्रोजेक्ट के लिए कस्टम डोमेन सेट अप करने के लिए, इन निर्देशों का पालन करें.

Firebase Dynamic Links API का इस्तेमाल करना

ऐप्लिकेशन बनाना और उसे शुरू करना

Dynamic Links बनाने से पहले, आपको firebase::App ऑब्जेक्ट बनाना और उसे शुरू करना होगा.

firebase::App के लिए हेडर फ़ाइल शामिल करें:

#include "firebase/app.h"

अगला हिस्सा आपके प्लैटफ़ॉर्म के हिसाब से अलग-अलग होता है:

Android

firebase::App बनाएं. इसके लिए, JNI एनवायरमेंट और Java ऐक्टिविटी के jobject रेफ़रंस को आर्ग्युमेंट के तौर पर पास करें:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"), jni_env, activity);

iOS

firebase::App बनाएं:

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"));

Dynamic Links लाइब्रेरी शुरू करना

Dynamic Link बनाने से पहले, आपको Dynamic Links लाइब्रेरी को शुरू करना होगा: 

::firebase::dynamic_links::Initialize(app, null);

पैरामीटर से लॉन्ग Dynamic Link बनाना

डाइनैमिक लिंक बनाने के लिए, DynamicLinkComponents ऑब्जेक्ट बनाएं. इसके लिए, अतिरिक्त कॉन्फ़िगरेशन के लिए वैकल्पिक सदस्यों में से किसी को सेट करें और उसे dynamic_links::GetShortLink या dynamic_links::GetLongLink को पास करें.

यहां दिए गए उदाहरण में, https://www.example.com/ के लिए एक लंबा डाइनैमिक लिंक बनाया गया है. यह लिंक, आपके Android ऐप्लिकेशन com.example.android.package_name और iOS ऐप्लिकेशन com.example.ios के साथ खुलता है:

firebase::dynamic_links::IOSParameters ios_parameters("com.example.ios");

firebase::dynamic_links::AndroidParameters android_parameters(
    "com.example.android.package_name");

firebase::dynamic_links::DynamicLinkComponents components(
    "https://www.example.com/", "example.page.link");
components.android_parameters = &android_parameters;
components.ios_parameters = &ios_parameters;

firebase::dynamic_links::GeneratedDynamicLink long_link =
    firebase::dynamic_links::GetLongLink(components);

Dynamic Link शॉर्ट वीडियो बनाना

छोटा डाइनैमिक लिंक बनाने के लिए, पहले से जनरेट किए गए लंबे लिंक को GetShortLink पर पास करें या ऊपर बताए गए तरीके से DynamicLinkComponents बनाएं.

GetShortLink में PathLength के साथ एक अतिरिक्त DynamicLinkOptions कॉन्फ़िगरेशन पैरामीटर भी इस्तेमाल किया जा सकता है. इससे आपको यह कंट्रोल करने की सुविधा मिलती है कि लिंक कैसे जनरेट किया जाए. छोटा लिंक जनरेट करने के लिए, Firebase बैकएंड को नेटवर्क का अनुरोध भेजना ज़रूरी है. इसलिए, GetShortLink एसिंक्रोनस है और Future<GeneratedLink> दिखाता है.

उदाहरण के लिए:

firebase::dynamic_links::DynamicLinkOptions short_link_options;
short_link_options.path_length = firebase::dynamic_links::kPathLengthShort;

firebase::Future<firebase::dynamic_links::GeneratedDynamicLink> result =
    firebase::dynamic_links::GetShortLink(components, short_link_options);

अगर आपके प्रोग्राम में अपडेट लूप है, जो नियमित तौर पर चलता है (जैसे, हर सेकंड 30 या 60 बार), तो हर अपडेट के बाद नतीजे देखे जा सकते हैं:

if (result.status() == firebase::kFutureStatusComplete) {
  if (result.error() == firebase::dynamic_links::kErrorCodeSuccess) {
    firebase::dynamic_links::GeneratedDynamicLink link = *result.result();
    printf("Create short link succeeded: %s\n", link.url.c_str());
  } else {
    printf("Created short link failed with error '%s'\n",
           result.error_message());
  }
}