遠端設定範本和版本管理


Remote Config 範本是您為 Firebase 專案建立的 JSON 格式參數和條件組合。個人中心 您可以建立用戶端範本,供應用程式從中擷取值,並且 server 範本,可供伺服器用戶端擷取值。

本節將說明伺服器範本。瞭解特定客戶 範本,點選 用戶端範本

使用 Firebase 控制台修改和管理範本,畫面會顯示 指定範本中以圖形格式呈現的內容 參數條件 標籤

以下是伺服器範本檔案的範例:

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "valueType": "JSON"
    },
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

您可以使用 Firebase 主控台執行以下版本管理工作:

  • 列出所有儲存的範本版本
  • 擷取特定版本
  • 復原至特定用戶端版本
  • 從「變更記錄」頁面刪除 Remote Config 範本

每個範本類型最多可以有 300 個生命週期儲存版本 (300 個用戶端範本和 300 個伺服器範本),其中包含 已刪除範本的版本號碼。超過 300 次 專案生命週期內每個範本類型的範本版本 系統會刪除最早的版本,但最多能保有 300 個版本 就可以選擇那些類型的物件

每次更新參數時,Remote Config 都會建立新版本的 Remote Config 範本,並將先前的範本儲存為版本,以便您視需要擷取或復原。版本編號會從 Remote Config 儲存的初始值依序遞增。所有範本皆包含 version 欄位 (如圖所示),其中包含該欄位的相關中繼資料 特定版本的 Pod

您可以視需要從 Remote Config 主控台的「變更記錄」頁面中刪除 Remote Config 範本。

管理 Remote Config 範本版本

本節說明如何管理 Remote Config 範本的版本。

列出「Remote Config」範本的所有已儲存版本

您可以使用 所有已儲存的版本 Remote Config 範本。現在說明一下操作方式:

  1. Firebase 控制台中開啟 Remote Config

  2. 接著,在「參數」分頁中選取右上角的「時鐘」圖示。

    系統隨即會開啟 變更記錄 頁面右側會列出所有儲存的範本版本。

    範本清單包含所有已儲存版本的中繼資料,包括 更新時間和編寫方式。

擷取特定版本的 Remote Config 範本

您可以擷取 Remote Config 範本版本。擷取儲存的範本 版本:

  1. 開啟「變更記錄」的詳細資料窗格。

  2. 如要查看清單中其他版本的詳細資料,請在右側選取所需版本 或前往 Google 試算表選單

  3. 如要查看有效範本和任何其他已儲存版本的詳細差異,請將滑鼠游標懸停在任何未選取版本的內容選單上,然後選取「Compare with selected version」

復原至 Remote Config 範本的特定儲存版本

您隨時可以復原至任何已儲存的 範本版本如何復原範本:

  1. 找到 變更記錄 頁面。只有在您確定要回溯至該版本,並且要立即為所有應用程式和使用者使用這些值時,才按一下並確認這項設定。

請注意,這項回溯作業會有效建立新的編號版本。例如,從第 10 版復原到第 6 版 建立新的版本 6 版本編號為 11原始版本 6 (假設尚未到期,以及版本 11) 會變成使用中的範本

刪除 Remote Config 範本

您可以從 Firebase 主控台刪除 Remote Config 範本。如要刪除 Remote Config 範本,請按照下列步驟操作:

1. 在 Remote Config「參數」頁面中,按一下 「變更記錄」
  1. 切換到要刪除的範本,然後按一下 請選取 [更多],然後選取 刪除

  2. 系統提示您確認刪除時,按一下「Delete」(刪除)

下載並發布Remote Config範本

下載並發布 Remote Config 範本,即可整合至 原始碼控制及建構系統、自動設定更新,以及保留參數 來同步多個專案的

您可以下載目前使用中的「Remote Config」範本 從 Firebase 控制台開始。 之後,您就能更新 匯出 JSON 檔案並發布至相同專案,或發布至新的專案, 現有專案

假設您有多個專案 分別代表了不同的應用程式階段 軟體開發的生命週期,例如開發、測試、測試和正式環境 環境在這種情況下,您可以從測試環境下載經過全面測試的範本,然後將其發布至實際工作環境,藉此將該範本推送至實際工作環境。

您也可以使用這個方法,將設定從一個專案遷移至另一個專案,或是使用已建立專案中的參數和值填入新專案。

專為以下項目建立的參數和參數值: 匯出的範本不含 A/B Testing 項實驗。

如何匯出及匯入 Remote Config 個範本:

  1. 下載目前的 Remote Config 設定範本
  2. 驗證 Remote Config 範本
  3. 發布 Remote Config 範本

下載目前的遠端設定範本

使用下列指令下載 Remote Config 中的有效範本: JSON 格式:

  1. Remote Config 參數或條件 開啟「選單」分頁,然後 選取「Download current config file」
  2. 系統提示時,請按一下「Download config file」,選擇檔案儲存位置,然後按一下「Save」

驗證遠端設定範本

當您嘗試從 Firebase 控制台。請注意,「隨機百分比」條件的使用者可以是 已匯入,但任何不支援的條件都會在上傳時產生錯誤。 如果您嘗試發布最初從用戶端範本匯出的範本,請務必先移除任何用戶端專屬條件。

發布「Remote Config」範本

下載範本後,對 JSON 內容進行必要變更 您就可以將其發布到專案

發布範本後,系統會以更新的檔案取代整個現有設定範本,並將範本版本增加 1。由於整個設定都會遭到取代,因此如果您從 JSON 檔案中刪除參數並發布,參數就會從伺服器中刪除,並且不再提供給用戶端。

發布後,應用程式和使用者就能立即使用參數和值的變更。如有需要,您可以 復原為先前版本

請使用下列指令發布範本:

  1. 在「Remote Config 參數或條件」分頁中,開啟 「選單」,然後選取「從檔案發布」
  2. 出現提示時,請按一下「Browse」,前往並選取要發布的 Remote Config 檔案,然後點選「Select」
  3. 檔案會通過驗證,如果成功,你可以按一下 發布:將設定立即提供給 應用程式和使用者

後續步驟