Tạo phiên bản và mẫu Cấu hình từ xa

Bảng điều khiển Firebase

Trong thẻ Parameters (Thông số), chọn biểu tượng "đồng hồ" hiển thị ở trên cùng bên phải. Thao tác này sẽ mở trang Nhật ký thay đổi liệt kê tất cả các phiên bản mẫu được lưu trữ trong trình đơn danh sách ở bên phải.

Thông tin chi tiết hiển thị cho mỗi phiên bản được lưu trữ bao gồm thông tin về việc các thay đổi có bắt nguồn từ Console, API REST, từ một thao tác khôi phục hay không, hoặc liệu đó có phải là các thay đổi gia tăng từ một thao tác lưu bắt buộc của mẫu hay không.

Firebase CLI

firebase remoteconfig:versions:list

Sử dụng tuỳ chọn --limit để giới hạn số lượng phiên bản được trả về. Truyền "0" để tìm nạp tất cả phiên bản.

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

Kiến trúc chuyển trạng thái đại diện (REST)

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

Bảng điều khiển Firebase

Theo mặc định, ngăn chi tiết trong thẻ Nhật ký thay đổi sẽ hiển thị mẫu đang hoạt động. Để xem thông tin chi tiết về một phiên bản khác trong danh sách, hãy chọn phiên bản đó trong trình đơn bên phải.

Bạn có thể xem thông tin chi tiết về sự khác biệt giữa phiên bản hiện đang chọn và mọi phiên bản khác được lưu trữ bằng cách di chuột qua trình đơn theo bối cảnh cho mọi phiên bản không được chọn rồi chọn So sánh với phiên bản đã chọn.

Firebase CLI

firebase remoteconfig:get -v VERSION_NUMBER

Bạn có thể ghi kết quả vào một tệp đã chỉ định bằng -o, FILENAME (không bắt buộc).

Node.js

Truyền getTemplate() mà không có đối số nào để truy xuất phiên bản mới nhất của mẫu hoặc để truy xuất một phiên bản cụ thể, hãy sử dụng 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());

Kiến trúc chuyển trạng thái đại diện (REST)

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

Tham số URL ?version_number chỉ hợp lệ cho các thao tác GET; bạn không thể sử dụng tham số này để chỉ định số phiên bản cho bản cập nhật. Một yêu cầu get tương tự mà không có tham số ?version_number sẽ truy xuất mẫu đang hoạt động hiện tại.

Bảng điều khiển Firebase

Đối với các phiên bản mẫu trước đó đủ điều kiện để khôi phục, một nút tuỳ chọn để khôi phục về phiên bản đó sẽ xuất hiện ở trên cùng bên phải của trang Nhật ký thay đổi. Chỉ nhấp và xác nhận việc này nếu bạn chắc chắn muốn quay lại phiên bản đó và sử dụng các giá trị đó ngay lập tức cho tất cả ứng dụng và người dùng.

Firebase CLI

firebase remoteconfig:rollback -v VERSION_NUMBER

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

Kiến trúc chuyển trạng thái đại diện (REST)

Để quay lại mẫu Remote Config đã lưu trữ, hãy đưa ra một yêu cầu POST HTTP bằng phương thức tuỳ chỉnh :rollback và trong phần nội dung yêu cầu, phiên bản cụ thể cần áp dụng. Ví dụ:

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

Phản hồi chứa nội dung của mẫu được lưu trữ hiện đang hoạt động, cùng với siêu dữ liệu phiên bản mới.

Bảng điều khiển Firebase

1. Trên thẻ Remote Config Parameters or Conditions (Thông số hoặc điều kiện Remote Config), hãy mở more_vertMenu (Trình đơn) rồi chọn Download current config file (Tải tệp cấu hình hiện tại xuống).
2. Khi được nhắc, hãy nhấp vào Tải tệp cấu hình xuống, chọn vị trí bạn muốn lưu tệp, sau đó nhấp vào Lưu.

Firebase CLI

firebase remoteconfig:get -o filename

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

Kiến trúc chuyển trạng thái đại diện (REST)

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

Lệnh này xuất tải trọng JSON vào một tệp và tiêu đề (bao gồm cả ETag) vào một tệp headers riêng.

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

Kiến trúc chuyển trạng thái đại diện (REST)

Xác thực nội dung cập nhật mẫu bằng cách thêm tham số URL ?validate_only=true vào yêu cầu phát hành:

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

Nếu mẫu của bạn đã được xác thực thành công, lệnh curl sẽ trả về mẫu JSON mà bạn đã gửi và trong tệp headers đã lưu, bạn sẽ thấy trạng thái HTTP/2 200 và ETag đã cập nhật có hậu tố -0. Nếu mẫu của bạn không được xác thực, bạn sẽ nhận được lỗi xác thực trong phản hồi JSON và tệp headers sẽ chứa phản hồi không phải 200 (và không có ETag).

Bảng điều khiển Firebase

1. Trên thẻ Remote Config Tham số hoặc điều kiện, hãy mở more_vertTrình đơn, rồi chọn Xuất bản từ tệp.
2. Khi được nhắc, hãy nhấp vào Duyệt qua, chuyển đến và chọn tệp Remote Config mà bạn muốn phát hành, sau đó nhấp vào Chọn.
3. Tệp sẽ được xác thực và nếu thành công, bạn có thể nhấp vào Xuất bản để cung cấp ngay cấu hình cho ứng dụng và người dùng.

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

Kiến trúc chuyển trạng thái đại diện (REST)

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

Đối với lệnh curl này, bạn có thể chỉ định nội dung bằng cách sử dụng ký tự "@", theo sau là tên tệp.

Kiến trúc chuyển trạng thái đại diện (REST)

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

Sử dụng XML, PLIST hoặc JSON làm giá trị format, tuỳ thuộc vào định dạng tệp bạn muốn tải xuống.

Bảng điều khiển Firebase

1. Trong thẻ Parameters (Thông số), hãy mở more_vertMenu (Trình đơn) rồi chọn Download default values (Tải giá trị mặc định xuống).
2. Khi được nhắc, hãy nhấp vào nút chọn tương ứng với định dạng tệp bạn muốn tải xuống, sau đó nhấp vào Tải tệp xuống.