C++-এ রিমোট কনফিগ ব্যবহার শুরু করা

প্ল্যাটফর্ম বেছে নিন: iOS+ Android ওয়েব Flutter Unity C++


আপনি 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 যোগ করুন

Android

আপনার অ্যাপে Firebase যোগ করার পরে:

  1. JNI এনভায়রনমেন্ট ও অ্যাক্টিভিটি পাস করে Firebase অ্যাপ তৈরি করুন: 

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

  2. দেখানো পদ্ধতি অনুযায়ী Remote Config লাইব্রেরি শুরু করুন: 

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

iOS+

আপনার অ্যাপে Firebase যোগ করার পরে:

  1. Firebase অ্যাপ তৈরি করুন: 

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

  2. দেখানো পদ্ধতি অনুযায়ী Remote Config লাইব্রেরি শুরু করুন: 

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

ধাপ ৩: অ্যাপ-মধ্যস্থ ডিফল্ট প্যারামিটারের মান সেট করুন

আপনি Remote Config অবজেক্টে ইন-অ্যাপ ডিফল্ট প্যারামিটার ভ্যালু সেট করতে পারেন, যাতে আপনার অ্যাপ Remote Config ব্যাকএন্ডের সাথে কানেক্ট করার আগে প্রত্যাশিতভাবে কাজ করে এবং ব্যাকএন্ডে কোনও ভ্যালু সেট করা না থাকলে ডিফল্ট ভ্যালু উপলভ্য থাকে।

  1. প্যারামিটারের নামের সেট এবং ডিফল্ট প্যারামিটারের মান নির্ধারণ করুন, এর জন্য ConfigKeyValue* অবজেক্ট বা ConfigKeyValueVariant* অবজেক্ট ব্যবহার করুন, যার সাথে অ্যারের সাইজ উল্লেখ করুন।

    আপনি যদি আগে থেকেই Remote Config ব্যাকএন্ড প্যারামিটার ভ্যালু কনফিগার করে থাকেন, তাহলে আপনি এমন একটি ফাইল ডাউনলোড করতে পারবেন যাতে এই কী-ভ্যালু পেয়ার থাকে এবং আপনার map অবজেক্ট তৈরি করতে এটি ব্যবহার করতে পারবেন। আরও তথ্যের জন্য, ডাউনলোড করুন Remote Config টেমপ্লেট ডিফল্ট দেখুন।

  2. SetDefaults() ব্যবহার করে Remote Config অবজেক্টে এইসব ভ্যালু যোগ করুন।

ধাপ ৪: আপনার অ্যাপে ব্যবহার করার জন্য প্যারামিটারের মান পান

এখন আপনি Remote Config অবজেক্ট থেকে প্যারামিটারের মান পেতে পারেন। আপনি যদি Remote Config ব্যাকএন্ডে ভ্যালু সেট করেন, সেগুলি ফেচ করেন এবং তারপর অ্যাক্টিভেট করেন, তাহলে সেইসব ভ্যালু আপনার অ্যাপে উপলভ্য হয়। অন্যথায়, আপনি SetDefaults() ব্যবহার করে কনফিগার করা অ্যাপ-মধ্যস্থ প্যারামিটারের ভ্যালু পান।

এইসব ভ্যালু পেতে, আপনার অ্যাপের প্রত্যাশিত ডেটা টাইপে ম্যাপ করে এমন নিম্নলিখিত যেকোনও পদ্ধতি কল করুন, প্যারামিটার কী আর্গুমেন্ট হিসেবে প্রদান করুন:

ধাপ ৫: প্যারামিটারের ভ্যালু সেট করা

  1. Firebase কনসোলে, DevOps ও এনগেজমেন্ট > রিমোট কনফিগ বিকল্পে যান।

  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-এর নতুন ভার্সন প্রকাশ করলে, যেসব ডিভাইসে আপনার অ্যাপ চলছে এবং পরিবর্তনের জন্য অপেক্ষা করছে, সেগুলি কনফিগারেশন আপডেট লিসেনারকে কল করবে।