রিমোট কনফিগ টেমপ্লেট এবং সংস্করণ

Remote Config templates are sets of JSON-formatted parameters and conditions that you have created for your Firebase project. You can create client templates, from which your app fetches values, and server templates, from which server clients can fetch values.

আপনি Firebase কনসোল ব্যবহার করে টেমপ্লেটটি পরিবর্তন ও পরিচালনা করতে পারেন। টেমপ্লেটের বিষয়বস্তু গ্রাফিক্যাল ফরম্যাটে দেখতে DevOps & Engagement > Remote Config- এ যান।প্যারামিটার পৃষ্ঠা এবং শর্তাবলী পৃষ্ঠা ।

এছাড়াও আপনি আপনার ক্লায়েন্ট টেমপ্লেট পরিবর্তন ও পরিচালনা করতে Remote Config REST API ও অ্যাডমিন SDK অথবা Firebase CLI ব্যবহার করতে পারেন।

এখানে একটি সার্ভার টেমপ্লেট ফাইলের উদাহরণ দেওয়া হলো:

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "valueType": "JSON"
    },
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

আপনি Firebase কনসোলে এই ভার্সন ম্যানেজমেন্টের কাজগুলো করতে পারেন ( DevOps & Engagement > Remote Config- এ যান):

• সংরক্ষিত সমস্ত টেমপ্লেট সংস্করণ তালিকাভুক্ত করুন
• একটি নির্দিষ্ট সংস্করণ পুনরুদ্ধার করুন
• একটি নির্দিষ্ট ক্লায়েন্ট সংস্করণে ফিরে যান
• পরিবর্তনের ইতিহাস পৃষ্ঠা থেকে Remote Config টেমপ্লেটগুলি মুছে ফেলুন।

There is a total limit of 300 lifetime stored versions per template type (300 client templates and 300 server templates), which includes stored version numbers for deleted templates. If you publish more than 300 template versions per template type during the lifetime of a project, the earliest versions are deleted, maintaining a maximum of 300 versions of that type.

Each time you update parameters, Remote Config creates a new versioned Remote Config template and stores the previous template as a version that you can retrieve or roll back to as needed. Version numbers are incremented sequentially from the initial value stored by Remote Config . All templates include a version field as shown, containing metadata about that specific version.

আপনি DevOps & Engagement > Remote Config > থেকে প্রয়োজন অনুযায়ী Remote Config টেমপ্লেটগুলো ডিলিট করতে পারেন।ইতিহাস পৃষ্ঠা পরিবর্তন করুনFirebase কনসোলের।

Remote Config টেমপ্লেট সংস্করণগুলি পরিচালনা করুন

এই বিভাগে আপনার Remote Config টেমপ্লেটের ভার্সনগুলো কীভাবে পরিচালনা করবেন তা বর্ণনা করা হয়েছে।

Remote Config টেমপ্লেটের সমস্ত সংরক্ষিত সংস্করণ তালিকাভুক্ত করুন

আপনি Remote Config টেমপ্লেটের সমস্ত সংরক্ষিত ভার্সনের একটি তালিকা পেতে পারেন। এটি করতে:

firebase remoteconfig:versions:list

function listAllVersions() {
  admin.remoteConfig().listVersions()
    .then((listVersionsResult) => {
      console.log("Successfully fetched the list of versions");
      listVersionsResult.versions.forEach((version) => {
        console.log('version', JSON.stringify(version));
      });
    })
    .catch((error) => {
      console.log(error);
    });
}

ListVersionsPage page = FirebaseRemoteConfig.getInstance().listVersionsAsync().get();
while (page != null) {
  for (Version version : page.getValues()) {
    System.out.println("Version: " + version.getVersionNumber());
  }
  page = page.getNextPage();
}

// Iterate through all versions. This will still retrieve versions in batches.
page = FirebaseRemoteConfig.getInstance().listVersionsAsync().get();
for (Version version : page.iterateAll()) {
  System.out.println("Version: " + version.getVersionNumber());
}

curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig:listVersions

টেমপ্লেটের তালিকায় সংরক্ষিত সমস্ত ভার্সনের মেটাডেটা অন্তর্ভুক্ত থাকে, যার মধ্যে রয়েছে আপডেটের সময়, যিনি এটি তৈরি করেছেন সেই ব্যবহারকারী এবং এটি কীভাবে তৈরি করা হয়েছে। এখানে একটি ভার্সন এলিমেন্টের উদাহরণ দেওয়া হলো:

```json
{
  "versions": [{
    "version_number": "6",
    "update_time": "2022-05-12T02:38:54Z",
    "update_user": {
      "name": "Jane Smith",
      "email": "jane@developer.org",
      "imageUrl": "https://lh3.googleusercontent.com/a-/..."
    },
    "description": "One small change on the console",
    "origin": "CONSOLE",
    "update_type": "INCREMENTAL_UPDATE"
  }]
}
```

Remote Config টেমপ্লেটের একটি নির্দিষ্ট সংস্করণ পুনরুদ্ধার করুন

আপনি Remote Config টেমপ্লেটের যেকোনো নির্দিষ্ট সংরক্ষিত সংস্করণ পুনরুদ্ধার করতে পারেন। একটি সংরক্ষিত টেমপ্লেট সংস্করণ পুনরুদ্ধার করার পদ্ধতি নিচে দেওয়া হলো:

firebase remoteconfig:get -v VERSION_NUMBER

// Get template version: 6
admin.remoteConfig().getTemplateAtVersion('6')
  .then((template) => {
    console.log("Successfully fetched the template with ETag: " + template.etag);
  })
  .catch((error) => {
    console.log(error);
  });

Template template = FirebaseRemoteConfig.getInstance().getTemplateAtVersionAsync(versionNumber).get();
// See the ETag of the fetched template.
System.out.println("Successfully fetched the template with ETag: " + template.getETag());

curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig?version_number=6

Remote Config টেমপ্লেটের একটি নির্দিষ্ট সংরক্ষিত সংস্করণে ফিরে যান

আপনি টেমপ্লেটের যেকোনো সংরক্ষিত সংস্করণে ফিরে যেতে পারেন। নিচে একটি টেমপ্লেট রোল ব্যাক করার পদ্ধতি দেওয়া হলো:

firebase remoteconfig:rollback -v VERSION_NUMBER

// Roll back to template version: 6
admin.remoteConfig().rollback('6')
  .then((template) => {
    console.log("Successfully rolled back to template version 6.");
    console.log("New ETag: " + template.etag);
  })
  .catch((error) => {
    console.log('Error trying to rollback:', e);
  })

try {
  Template template = FirebaseRemoteConfig.getInstance().rollbackAsync(versionNumber).get();
  System.out.println("Successfully rolled back to template version: " + versionNumber);
  System.out.println("New ETag: " + template.getETag());
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Error trying to rollback template.");
    System.out.println(rcError.getMessage());
  }
}

curl --compressed -D headers -H "Authorization: Bearer <var>token</var>" -H "Content-Type: application/json" -X POST https://firebaseremoteconfig.googleapis.com/v1/projects/<var>my-project-id</var>/remoteConfig:rollback -d '{"version_number": 6}'

Note that this rollback operation effectively creates a new numbered version. For example, rolling back from version 10 to version 6 effectively creates a new copy of version 6, differing from the original only in that its version number is 11. The original version 6 is still stored, assuming it has not reached its expiration, and version 11 becomes the active template.

একটি Remote Config টেমপ্লেট মুছে ফেলুন

আপনি Firebase কনসোল ব্যবহার করে Remote Config টেমপ্লেট ডিলিট করতে পারেন। নিচে একটি টেমপ্লেট ডিলিট করার পদ্ধতি দেওয়া হলো:

1. Firebase কনসোলে, DevOps & Engagement > Remote Config > Parameters পৃষ্ঠায় যান।

