了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

फायरबेस रिमोट कॉन्फिग के साथ आरंभ करें


आप अपने ऐप में मापदंडों को परिभाषित करने और क्लाउड में उनके मूल्यों को अपडेट करने के लिए Firebase Remote Config का उपयोग कर सकते हैं, जिससे आप ऐप अपडेट को वितरित किए बिना अपने ऐप के स्वरूप और व्यवहार को संशोधित कर सकते हैं।

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

चरण 1: अपने ऐप में फायरबेस जोड़ें

इससे पहले कि आप Remote Config का उपयोग कर सकें, आपको निम्न की आवश्यकता है:

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

    यदि आपका C++ प्रोजेक्ट पहले से ही Firebase का उपयोग करता है, तो यह पहले से पंजीकृत है और Firebase के लिए कॉन्फ़िगर किया गया है।

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

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

चरण 2: अपने ऐप में रिमोट कॉन्फिग जोड़ें

एंड्रॉयड

अपने ऐप्लिकेशन में Firebase जोड़ने के बाद:

  1. JNI वातावरण और गतिविधि में गुजरने वाला एक Firebase ऐप बनाएं:

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

  2. रिमोट कॉन्फिग लाइब्रेरी को इनिशियलाइज़ करें, जैसा कि दिखाया गया है:

    ::firebase::remote_config::Initialize(app);

आईओएस+

अपने ऐप्लिकेशन में Firebase जोड़ने के बाद:

  1. एक फायरबेस ऐप बनाएं:

    app = ::firebase::App::Create(::firebase::AppOptions());

  2. रिमोट कॉन्फिग लाइब्रेरी को इनिशियलाइज़ करें, जैसा कि दिखाया गया है:

    ::firebase::remote_config::Initialize(app);

चरण 3: इन-ऐप डिफ़ॉल्ट पैरामीटर मान सेट करें

आप Remote Config ऑब्जेक्ट में इन-एप डिफ़ॉल्ट पैरामीटर मान सेट कर सकते हैं, ताकि आपका ऐप Remote Config बैकएंड से कनेक्ट होने से पहले अपेक्षित व्यवहार करे, और ताकि बैकएंड पर कोई भी सेट न होने पर डिफ़ॉल्ट मान उपलब्ध हों।

  1. एक std::map<const char*, const char*> ऑब्जेक्ट या एक std::map<const char*, firebase::Variant> ऑब्जेक्ट का उपयोग करके पैरामीटर नामों का एक सेट और डिफ़ॉल्ट पैरामीटर मान परिभाषित करें।

    यदि आपने पहले से ही रिमोट कॉन्फ़िगरेशन बैकएंड पैरामीटर मान कॉन्फ़िगर किए हैं, तो आप एक फ़ाइल डाउनलोड कर सकते हैं जिसमें ये कुंजी/मान युग्म शामिल हैं और इसका उपयोग अपने map ऑब्जेक्ट के निर्माण के लिए करें। अधिक जानकारी के लिए, रिमोट कॉन्फिग टेम्प्लेट डिफॉल्ट डाउनलोड करें देखें।

  2. SetDefaults() का उपयोग करके इन मानों को रिमोट कॉन्फ़िगरेशन ऑब्जेक्ट में जोड़ें।

चरण 4: अपने ऐप में उपयोग करने के लिए पैरामीटर मान प्राप्त करें

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

इन मानों को प्राप्त करने के लिए, नीचे सूचीबद्ध विधि को कॉल करें जो आपके ऐप द्वारा अपेक्षित डेटा प्रकार के लिए मैप करता है, पैरामीटर कुंजी को एक तर्क के रूप में प्रदान करता है:

चरण 5: अपने ऐप को फायरबेस कंसोल में कनेक्ट करें

Firebase कंसोल में, अपने ऐप को अपने Firebase प्रोजेक्ट में जोड़ें।

चरण 6: पैरामीटर मान सेट करें

  1. Firebase कंसोल में, अपना प्रोजेक्ट खोलें।
  2. Remote Config डैशबोर्ड देखने के लिए मेनू से Remote Config चुनें।
  3. पैरामीटर को उन्हीं नामों से परिभाषित करें जिन्हें आपने अपने ऐप में परिभाषित किया था। प्रत्येक पैरामीटर के लिए, आप एक डिफ़ॉल्ट मान सेट कर सकते हैं (जो अंततः इन-ऐप डिफ़ॉल्ट मान को ओवरराइड कर देगा) और सशर्त मान। अधिक जानने के लिए, रिमोट कॉन्फ़िगरेशन पैरामीटर और शर्तें देखें।

चरण 7: मान प्राप्त करें और सक्रिय करें

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

चरण 8: वास्तविक समय में अद्यतनों के लिए सुनें

पैरामीटर मान लाने के बाद, आप 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 का एक नया संस्करण प्रकाशित करते हैं, तो डिवाइस जो आपके ऐप को चला रहे हैं और परिवर्तनों को सुन रहे हैं, कॉन्फ़िग अपडेट श्रोता को कॉल करेंगे।

अगले कदम

If you haven't already, explore the Remote Config use cases , and take a look at some of the key concepts and advanced strategies documentation, including: