আপনি আপনার অ্যাপের প্যারামিটারগুলি সংজ্ঞায়িত করতে এবং ক্লাউডে তাদের মানগুলি আপডেট করতে Firebase রিমোট কনফিগারেশন ব্যবহার করতে পারেন, যাতে আপনি কোনও অ্যাপ আপডেট বিতরণ না করেই আপনার অ্যাপের চেহারা এবং আচরণ পরিবর্তন করতে পারেন। এই নির্দেশিকাটি আপনাকে শুরু করার জন্য ধাপগুলির মধ্যে নিয়ে যায় এবং কিছু নমুনা কোড প্রদান করে।
ধাপ 1: আপনার অ্যাপে Firebase এবং Remote Config SDK যোগ করুন
আপনি যদি ইতিমধ্যে এটি না করে থাকেন তবে ফ্লটারের জন্য Firebase SDK ইনস্টল করুন এবং শুরু করুন৷
রিমোট কনফিগারেশনের জন্য, ব্যবহারকারীর বৈশিষ্ট্য এবং শ্রোতাদের জন্য অ্যাপ ইনস্ট্যান্সের শর্তসাপেক্ষ টার্গেট করার জন্য Google Analytics প্রয়োজন। নিশ্চিত করুন যে আপনি আপনার প্রকল্পে Google Analytics সক্ষম করুন ৷
আপনার ফ্লাটার প্রকল্পের রুট ডিরেক্টরি থেকে, রিমোট কনফিগ প্লাগইন ইনস্টল করতে নিম্নলিখিত কমান্ডটি চালান:
flutter pub add firebase_remote_configএছাড়াও, রিমোট কনফিগ সেট আপ করার অংশ হিসাবে, আপনাকে আপনার অ্যাপে Google Analytics-এর জন্য Firebase SDK যোগ করতে হবে:
flutter pub add firebase_analyticsআপনার প্রকল্প পুনর্নির্মাণ:
flutter runআপনি যদি macOS-এ রিমোট কনফিগ ব্যবহার করেন, তাহলে Xcode-এ কীচেন শেয়ারিং সক্ষম করুন।
ধাপ 2: রিমোট কনফিগার সিঙ্গেলটন অবজেক্ট পান
একটি রিমোট কনফিগার অবজেক্ট ইনস্ট্যান্স পান এবং ঘন ঘন রিফ্রেশ করার জন্য ন্যূনতম আনয়ন ব্যবধান সেট করুন:
final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
fetchTimeout: const Duration(minutes: 1),
minimumFetchInterval: const Duration(hours: 1),
));
সিঙ্গলটন অবজেক্টটি অ্যাপ-মধ্যস্থ ডিফল্ট প্যারামিটার মানগুলি সংরক্ষণ করতে, ব্যাকএন্ড থেকে আপডেট করা প্যারামিটার মানগুলি আনতে এবং আপনার অ্যাপে যখন আনা মানগুলি উপলব্ধ করা হয় তখন নিয়ন্ত্রণ করতে ব্যবহৃত হয়।
বিকাশের সময়, এটি একটি অপেক্ষাকৃত কম ন্যূনতম আনার ব্যবধান সেট করার পরামর্শ দেওয়া হয়। আরও তথ্যের জন্য থ্রটলিং দেখুন।
ধাপ 3: অ্যাপ-মধ্যস্থ ডিফল্ট প্যারামিটার মান সেট করুন
আপনি রিমোট কনফিগ অবজেক্টে অ্যাপ-মধ্যস্থ ডিফল্ট প্যারামিটার মান সেট করতে পারেন, যাতে আপনার অ্যাপটি রিমোট কনফিগ ব্যাকএন্ডের সাথে সংযোগ করার আগে উদ্দেশ্য অনুযায়ী আচরণ করে এবং যাতে ব্যাকএন্ডে কোনোটি সেট না থাকলে ডিফল্ট মান উপলব্ধ থাকে।
await remoteConfig.setDefaults(const {
"example_param_1": 42,
"example_param_2": 3.14159,
"example_param_3": true,
"example_param_4": "Hello, world!",
});
ধাপ 4: আপনার অ্যাপে ব্যবহার করার জন্য প্যারামিটার মান পান
এখন আপনি দূরবর্তী কনফিগার অবজেক্ট থেকে প্যারামিটার মান পেতে পারেন। আপনি যদি ব্যাকএন্ডে মান সেট করেন, সেগুলি আনুন এবং তারপরে সেগুলি সক্রিয় করুন, সেই মানগুলি আপনার অ্যাপে উপলব্ধ। অন্যথায়, আপনি setDefaults() ব্যবহার করে কনফিগার করা অ্যাপ-মধ্যস্থ প্যারামিটার মানগুলি পাবেন।
এই মানগুলি পেতে, নীচে তালিকাভুক্ত পদ্ধতিতে কল করুন যা আপনার অ্যাপের দ্বারা প্রত্যাশিত ডেটা টাইপের সাথে মানচিত্র করে, একটি যুক্তি হিসাবে প্যারামিটার কী প্রদান করে:
-
getBool() -
getDouble() -
getInt() -
getString()
ধাপ 5: দূরবর্তী কনফিগার ব্যাকএন্ডে প্যারামিটার মান সেট করুন
ফায়ারবেস কনসোল বা রিমোট কনফিগ ব্যাকএন্ড API ব্যবহার করে, আপনি নতুন সার্ভার-সাইড ডিফল্ট মান তৈরি করতে পারেন যা আপনার পছন্দসই শর্তাধীন যুক্তি বা ব্যবহারকারীর টার্গেটিং অনুযায়ী অ্যাপ-মধ্যস্থ মানগুলিকে ওভাররাইড করে৷ এই বিভাগটি এই মানগুলি তৈরি করার জন্য Firebase কনসোলের পদক্ষেপগুলি বর্ণনা করে৷
- Firebase কনসোলে , আপনার প্রকল্প খুলুন।
- রিমোট কনফিগার ড্যাশবোর্ড দেখতে মেনু থেকে রিমোট কনফিগ নির্বাচন করুন।
- আপনি আপনার অ্যাপে যে প্যারামিটারগুলি সংজ্ঞায়িত করেছেন তার মতো একই নামের প্যারামিটারগুলিকে সংজ্ঞায়িত করুন৷ প্রতিটি প্যারামিটারের জন্য, আপনি একটি ডিফল্ট মান সেট করতে পারেন (যা শেষ পর্যন্ত সংশ্লিষ্ট ইন-অ্যাপ ডিফল্ট মানকে ওভাররাইড করবে) এবং আপনি শর্তসাপেক্ষ মানও সেট করতে পারেন। আরও জানতে, দূরবর্তী কনফিগার পরামিতি এবং শর্তাবলী দেখুন।
ধাপ 6: মান আনুন এবং সক্রিয় করুন
রিমোট কনফিগ ব্যাকএন্ড থেকে প্যারামিটার মান আনতে,
fetch()পদ্ধতিতে কল করুন। আপনি ব্যাকএন্ডে সেট করেছেন এমন যেকোনো মান রিমোট কনফিগারেশন অবজেক্টে আনা এবং সংরক্ষণ করা হয়।আপনার অ্যাপে আনা প্যারামিটার মান উপলব্ধ করতে,
activate()পদ্ধতিতে কল করুন।যে ক্ষেত্রে আপনি একটি কলে মান আনতে এবং সক্রিয় করতে চান, আপনি রিমোট কনফিগার ব্যাকএন্ড থেকে মানগুলি আনতে এবং অ্যাপে সেগুলি উপলব্ধ করতে একটি
fetchAndActivate()অনুরোধ ব্যবহার করতে পারেন:await remoteConfig.fetchAndActivate();
যেহেতু এই আপডেট হওয়া প্যারামিটার মানগুলি আপনার অ্যাপের আচরণ এবং চেহারাকে প্রভাবিত করে, তাই আপনার আনীত মানগুলিকে এমন সময়ে সক্রিয় করা উচিত যা আপনার ব্যবহারকারীর জন্য একটি মসৃণ অভিজ্ঞতা নিশ্চিত করে, যেমন পরের বার যখন ব্যবহারকারী আপনার অ্যাপটি খুলবেন। আরও তথ্য এবং উদাহরণের জন্য দূরবর্তী কনফিগ লোডিং কৌশল দেখুন।
ধাপ 7: রিয়েল টাইমে আপডেটের জন্য শুনুন
আপনি পরামিতি মান আনার পরে, আপনি রিমোট কনফিগার ব্যাকএন্ড থেকে আপডেট শুনতে রিয়েল-টাইম রিমোট কনফিগ ব্যবহার করতে পারেন। রিয়েল-টাইম রিমোট কনফিগ আপডেটগুলি উপলব্ধ থাকলে সংযুক্ত ডিভাইসগুলিতে সংকেত দেয় এবং আপনি একটি নতুন রিমোট কনফিগ সংস্করণ প্রকাশ করার পরে স্বয়ংক্রিয়ভাবে পরিবর্তনগুলি আনয়ন করে৷
মনে রাখবেন যে রিয়েল-টাইম রিমোট কনফিগ ওয়েবের জন্য উপলব্ধ নয়।
আপনার অ্যাপে, আপডেটের জন্য শোনা শুরু করতে এবং স্বয়ংক্রিয়ভাবে যেকোনো নতুন প্যারামিটার মান আনতে
onConfigUpdatedব্যবহার করুন।remoteConfig.onConfigUpdated.listen((event) async { await remoteConfig.activate(); // Use the new config values here. });পরের বার যখন আপনি আপনার রিমোট কনফিগারেশনের একটি নতুন সংস্করণ প্রকাশ করবেন, যে ডিভাইসগুলি আপনার অ্যাপটি চালাচ্ছে এবং পরিবর্তনগুলি শুনছে সেগুলি নতুন কনফিগারেশন সক্রিয় করবে৷
থ্রটলিং
যদি একটি অ্যাপ অল্প সময়ের মধ্যে অনেকবার আনয়ন করে, তাহলে কলগুলিকে থ্রটল করা হবে এবং FirebaseRemoteConfig এর lastFetchStatus প্রপার্টির মান হবে RemoteConfigFetchStatus.throttle ।
রিমোট কনফিগারেশনের জন্য ডিফল্ট ন্যূনতম আনয়ন ব্যবধান হল 12 ঘন্টা, যার অর্থ হল 12 ঘন্টার উইন্ডোতে ব্যাকএন্ড থেকে কনফিগারেশনগুলি একবারের বেশি আনা হবে না, আসলে কতগুলি আনা কল করা হোক না কেন।
অ্যাপ ডেভেলপমেন্টের সময়, আপনি যদি রিয়েল-টাইম রিমোট কনফিগারেশন ব্যবহার না করেন (যা আমরা সুপারিশ করি), আপনি আপনার অ্যাপ ডেভেলপ ও পরীক্ষা করার সাথে সাথে আপনাকে দ্রুত পুনরাবৃত্তি করতে দেওয়ার জন্য খুব ঘন ঘন কনফিগগুলি আনতে এবং সক্রিয় করতে চাইতে পারেন। 10 জন পর্যন্ত ডেভেলপারের সাথে একটি প্রকল্পে দ্রুত পুনরাবৃত্তি মিটমাট করার জন্য, আপনি setConfigSettings() এর সাথে সাময়িকভাবে একটি সর্বনিম্ন আনয়ন ব্যবধান সেট করতে পারেন।
final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
fetchTimeout: const Duration(minutes: 1),
minimumFetchInterval: const Duration(minutes: 5),
));
পরবর্তী পদক্ষেপ
যদি আপনি ইতিমধ্যে না থাকেন তবে Remote Config ব্যবহারের কেসগুলি অন্বেষণ করুন এবং কিছু মূল ধারণা এবং উন্নত কৌশল ডকুমেন্টেশন সহ একবার দেখুন:
,আপনি আপনার অ্যাপ্লিকেশনটিতে পরামিতিগুলি সংজ্ঞায়িত করতে এবং ক্লাউডে তাদের মানগুলি আপডেট করতে ফায়ারবেস রিমোট কনফিগারেশন ব্যবহার করতে পারেন, আপনাকে কোনও অ্যাপ্লিকেশন আপডেট বিতরণ না করে আপনার অ্যাপ্লিকেশনটির উপস্থিতি এবং আচরণ সংশোধন করতে দেয়। এই গাইডটি আপনাকে শুরু করার পদক্ষেপগুলি দিয়ে চলেছে এবং কিছু নমুনা কোড সরবরাহ করে।
পদক্ষেপ 1: আপনার অ্যাপ্লিকেশনটিতে ফায়ারবেস এবং রিমোট কনফিগার এসডিকে যুক্ত করুন
আপনি যদি ইতিমধ্যে এটি না করে থাকেন তবে ফায়ারবেস এসডিকে ইনস্টল করুন এবং আরম্ভ করুন ।
রিমোট কনফিগারেশনের জন্য, গুগল অ্যানালিটিকগুলি ব্যবহারকারীর বৈশিষ্ট্য এবং শ্রোতাদের কাছে অ্যাপ্লিকেশন দৃষ্টান্তের শর্তসাপেক্ষ লক্ষ্যমাত্রার জন্য প্রয়োজনীয়। আপনি আপনার প্রকল্পে গুগল অ্যানালিটিক্স সক্ষম করেছেন তা নিশ্চিত করুন।
আপনার ফ্লটার প্রকল্পের মূল ডিরেক্টরি থেকে, রিমোট কনফিগারেশন প্লাগইন ইনস্টল করতে নিম্নলিখিত কমান্ডটি চালান:
flutter pub add firebase_remote_configএছাড়াও, রিমোট কনফিগারেশন স্থাপনের অংশ হিসাবে, আপনাকে আপনার অ্যাপ্লিকেশনটিতে গুগল অ্যানালিটিক্সের জন্য ফায়ারবেস এসডিকে যুক্ত করতে হবে:
flutter pub add firebase_analyticsআপনার প্রকল্পটি পুনর্নির্মাণ:
flutter runআপনি যদি ম্যাকোসে রিমোট কনফিগারেশন ব্যবহার করছেন তবে এক্সকোডে কীচেইন ভাগ করে নেওয়া সক্ষম করুন।
পদক্ষেপ 2: রিমোট কনফিগারেশন সিঙ্গলটন অবজেক্টটি পান
একটি রিমোট কনফিগারেশন অবজেক্ট উদাহরণ পান এবং ঘন ঘন রিফ্রেশগুলির জন্য অনুমতি দেওয়ার জন্য ন্যূনতম আনার ব্যবধান সেট করুন:
final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
fetchTimeout: const Duration(minutes: 1),
minimumFetchInterval: const Duration(hours: 1),
));
সিঙ্গেলটন অবজেক্টটি ইন-অ্যাপ্লিকেশন ডিফল্ট প্যারামিটার মানগুলি সংরক্ষণ করতে, ব্যাকএন্ড থেকে আপডেট হওয়া প্যারামিটার মান আনতে এবং যখন আপনার অ্যাপ্লিকেশনটিতে আনার মানগুলি উপলব্ধ করা হয় তখন নিয়ন্ত্রণ করতে ব্যবহৃত হয়।
বিকাশের সময়, এটি একটি অপেক্ষাকৃত কম ন্যূনতম আনার ব্যবধান সেট করার পরামর্শ দেওয়া হয়। আরও তথ্যের জন্য থ্রোটলিং দেখুন।
পদক্ষেপ 3: অ্যাপ্লিকেশন ডিফল্ট প্যারামিটার মান সেট করুন
আপনি রিমোট কনফিগারেশন অবজেক্টে অ্যাপ্লিকেশন ডিফল্ট প্যারামিটার মানগুলি সেট করতে পারেন, যাতে আপনার অ্যাপ্লিকেশনটি রিমোট কনফিগার ব্যাকএন্ডের সাথে সংযোগ স্থাপনের আগে উদ্দেশ্য হিসাবে আচরণ করে এবং যাতে কোনও ব্যাকএন্ডে সেট না করা থাকলে ডিফল্ট মানগুলি পাওয়া যায়।
await remoteConfig.setDefaults(const {
"example_param_1": 42,
"example_param_2": 3.14159,
"example_param_3": true,
"example_param_4": "Hello, world!",
});
পদক্ষেপ 4: আপনার অ্যাপ্লিকেশনটিতে ব্যবহারের জন্য প্যারামিটার মানগুলি পান
এখন আপনি রিমোট কনফিগারেশন অবজেক্ট থেকে প্যারামিটার মান পেতে পারেন। আপনি যদি ব্যাকএন্ডে মানগুলি সেট করেন তবে সেগুলি আনুন এবং তারপরে সেগুলি সক্রিয় করুন, সেই মানগুলি আপনার অ্যাপ্লিকেশনটিতে উপলব্ধ। অন্যথায়, আপনি setDefaults() ব্যবহার করে কনফিগার করা ইন-অ্যাপ্লিকেশন প্যারামিটার মানগুলি পান।
এই মানগুলি পেতে, আপনার অ্যাপ্লিকেশন দ্বারা প্রত্যাশিত ডেটা টাইপের নীচে তালিকাভুক্ত পদ্ধতিটি কল করুন, একটি যুক্তি হিসাবে প্যারামিটার কী সরবরাহ করে:
-
getBool() -
getDouble() -
getInt() -
getString()
পদক্ষেপ 5: রিমোট কনফিগার ব্যাকেন্ডে প্যারামিটার মানগুলি সেট করুন
ফায়ারবেস কনসোল বা রিমোট কনফিগার ব্যাকেন্ড এপিআই ব্যবহার করে আপনি নতুন সার্ভার-সাইড ডিফল্ট মান তৈরি করতে পারেন যা আপনার পছন্দসই শর্তসাপেক্ষ যুক্তি বা ব্যবহারকারীর লক্ষ্য অনুযায়ী অ্যাপ্লিকেশন মানগুলিকে ওভাররাইড করে। এই বিভাগটি এই মানগুলি তৈরি করতে ফায়ারবেস কনসোল পদক্ষেপগুলি বর্ণনা করে।
- Firebase কনসোলে , আপনার প্রকল্প খুলুন।
- রিমোট কনফিগারেশন ড্যাশবোর্ড দেখতে মেনু থেকে রিমোট কনফিগারেশন নির্বাচন করুন।
- আপনি আপনার অ্যাপ্লিকেশনটিতে সংজ্ঞায়িত প্যারামিটারগুলির মতো একই নামগুলির সাথে পরামিতিগুলি সংজ্ঞায়িত করুন। প্রতিটি প্যারামিটারের জন্য, আপনি একটি ডিফল্ট মান সেট করতে পারেন (যা শেষ পর্যন্ত সংশ্লিষ্ট ইন-অ্যাপ্লিকেশন ডিফল্ট মানকে ওভাররাইড করবে) এবং আপনি শর্তাধীন মানও সেট করতে পারেন। আরও জানতে, রিমোট কনফিগারেশন পরামিতি এবং শর্তাদি দেখুন।
পদক্ষেপ 6: মান আনুন এবং সক্রিয় করুন
রিমোট কনফিগার ব্যাকেন্ড থেকে প্যারামিটার মানগুলি আনতে,
fetch()পদ্ধতিটি কল করুন। আপনি ব্যাকএন্ডে সেট করা যে কোনও মানগুলি রিমোট কনফিগার অবজেক্টে আন এবং সংরক্ষণ করা হয়।আপনার অ্যাপ্লিকেশনটিতে আনতে প্যারামিটার মানগুলি উপলব্ধ করতে,
activate()পদ্ধতিতে কল করুন।আপনি যেখানে একটি কলটিতে মান আনতে এবং সক্রিয় করতে চান এমন ক্ষেত্রে, আপনি রিমোট কনফিগারেশন ব্যাকএন্ড থেকে মান আনার জন্য একটি
fetchAndActivate()অনুরোধ ব্যবহার করতে পারেন এবং অ্যাপ্লিকেশনটিতে তাদের উপলব্ধ করতে পারেন:await remoteConfig.fetchAndActivate();
যেহেতু এই আপডেট হওয়া প্যারামিটার মানগুলি আপনার অ্যাপ্লিকেশনটির আচরণ এবং উপস্থিতিকে প্রভাবিত করে, আপনার এমন সময়ে আনার মানগুলি সক্রিয় করা উচিত যা আপনার ব্যবহারকারীর জন্য একটি মসৃণ অভিজ্ঞতা নিশ্চিত করে, যেমন পরের বার ব্যবহারকারী আপনার অ্যাপ্লিকেশনটি খোলেন। আরও তথ্য এবং উদাহরণগুলির জন্য রিমোট কনফিগার লোডিং কৌশলগুলি দেখুন।
পদক্ষেপ 7: রিয়েল টাইমে আপডেটের জন্য শুনুন
আপনি প্যারামিটার মানগুলি আনার পরে, আপনি রিমোট কনফিগার ব্যাকেন্ড থেকে আপডেটগুলি শুনতে রিয়েল-টাইম রিমোট কনফিগারেশন ব্যবহার করতে পারেন। রিয়েল-টাইম রিমোট কনফিগারেশন সংকেত সংযুক্ত ডিভাইসে যখন আপডেটগুলি পাওয়া যায় এবং আপনি একটি নতুন রিমোট কনফিগার সংস্করণ প্রকাশের পরে স্বয়ংক্রিয়ভাবে পরিবর্তনগুলি আনেন।
নোট করুন যে রিয়েল-টাইম রিমোট কনফিগারেশন ওয়েবের জন্য উপলভ্য নয়।
আপনার অ্যাপ্লিকেশনটিতে, আপডেটগুলির জন্য শ্রবণ শুরু করতে
onConfigUpdatedব্যবহার করুন এবং স্বয়ংক্রিয়ভাবে কোনও নতুন প্যারামিটার মান আনুন।remoteConfig.onConfigUpdated.listen((event) async { await remoteConfig.activate(); // Use the new config values here. });পরের বার আপনি যখন আপনার রিমোট কনফিগারেশনের একটি নতুন সংস্করণ প্রকাশ করবেন, ডিভাইসগুলি যা আপনার অ্যাপ্লিকেশন চালাচ্ছে এবং পরিবর্তনের জন্য শোনাচ্ছে তা নতুন কনফিগারেশনটিকে সক্রিয় করবে।
থ্রটলিং
যদি কোনও অ্যাপ্লিকেশন স্বল্প সময়ের মধ্যে অনেকবার আগত হয় তবে আনার কলগুলি থ্রোটল করা হবে এবং FirebaseRemoteConfig lastFetchStatus সম্পত্তিটির মানটি RemoteConfigFetchStatus.throttle হবে।
রিমোট কনফিগারেশনের জন্য ডিফল্ট ন্যূনতম ফেচ ব্যবধানটি 12 ঘন্টা, যার অর্থ 12 ঘন্টা উইন্ডোতে কনফিগারগুলি ব্যাকএন্ড থেকে একাধিকবার আনা হবে না, নির্বিশেষে কতগুলি ফেচ কলগুলি আসলে তৈরি করা হয়।
অ্যাপ্লিকেশন বিকাশের সময়, আপনি যদি রিয়েল-টাইম রিমোট কনফিগারেশন (যা আমরা সুপারিশ করি) ব্যবহার না করে থাকেন তবে আপনি আপনার অ্যাপ্লিকেশনটি বিকাশ এবং পরীক্ষা করার সাথে সাথে আপনাকে দ্রুত পুনরাবৃত্তি করতে খুব ঘন ঘন (প্রতি ঘন্টা বহুবার) কনফিগারগুলি আনতে এবং সক্রিয় করতে চাইতে পারেন। 10 জন বিকাশকারী সহ একটি প্রকল্পে দ্রুত পুনরাবৃত্তির সমন্বয় করতে, আপনি সাময়িকভাবে setConfigSettings() দিয়ে একটি কম ন্যূনতম আনার ব্যবধান সেট করতে পারেন।
final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
fetchTimeout: const Duration(minutes: 1),
minimumFetchInterval: const Duration(minutes: 5),
));
পরবর্তী পদক্ষেপ
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: