C++ पर Remote Config का इस्तेमाल शुरू करना

Firebase Remote Config का इस्तेमाल करके, अपने ऐप्लिकेशन में पैरामीटर तय किए जा सकते हैं. साथ ही, क्लाउड में उनकी वैल्यू अपडेट की जा सकती हैं. इससे, ऐप्लिकेशन का अपडेट डिस्ट्रिब्यूट किए बिना ही, ऐप्लिकेशन के लुक और काम करने के तरीके में बदलाव किया जा सकता है.

Remote Config लाइब्रेरी का इस्तेमाल, इन-ऐप्लिकेशन डिफ़ॉल्ट पैरामीटर वैल्यू को सेव करने के लिए किया जाता है. साथ ही, Remote Config बैकएंड से अपडेट की गई पैरामीटर वैल्यू फ़ेच करने के लिए भी इसका इस्तेमाल किया जाता है. इसके अलावा, यह कंट्रोल करने के लिए भी इसका इस्तेमाल किया जाता है कि फ़ेच की गई वैल्यू आपके ऐप्लिकेशन के लिए कब उपलब्ध कराई जाएं. ज़्यादा जानने के लिए, रिमोट कॉन्फ़िगरेशन लोड करने की रणनीतियां देखें.

पहला चरण: अपने ऐप्लिकेशन में Firebase जोड़ना

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

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

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

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

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

दूसरा चरण: अपने ऐप्लिकेशन में Remote Config जोड़ना

तीसरा चरण: ऐप्लिकेशन में पैरामीटर की डिफ़ॉल्ट वैल्यू सेट करना

Remote Config ऑब्जेक्ट में, इन-ऐप्लिकेशन डिफ़ॉल्ट पैरामीटर वैल्यू सेट की जा सकती हैं. इससे आपका ऐप्लिकेशन, Remote Config बैकएंड से कनेक्ट होने से पहले, आपकी उम्मीद के मुताबिक काम करेगा. साथ ही, अगर बैकएंड पर कोई वैल्यू सेट नहीं की गई है, तो डिफ़ॉल्ट वैल्यू उपलब्ध होंगी.

1. पैरामीटर के नामों का सेट और पैरामीटर की डिफ़ॉल्ट वैल्यू तय करें. इसके लिए, ConfigKeyValue* ऑब्जेक्ट या ConfigKeyValueVariant* ऑब्जेक्ट का इस्तेमाल करें.

   अगर आपने पहले ही Remote Config बैकएंड पैरामीटर की वैल्यू कॉन्फ़िगर कर ली हैं, तो आपके पास एक ऐसी फ़ाइल डाउनलोड करने का विकल्प होता है जिसमें ये की-वैल्यू पेयर शामिल होते हैं. इसका इस्तेमाल करके, map ऑब्जेक्ट बनाया जा सकता है. ज़्यादा जानकारी के लिए, Remote Config टेंप्लेट की डिफ़ॉल्ट सेटिंग डाउनलोड करें लेख पढ़ें.

2. SetDefaults() का इस्तेमाल करके, इन वैल्यू को Remote Config ऑब्जेक्ट में जोड़ें.

चौथा चरण: अपने ऐप्लिकेशन में इस्तेमाल करने के लिए पैरामीटर वैल्यू पाना

अब Remote Config ऑब्जेक्ट से पैरामीटर वैल्यू मिल सकती हैं. अगर आपने Remote Config बैकएंड में वैल्यू सेट की हैं, उन्हें फ़ेच किया है, और फिर उन्हें चालू किया है, तो वे वैल्यू आपके ऐप्लिकेशन के लिए उपलब्ध होंगी. ऐसा न करने पर, आपको SetDefaults() का इस्तेमाल करके कॉन्फ़िगर की गई, ऐप्लिकेशन में मौजूद पैरामीटर वैल्यू मिलेंगी.

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

• GetBoolean()
• GetData()
• GetDouble()
• GetLong()
• GetString()

पांचवां चरण: पैरामीटर वैल्यू सेट करना

1. Firebase console में, DevOps & Engagement > रिमोट कॉन्फ़िगरेशन पर जाएं.

2. उन पैरामीटर के नाम से पैरामीटर तय करें जो आपने अपने ऐप्लिकेशन में तय किए हैं. हर पैरामीटर के लिए, डिफ़ॉल्ट वैल्यू सेट की जा सकती है. यह वैल्यू, ऐप्लिकेशन में मौजूद डिफ़ॉल्ट वैल्यू को बदल देगी. साथ ही, शर्त के हिसाब से वैल्यू भी सेट की जा सकती हैं. ज़्यादा जानने के लिए, Remote Config पैरामीटर और शर्तें लेख पढ़ें.

छठा चरण: वैल्यू फ़ेच और ऐक्टिवेट करना

1. Remote Config बैकएंड से पैरामीटर वैल्यू फ़ेच करने के लिए, Fetch() तरीके को कॉल करें. बैकएंड पर सेट की गई सभी वैल्यू, Remote Config ऑब्जेक्ट में फ़ेच और कैश मेमोरी में सेव की जाती हैं.
2. फ़ेच की गई पैरामीटर वैल्यू को अपने ऐप्लिकेशन में उपलब्ध कराने के लिए, ActivateFetched()

सातवां चरण: रीयल टाइम में अपडेट सुनना

पैरामीटर वैल्यू फ़ेच करने के बाद, Remote Config से अपडेट पाने के लिए, रीयल-टाइम Remote Config का इस्तेमाल किया जा सकता है. अपडेट उपलब्ध होने पर, कनेक्ट किए गए डिवाइसों को रीयल-टाइम Remote Config सिग्नल मिलते हैं. साथ ही, नई Remote Config वर्शन पब्लिश करने के बाद, बदलाव अपने-आप फ़ेच हो जाते हैं.

रीयल-टाइम अपडेट की सुविधा, Android और Apple प्लैटफ़ॉर्म के लिए Firebase C++ SDK के v11.0.0 और इसके बाद के वर्शन पर काम करती है.

1. अपने ऐप्लिकेशन में, AddOnConfigUpdateListener को कॉल करें, ताकि अपडेट सुनने की सुविधा शुरू हो सके. इससे, नई या अपडेट की गई पैरामीटर वैल्यू अपने-आप फ़ेच हो जाएंगी. यहां दिए गए उदाहरण में, अपडेट के लिए सुना जाता है. साथ ही, जब Activate को कॉल किया जाता है, तब नई फ़ेच की गई वैल्यू का इस्तेमाल करके, अपडेट किया गया वेलकम मैसेज दिखाया जाता है.

remote_config->AddOnConfigUpdateListener(
    [](firebase::remote_config::ConfigUpdate&& config_update,
       firebase::remote_config::RemoteConfigError remote_config_error) {
      if (remote_config_error != firebase::remote_config::kRemoteConfigErrorNone) {
        printf("Error listening for config updates: %d", remote_config_error);
      }
      // Search the `updated_keys` set for the key "welcome_message."
      // `updated_keys` represents the keys that have changed since the last
      // fetch.
      if (std::find(config_update.updated_keys.begin(),
                    config_update.updated_keys.end(),
                    "welcome_message") != config_update.updated_keys.end()) {
        remote_config->Activate().OnCompletion(
            [&](const firebase::Future& completed_future,
               void* user_data) {
              // The key "welcome_message" was found within `updated_keys` and
              // can be activated.
              if (completed_future.error() == 0) {
                DisplayWelcomeMessage();
              } else {
                printf("Error activating config: %d", completed_future.error());
              }
            },
            nullptr);
      }
    });

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