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

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 API، أو من التراجع، أو ما إذا كانت تغييرات تدريجية من الحفظ الإجباري للقالب.

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. من علامة التبويب "معلمات أو شروط التكوين عن بعد" ، افتح قائمة more_vert وحدد تنزيل ملف التكوين الحالي .
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

إذا تم التحقق من صحة القالب الخاص بك بنجاح، فسيقوم أمر الضفيرة بإرجاع قالب 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. من علامة التبويب "معلمات أو شروط التكوين عن بعد" ، افتح قائمة 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. عندما يُطلب منك ذلك، انقر فوق زر الاختيار الذي يتوافق مع تنسيق الملف الذي تريد تنزيله، ثم انقر فوق تنزيل الملف .