2. ক্লিক করুন history পরিবর্তন করুন ।

3. যে টেমপ্লেটটি মুছতে চান, সেটিতে টগল করুন, ক্লিক করুন। more_vert আরও , তারপর মুছুন নির্বাচন করুন।

4. মুছে ফেলার বিষয়টি নিশ্চিত করতে বলা হলে, ডিলিট-এ ক্লিক করুন।

Remote Config টেমপ্লেট ডাউনলোড এবং প্রকাশ করুন

Download and publish Remote Config templates to integrate them into your source control and build systems, automate config updates, and keep parameters and values in sync across multiple projects.

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

Let's say you have multiple projects that represent different stages of your software development lifecycle, like development, test, staging, and production environments. In this case, you could promote a fully-tested template from your staging environment to your production environment by downloading it from your staging project and publishing it to your production project.

আপনি এই পদ্ধতিটি ব্যবহার করে এক প্রজেক্ট থেকে অন্য প্রজেক্টে কনফিগারেশন স্থানান্তর করতে পারেন, অথবা কোনো প্রতিষ্ঠিত প্রজেক্ট থেকে প্যারামিটার ও ভ্যালু দিয়ে একটি নতুন প্রজেক্ট পূরণ করতে পারেন।

A/B Testing এক্সপেরিমেন্টে ভ্যারিয়েন্ট হিসেবে বিশেষভাবে তৈরি করা প্যারামিটার এবং প্যারামিটার ভ্যালুগুলো এক্সপোর্ট করা টেমপ্লেটে অন্তর্ভুক্ত করা হয় না।

Remote Config টেমপ্লেট রপ্তানি ও আমদানি করতে:

1. বর্তমান Remote Config টেমপ্লেটটি ডাউনলোড করুন ।
2. Remote Config টেমপ্লেটটি যাচাই করুন ।
3. Remote Config টেমপ্লেটটি প্রকাশ করুন ।

বর্তমান রিমোট কনফিগ টেমপ্লেটটি ডাউনলোড করুন

সক্রিয় Remote Config টেমপ্লেটটি JSON ফরম্যাটে ডাউনলোড করতে নিম্নলিখিতটি ব্যবহার করুন:

firebase remoteconfig:get -o filename

function getTemplate() {
  var config = admin.remoteConfig();
  config.getTemplate()
      .then(function (template) {
        console.log('ETag from server: ' + template.etag);
        var templateStr = JSON.stringify(template);
        fs.writeFileSync('config.json', templateStr);
      })
      .catch(function (err) {
        console.error('Unable to get template');
        console.error(err);
      });
}

Template template = FirebaseRemoteConfig.getInstance().getTemplateAsync().get();
// See the ETag of the fetched template.
System.out.println("ETag from server: " + template.getETag());

curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -o filename

রিমোট কনফিগ টেমপ্লেটটি যাচাই করুন

function validateTemplate(template) {
  admin.remoteConfig().validateTemplate(template)
      .then(function (validatedTemplate) {
        // The template is valid and safe to use.
        console.log('Template was valid and safe to use');
      })
      .catch(function (err) {
        console.error('Template is invalid and cannot be published');
        console.error(err);
      });
}

try {
  Template validatedTemplate = FirebaseRemoteConfig.getInstance()
          .validateTemplateAsync(template).get();
  System.out.println("Template was valid and safe to use");
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Template is invalid and cannot be published");
    System.out.println(rcError.getMessage());
  }
}

curl --compressed -H "Content-Type: application/json; UTF8" -H "If-Match: last-returned-etag" -H "Authorization: Bearer token" -X PUT https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig?validate_only=true -d @filename

function publishTemplate() {
  var config = admin.remoteConfig();
  var template = config.createTemplateFromJSON(
      fs.readFileSync('config.json', 'UTF8'));
  config.publishTemplate(template)
      .then(function (updatedTemplate) {
        console.log('Template has been published');
        console.log('ETag from server: ' + updatedTemplate.etag);
      })
      .catch(function (err) {
        console.error('Unable to publish template.');
        console.error(err);
      });
}

