قوالب التكوين عن بعد وتعيين الإصدار

Node.js

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

وحدة تحكم Firebase

في علامة التبويب "المعلمات" ، حدد رمز "الساعة" المعروض أعلى اليسار. يؤدي هذا إلى فتح صفحة سجل التغييرات التي تسرد جميع إصدارات القوالب المخزنة في قائمة قائمة على اليمين.

تتضمن التفاصيل المعروضة لكل إصدار مخزن معلومات حول ما إذا كانت التغييرات قد نشأت باستخدام وحدة التحكم أم بواجهة برمجة تطبيقات REST أم من التراجع أو ما إذا كانت تغييرات إضافية من حفظ إجباري للقالب.

Firebase CLI

firebase remoteconfig:versions:list

استخدم الخيار --limit للحد من عدد الإصدارات التي يتم إرجاعها. مرر "0" لجلب جميع الإصدارات.

Node.js

قم بتمرير getTemplate() بدون أي وسيطات لاسترداد أحدث إصدار من القالب ، أو لاسترداد إصدار معين ، استخدم getTemplateAtVersion() .

// 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

معلمة URL ?version_number صالحة فقط لعمليات GET ؛ لا يمكنك استخدامه لتحديد أرقام الإصدارات للتحديثات. طلب الحصول على مشابه بدون المعلمة ?version_number يمكن أن يسترد القالب النشط الحالي.

وحدة تحكم Firebase

بشكل افتراضي ، يعرض جزء التفاصيل في علامة التبويب سجل التغييرات القالب النشط الحالي. لعرض تفاصيل إصدار آخر في القائمة ، حدده من القائمة اليمنى.

يمكنك عرض فرق تفصيلي للإصدار المحدد حاليًا وأي إصدار مخزن آخر بالمرور فوق قائمة السياق لأي إصدار غير محدد وتحديد مقارنة بالإصدار المحدد.

Firebase CLI

firebase remoteconfig:get -v VERSION_NUMBER

اختياريًا ، يمكنك كتابة الإخراج إلى ملف محدد باستخدام -o, FILENAME .

Node.js

// 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());
  }
}

استراحة

للرجوع إلى قالب تكوين عن بُعد مخزن ، قم بإصدار HTTP POST بالطريقة المخصصة :rollback ، وفي نص الطلب ، الإصدار المحدد المراد تطبيقه. على سبيل المثال:

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}'

تحتوي الاستجابة على محتويات القالب المخزن النشط الآن ، مع بياناته الأولية للإصدار الجديد.

وحدة تحكم Firebase

بالنسبة لإصدارات القوالب السابقة المؤهلة للتراجع ، يتم عرض زر خيار للعودة إلى هذا الإصدار في أعلى يمين صفحة سجل التغييرات . انقر فوق هذا الخيار وأكده فقط إذا كنت متأكدًا من أنك تريد الرجوع إلى هذا الإصدار واستخدام هذه القيم على الفور لجميع التطبيقات والمستخدمين.

Firebase CLI

firebase remoteconfig:rollback -v VERSION_NUMBER

Node.js

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

يقوم هذا الأمر بإخراج حمولة JSON إلى ملف واحد ، والرؤوس (بما في ذلك ETag) إلى ملف headers منفصل.

وحدة تحكم Firebase

1. من علامة التبويب Remote Config Parameters أو Terms ، افتح قائمة more_vert وحدد Download current config file .
2. عند المطالبة ، انقر فوق تنزيل ملف التكوين ، واختر الموقع الذي تريد حفظ الملف فيه ، ثم انقر فوق حفظ .

Firebase CLI

firebase remoteconfig:get -o filename

Node.js

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());
  }
}

استراحة

تحقق من صحة تحديثات النموذج من خلال إلحاق معلمة URL ?validate_only=true لطلب النشر الخاص بك:

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

إذا تم التحقق من نموذجك بنجاح ، فسيعيد الأمر curl قالب JSON الذي أرسلته ، وفي ملف headers المحفوظ ، ستجد حالة HTTP / 2 200 و ETag محدث مع اللاحقة -0 . إذا لم يتم التحقق من صحة القالب الخاص بك ، فستتلقى خطأ التحقق في استجابة JSON وسيحتوي ملف headers على استجابة بخلاف 200 (وليس هناك ETag).

Node.js

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

بالنسبة لأمر curl هذا ، يمكنك تحديد المحتوى باستخدام الحرف "@" ، متبوعًا باسم الملف.

وحدة تحكم Firebase

1. من علامة التبويب Remote Config Parameters أو Terms ، افتح قائمة more_vert ، وحدد نشر من ملف .
2. عند المطالبة ، انقر فوق "استعراض" ، وانتقل إلى ملف "التكوين البعيد" الذي تريد نشره وحدده ، ثم انقر فوق "تحديد" .
3. سيتم التحقق من صحة الملف ، وفي حالة نجاحه ، يمكنك النقر فوق "نشر" لإتاحة التكوين على الفور لتطبيقاتك ومستخدميك.

استراحة

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

استخدم XML أو PLIST أو JSON كقيمة format ، بناءً على تنسيق الملف الذي تريد تنزيله.

وحدة تحكم Firebase

1. في علامة التبويب المعلمات ، افتح قائمة more_vert ، وحدد تنزيل القيم الافتراضية .
2. عند المطالبة ، انقر فوق زر الاختيار الذي يتوافق مع تنسيق الملف الذي تريد تنزيله ، ثم انقر فوق تنزيل الملف .