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

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

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

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

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

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

ধাপ ৪: আপনার অ্যাপে ব্যবহার করার জন্য প্যারামিটার মানগুলো সংগ্রহ করুন।

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

এই মানগুলি পেতে, আপনার অ্যাপের প্রত্যাশিত ডেটা টাইপের সাথে মানানসই নিম্নলিখিত যেকোনো মেথডকে কল করুন এবং আর্গুমেন্ট হিসেবে 'key' প্যারামিটারটি প্রদান করুন:

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

ধাপ ৫: প্যারামিটারের মান নির্ধারণ করুন

1. Firebase কনসোলে আপনার প্রজেক্টটি খুলুন।
2. Remote Config ড্যাশবোর্ড দেখতে মেনু থেকে Remote Config নির্বাচন করুন।
3. আপনার অ্যাপে সংজ্ঞায়িত প্যারামিটারগুলোর মতোই একই নামে প্যারামিটার নির্ধারণ করুন। প্রতিটি প্যারামিটারের জন্য, আপনি একটি ডিফল্ট মান (যা অবশেষে অ্যাপের ডিফল্ট মানকে ওভাররাইড করবে) এবং শর্তসাপেক্ষ মান সেট করতে পারেন। আরও জানতে, Remote Config প্যারামিটার এবং শর্তাবলী দেখুন।

ধাপ ৬: মানগুলি আনুন এবং সক্রিয় করুন

1. Remote Config ব্যাকএন্ড থেকে প্যারামিটার ভ্যালুগুলো আনার জন্য, Fetch() মেথডটি কল করুন। আপনি ব্যাকএন্ডে যে ভ্যালুগুলো সেট করেন, সেগুলো ফেচ করে Remote Config অবজেক্টে ক্যাশ করা হয়।
2. ফেচ করা প্যারামিটার মানগুলি আপনার অ্যাপে উপলব্ধ করতে, ActivateFetched() কল করুন।

ধাপ ৭: রিয়েল টাইমে আপডেট শুনুন

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

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