try {
  Template publishedTemplate = FirebaseRemoteConfig.getInstance()
          .publishTemplateAsync(template).get();
  System.out.println("Template has been published");
  // See the ETag of the published template.
  System.out.println("ETag from server: " + publishedTemplate.getETag());
} catch (ExecutionException e) {
  if (e.getCause() instanceof FirebaseRemoteConfigException) {
    FirebaseRemoteConfigException rcError = (FirebaseRemoteConfigException) e.getCause();
    System.out.println("Unable to publish template.");
    System.out.println(rcError.getMessage());
  }
}

curl --compressed -H "Content-Type: application/json; UTF8" -H "If-Match: last-returned-etag" -H "Authorization: Bearer token" -X PUT https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig -d @filename

Remote Config personalizations and conditions are included in downloaded templates, so it's important to be aware of the following limitations when attempting to publish to a different project:

• এক প্রজেক্ট থেকে অন্য প্রজেক্টে ব্যক্তিগতকরণ আমদানি করা যায় না।

  For example, if you have personalizations enabled in your project and download and edit a template, you can publish it to the same project, but you can't publish it to a different project unless you delete the personalizations from the template.

• শর্তাবলী এক প্রজেক্ট থেকে অন্য প্রজেক্টে ইম্পোর্ট করা যায়, কিন্তু মনে রাখবেন যে পাবলিশ করার আগে যেকোনো নির্দিষ্ট শর্তাধীন ভ্যালু (যেমন অ্যাপ আইডি বা অডিয়েন্স) টার্গেট প্রজেক্টে অবশ্যই বিদ্যমান থাকতে হবে।

  For example, if you have a Remote Config parameter that uses a condition that specifies a platform value of iOS , the template can be published to another project, because platform values are the same for any project. However, if it contains a condition that relies on a specific app ID or user audience that doesn't exist in the target project, validation will fail.

• আপনি যে টেমপ্লেটটি প্রকাশ করার পরিকল্পনা করছেন, তাতে যদি Google Analytics নির্ভর শর্ত থাকে, তাহলে টার্গেট প্রজেক্টটিতে Analytics অবশ্যই সক্রিয় থাকতে হবে।

Remote Config টেমপ্লেটের ডিফল্টগুলি ডাউনলোড করুন

Because your app may not always be connected to the Internet, you should configure client-side app default values for all Remote Config parameters. You should also periodically synchronize your app client default values and Remote Config backend default parameter values, because they may change over time.

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

আপনি এই ফাইলগুলো অ্যান্ড্রয়েড অ্যাপের জন্য XML ফরম্যাটে, iOS অ্যাপের জন্য প্রপার্টি লিস্ট (plist) ফরম্যাটে এবং ওয়েব অ্যাপের জন্য JSON ফরম্যাটে ডাউনলোড করতে পারেন।

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

টেমপ্লেট ডিফল্ট ধারণকারী ফাইলটি ডাউনলোড করার পদ্ধতি নিচে দেওয়া হলো:

curl --compressed -D headers -H "Authorization: Bearer token -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig:downloadDefaults?format=file_format'

আপনার অ্যাপে Remote Config ডিফল্ট মানগুলো ইম্পোর্ট করার বিষয়ে আরও তথ্যের জন্য, দেখুন:

• অ্যান্ড্রয়েডের জন্য অ্যাপের মধ্যে ডিফল্ট প্যারামিটার মান সেট করুন

• iOS-এর জন্য অ্যাপের মধ্যে ডিফল্ট প্যারামিটার মান সেট করুন

• ওয়েবের জন্য অ্যাপের মধ্যে ডিফল্ট প্যারামিটার মান সেট করুন

• ইউনিটির জন্য অ্যাপের মধ্যে ডিফল্ট প্যারামিটার মান সেট করুন

• C++ এর জন্য অ্যাপের মধ্যে ডিফল্ট প্যারামিটার মান সেট করুন