Firebase Remote Config 可讓您動態控管應用程式的行為和外觀,不必要求使用者下載應用程式更新,也不必重新部署後端。
如要設定應用程式,請在 Remote Config 中定義參數 (鍵/值組合),並在應用程式或後端程式碼中使用這些參數。您也可以定義條件 (指定目標規則),指派條件式值,針對特定目標對象、環境或自訂條件,覆寫預設值。
Remote Config 會將參數和條件彙整在範本中。 視架構而定,您可以使用用戶端範本、伺服器範本或兩者:
用戶端範本中的參數和條件: 在 Apple、Android、Web、 Flutter、Unity 和 C++ 平台,為用戶端應用程式執行個體提供設定。使用Google Analytics目標對象、應用程式版本、平台、裝置語言、國家/地區、使用者百分位數和用戶端自訂信號,指定應用程式例項。
伺服器範本中的參數和條件: 使用 Node.js、Python、Go 和 Java 的 Firebase Admin SDK,將設定提供給後端環境,例如 Cloud Run、Cloud Functions for Firebase 或容器化伺服器。使用伺服器自訂信號和隨機百分比推出功能,以趨近於零的延遲時間評估伺服器端的參數。
比較用戶端和伺服器範本
用戶端和伺服器範本適用於不同架構,並支援不同的 SDK 和指定目標規則。請參閱下表,瞭解哪種範本類型適合您的用途:
| 功能 | 用戶端範本 | 伺服器範本 |
|---|---|---|
| 目標環境 | 用戶端應用程式 (Apple、Android、Web、Flutter、Unity、C++) | 伺服器環境 (Cloud Run、Cloud Functions for Firebase、GKE、後端服務) |
| 支援的 SDK | Firebase 用戶端 SDK | Firebase Admin SDK (Node.js、Python、Go、Java) |
| 評估模型 | 在用戶端裝置上擷取及快取;由應用程式程式碼啟用 | 載入伺服器記憶體;以趨近於零的延遲時間評估每個要求 |
| 條件規則 | 應用程式版本、OS/平台、裝置語言、國家/區域、Analytics 目標對象和使用者屬性、隨機百分位數的使用者、應用程式初次開啟、用戶端自訂信號 | 隨機百分比中的使用者、伺服器自訂信號 |
| 常見用途 | 功能發布、季節性促銷活動、UI 主題、A/B Testing、個人化 | AI 提示和模型選取、伺服器端功能旗標、後端速率限制、動態路徑 |
| 詳細指南 | 用戶端範本中的參數 | 伺服器範本中的參數 |
核心概念
無論您使用用戶端範本或伺服器範本,Remote Config 都適用下列基本概念:
參數
參數是您在 Firebase 控制台中定義的鍵/值組合,或是使用Remote Config後端 API 定義的鍵/值組合。
- 參數鍵:參數的字串 ID。鍵的長度最多為 256 個半形字元,開頭須為底線或英文字母 (A-Z、a-z),且可包含數字。
- 參數值:指派給參數的值。值會儲存為字串,但您可以在控制台中選取資料類型,根據
String、Boolean、Number或JSON等格式驗證值。 - 預設值:未套用任何條件規則時,系統會指派的基準值。您可以在程式碼中定義應用程式內預設值,也可以在 Remote Config 後端定義範本預設值。
條件、規則和條件值
您可以透過條件,使用自訂參數值指定特定應用程式使用者區隔或伺服器要求:
- 規則:根據用戶端中繼資料或要求環境 (例如版本號碼、國家/地區或自訂信號) 評估的個別條件。
- 條件:一或多項規則的具名集合。條件中的所有規則都必須評估為
true,條件才會評估為true。 - 條件值:當條件評估結果為
true時,指派給參數的替代值。如果多個條件的評估結果為true,系統會優先採用 Firebase 控制台中優先順序最高的條件。
參數群組
如要整理含有數十或數百個參數的設定,可以使用參數群組。群組可在 Firebase 控制台中提供視覺化組織結構,並在 REST API 中提供邏輯分組。
- 一個參數一次只能隸屬於一個群組。
- 無論分組方式為何,專案中的參數鍵都會維持全域不重複。
- 分組不會改變 SDK 程式碼中參照參數值的方式。
如需建立及管理群組的操作說明,請參閱詳細的用戶端或伺服器參數指南。
範本版本管理與復原
每次在 Remote Config 中更新及發布參數或條件時,Firebase 都會建立並儲存新的範本版本。您可以查看版本記錄、比較不同版本之間的變更,並視需要復原至先前的版本。
如要進一步瞭解如何管理範本版本,請參閱「管理 Remote Config 範本版本」。
配額與限制
在 Firebase 專案中,Remote Config 會強制執行下列限制:
- 參數:每個專案最多 3,000 個參數。
- 條件:每個專案最多 2,000 個條件。
- 參數鍵長度:最多 256 個半形字元。
- 值字串總長度:專案中所有參數值加總最多 1,000,000 個字元。
如需完整限制清單,請參閱「配額與限制」。
後續步驟
- 用戶端應用程式:瞭解如何在用戶端範本中的參數和條件中設定參數、指定規則和優先順序。
- 伺服器應用程式:瞭解如何透過「伺服器範本中的參數和條件」設定伺服器參數、自訂信號和伺服器評估。
- 開始使用用戶端 SDK:按照「開始使用 Firebase Remote Config」指南,設定用戶端應用程式。
- 開始使用伺服器 SDK:按照「在伺服器環境中使用 Remote Config」指南設定後端環境。
- 自動更新:瞭解如何以程式輔助方式修改範本,請參閱「以程式輔助方式修改 Remote Config」。