遠端設定範本和版本控管

Remote Config 範本是為 Firebase 專案建立的 JSON 格式參數和條件集。Remote Config 可將設定整理成範本，方便您建立、更新、版本化及回溯範本。

視架構而定，您可以建立及管理用戶端範本、伺服器範本，或兩者皆是：

  • 用戶端範本： 在 Apple、Android、Web、Flutter、Unity 和 C++ 平台，為用戶端應用程式執行個體提供設定。用戶端範本支援以Google Analytics目標對象、應用程式版本、平台、裝置語言、國家/地區、使用者百分位數和自訂信號為依據的條件。

  • 伺服器範本： 使用 Node.js、Python、Go 和 Java 的 Firebase Admin SDK，為 Cloud Run、Cloud Functions for Firebase 或容器化伺服器等後端環境提供設定。伺服器範本會使用伺服器自訂信號和隨機百分比推出功能，在伺服器端評估參數，延遲時間接近零。

比較用戶端和伺服器範本

用戶端和伺服器範本會在 Firebase 專案中獨立維護。請參閱下表，瞭解用戶端和伺服器範本的差異：

功能 用戶端範本 伺服器範本
目標環境 用戶端應用程式 (Apple、Android、Web、Flutter、Unity、C++) 伺服器環境 (Cloud Run、Cloud Functions for Firebase、GKE、後端服務)
支援的 SDK Firebase 用戶端 SDK Firebase Admin SDK (Node.js、Python、Go、Java)
管理工具 Firebase 控制台、Firebase CLI、REST API、Firebase Admin SDK Firebase 控制台
控制台位置 參數 和 條件 參數 和 條件
下載範本預設值 支援 (Android 適用的 XML、iOS 適用的 PLIST、網頁適用的 JSON) 不適用 (伺服器程式碼或後端中定義的預設值)
詳細指南 管理用戶端範本 管理伺服器範本

範本生命週期和版本控管

無論您使用用戶端範本或伺服器範本，Remote Config 都提供內建的版本控管和生命週期管理功能：

建立及追蹤版本

每次更新參數或條件時，Remote Config 都會建立新的Remote Config範本版本，並將先前的範本儲存為版本，方便您視需要擷取或復原。版本號碼會從 Remote Config 儲存的初始值開始，依序遞增。

所有範本都包含 version 欄位，其中含有特定版本的中繼資料，例如：

  • versionNumber：範本的連續版本號碼。
  • updateTime：範本發布時的時間戳記。
  • updateUser：更新者的電子郵件地址或身分。
  • updateOrigin：變更方式 (例如 CONSOLE、 REST_API 或 ADMIN_SDK_NODE)。
  • updateType：變更性質 (例如 INCREMENTAL_UPDATE 或 FORCED_UPDATE)。

版本限制和保留期限

每個範本類型最多可儲存 300 個版本 (300 個用戶端範本和 300 個伺服器範本)，包括已刪除範本的儲存版本號碼。如果專案生命週期內，每個範本類型發布超過 300 個範本版本，系統會刪除最早的版本，將該類型版本數量維持在最多 300 個。

復原

您隨時可以復原範本的任何儲存版本。復原後，Remote Config 會建立新版本，內容與所選的歷史版本一致。舉例來說，如果從版本 10 回復至版本 6，系統會建立版本 11，並採用版本 6 的設定。

匯入及匯出

您可以將有效範本下載為 JSON 檔案，並發布至相同或另一個專案。這項功能可讓您：

  • 將範本定義儲存在原始碼控管系統 (例如 Git)。
  • 將設定部署作業整合至 CI/CD 管道。
  • 在各個階段 (例如從開發或測試專案到正式環境) 升級設定。
  • 在專案之間遷移設定。

在 A/B Testing 實驗中專門建立為變數的參數和參數值，不會納入匯出的範本。

範本預設值

對於用戶端應用程式，您可以下載 XML、PLIST 或 JSON 格式的檔案，其中包含參數預設值，以便與應用程式組合。如需操作說明，請參閱「下載 Remote Config 範本預設值」。

後續步驟