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

Bảng điều khiển Firebase

Trong thẻ Thông số, chọn "đồng hồ" biểu tượng 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ề. Chuyển qua '0' để tìm nạp tất cả cá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, chọn phiên bản đó từ trình đơn bên phải.

Bạn có thể xem điểm khác biệt chi tiết của phiên bản đang chọn và bất kỳ phiên bản nào khác phiên bản được lưu trữ bằng cách di chuột lên trình đơn theo bối cảnh đối với bất kỳ phiên bản nào chưa đượ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

Nếu muốn, bạn có thể ghi đầu ra vào một tệp được chỉ định bằng -o, FILENAME.

Node.js

Đạt getTemplate() mà không có bất kỳ đố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 toán tử GET; bạn không thể sử dụng mẫu này để chỉ định số phiên bản cho bản cập nhật. Nhận được tương tự yêu cầu mà không có ?version_number sẽ truy xuất mẫu 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 đây đủ điều kiện khôi phục, nút tuỳ chọn để khôi phục về phiên bản đó hiển thị ở trên cùng bên phải 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)

Để khôi phục về một mẫu Remote Config đã lưu trữ, hãy tạo một yêu cầu POST qua HTTP bằng phương thức tuỳ chỉnh :rollback và trong nội dung yêu cầu, phiên bản cụ thể để á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. Từ Remote Config Tham số hoặc điều kiện , mở more_vertTrình đơn và chọn 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, rồi chọn vị trí nơi bạn muốn lưu tệp, rồi 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à các 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, điều hướng đến và chọn Remote Config tệp mà bạn muốn xuất bản, rồi 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 tệp) mà 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.