Thông số và điều kiện của Cấu hình từ xa

Firebase Remote Config cho phép bạn kiểm soát linh hoạt hành vi và giao diện của các ứng dụng mà không cần người dùng tải bản cập nhật ứng dụng xuống hoặc yêu cầu triển khai lại phần phụ trợ.

Để định cấu hình các ứng dụng, bạn xác định các thông số (cặp khoá-giá trị) trong Remote Config và sử dụng các thông số đó trong ứng dụng hoặc mã phụ trợ. Bạn cũng có thể xác định điều kiện (quy tắc nhắm mục tiêu) để chỉ định giá trị có điều kiện ghi đè giá trị mặc định cho đối tượng, môi trường hoặc tiêu chí tuỳ chỉnh cụ thể.

Remote Config sắp xếp các tham số và điều kiện thành mẫu. Tuỳ thuộc vào cấu trúc của mình, bạn có thể sử dụng mẫu phía máy khách, mẫu phía máy chủ hoặc cả hai:

  • Các tham số và điều kiện trong mẫu ứng dụng: Phân phát cấu hình cho các phiên bản ứng dụng trên nền tảng Apple, Android, Web, Flutter, Unity và C++. Nhắm đến các phiên bản ứng dụng bằng cách sử dụng đối tượng Google Analytics, phiên bản ứng dụng, nền tảng, ngôn ngữ thiết bị, quốc gia, phân vị người dùng và tín hiệu tuỳ chỉnh phía máy khách.

  • Các tham số và điều kiện trong mẫu phía máy chủ: Phân phát cấu hình cho các môi trường phụ trợ như Cloud Run, Cloud Functions for Firebase hoặc các máy chủ có chứa vùng chứa bằng cách sử dụng Firebase Admin SDK cho Node.js, Python, Go và Java. Đánh giá các tham số phía máy chủ với độ trễ gần như bằng 0 bằng cách sử dụng tín hiệu tuỳ chỉnh của máy chủ và các bản phát hành theo tỷ lệ phần trăm ngẫu nhiên.

So sánh mẫu phía máy khách và mẫu phía máy chủ

Mẫu phía máy khách và mẫu phía máy chủ phục vụ cho các cấu trúc khác nhau và hỗ trợ các SDK cũng như quy tắc nhắm mục tiêu riêng biệt. Hãy tham khảo bảng sau đây để biết loại mẫu nào phù hợp với trường hợp sử dụng của bạn:

Tính năng Mẫu khách hàng Mẫu máy chủ
Môi trường mục tiêu Ứng dụng khách (Apple, Android, Web, Flutter, Unity, C++) Môi trường máy chủ (Cloud Run, Cloud Functions for Firebase, GKE, dịch vụ phụ trợ)
Các SDK được hỗ trợ Firebase SDK cho ứng dụng Firebase Admin SDK (Node.js, Python, Go, Java)
Mô hình đánh giá Được tìm nạp và lưu vào bộ nhớ đệm trên các thiết bị của khách hàng; được kích hoạt bằng mã ứng dụng Được tải vào bộ nhớ máy chủ; được đánh giá theo từng yêu cầu với độ trễ gần bằng 0
Quy tắc điều kiện Phiên bản ứng dụng, hệ điều hành/nền tảng, ngôn ngữ thiết bị, quốc gia/khu vực, Analytics đối tượng và thuộc tính người dùng, người dùng ở phân vị ngẫu nhiên, lần mở ứng dụng đầu tiên, tín hiệu tuỳ chỉnh của ứng dụng Người dùng ở tỷ lệ phần trăm ngẫu nhiên, tín hiệu tuỳ chỉnh của máy chủ
Các trường hợp sử dụng phổ biến Triển khai tính năng, chương trình khuyến mãi theo mùa, giao diện người dùng, A/B Testing, Cá nhân hoá Lựa chọn mô hình và câu lệnh AI, cờ tính năng phía máy chủ, giới hạn tốc độ phụ trợ, định tuyến linh động
Hướng dẫn chi tiết Tham số trong mẫu ứng dụng Tham số trong mẫu máy chủ

Các khái niệm cốt lõi

Cho dù bạn làm việc với mẫu phía máy khách hay mẫu phía máy chủ, Remote Configđều có các khái niệm cơ bản sau:

Thông số

Các tham số là cặp khoá-giá trị mà bạn xác định trong bảng điều khiển Firebase hoặc bằng cách sử dụng Remote Config API phần phụ trợ.

  • Khoá tham số: Giá trị nhận dạng chuỗi cho các tham số của bạn. Khoá có thể dài tối đa 256 ký tự, phải bắt đầu bằng dấu gạch dưới hoặc ký tự chữ cái tiếng Anh (A-Z, a-z) và có thể chứa các chữ số.
  • Giá trị tham số: Giá trị được chỉ định cho các tham số của bạn. Các giá trị được lưu trữ dưới dạng chuỗi, nhưng bạn có thể chọn các loại dữ liệu trong bảng điều khiển để xác thực các giá trị theo các định dạng như String, Boolean, Number hoặc JSON.
  • Giá trị mặc định: Giá trị cơ sở được chỉ định khi không có quy tắc điều kiện nào được áp dụng. Bạn có thể xác định các giá trị mặc định trong ứng dụng trong mã của mình, cũng như các giá trị mặc định của mẫu trong phần phụ trợ Remote Config.

Điều kiện, quy tắc và giá trị có điều kiện

Điều kiện cho phép bạn nhắm đến các phân khúc người dùng ứng dụng hoặc yêu cầu máy chủ cụ thể bằng các giá trị tham số tuỳ chỉnh:

  • Quy tắc: Các tiêu chí riêng lẻ được đánh giá dựa trên siêu dữ liệu của ứng dụng hoặc ngữ cảnh yêu cầu (chẳng hạn như số phiên bản, quốc gia hoặc tín hiệu tuỳ chỉnh).
  • Điều kiện: Tập hợp có tên của một hoặc nhiều quy tắc. Tất cả các quy tắc trong một điều kiện phải đánh giá thành true thì điều kiện đó mới đánh giá thành true.
  • Giá trị có điều kiện: Giá trị thay thế được chỉ định cho một tham số khi một điều kiện đánh giá thành true. Nếu nhiều điều kiện được đánh giá là true, thì điều kiện có mức độ ưu tiên cao nhất trong bảng điều khiển Firebase sẽ được ưu tiên.

Nhóm tham số

Để sắp xếp các cấu hình có hàng chục hoặc hàng trăm thông số, bạn có thể sử dụng nhóm thông số. Các nhóm cung cấp thông tin tổ chức trực quan trong bảng điều khiển Firebase và nhóm logic trong API REST.

  • Tại một thời điểm, mỗi thông số chỉ có thể thuộc về một nhóm.
  • Các khoá tham số vẫn duy nhất trên toàn cầu trong dự án của bạn, bất kể việc nhóm.
  • Việc nhóm không làm thay đổi cách các giá trị tham số được tham chiếu trong mã SDK của bạn.

Để biết hướng dẫn về cách tạo và quản lý nhóm, hãy xem hướng dẫn chi tiết về các tham số máy khách hoặc máy chủ.

Kiểm soát phiên bản và khôi phục mẫu

Mỗi khi bạn cập nhật và xuất bản các thông số hoặc điều kiện trong Remote Config, Firebase sẽ tạo và lưu trữ một phiên bản mới của mẫu. Bạn có thể xem nhật ký phiên bản, so sánh các thay đổi giữa các phiên bản và khôi phục về một phiên bản trước đó bất cứ khi nào cần.

Để tìm hiểu thêm về cách quản lý phiên bản mẫu, hãy xem bài viết Quản lý phiên bản mẫu Remote Config.

Hạn mức và giới hạn

Trong một dự án Firebase, Remote Config áp dụng các hạn mức sau:

  • Tham số: Tối đa 3.000 tham số cho mỗi dự án.
  • Điều kiện: Tối đa 2.000 điều kiện cho mỗi dự án.
  • Độ dài khoá tham số: Tối đa 256 ký tự.
  • Tổng độ dài chuỗi giá trị: Tối đa 1.000.000 ký tự trên tất cả các giá trị tham số trong một dự án.

Để xem danh sách đầy đủ các hạn mức, hãy xem phần Hạn mức và giới hạn.

Các bước tiếp theo