תבניות תצורה מרוחקות וניהול גרסאות

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

Java

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

Java

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

פרמטר כתובת האתר ?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);
  })

Java

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

Java

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

Java

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

מנוחה

אמת עדכוני תבנית על ידי הוספת פרמטר כתובת אתר ?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);
      });
}

Java

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. כאשר תתבקש, לחץ על לחצן הבחירה המתאים לפורמט הקובץ שברצונך להוריד ולאחר מכן לחץ על הורד קובץ .