遠端設定範本和版本管理


遠端設定範本是一組 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 控制台執行下列版本管理工作：

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

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

如有需要，您可以在 變更記錄 CANNOT TRANSLATE 存取遠端設定控制台

管理遠端設定範本版本

本節說明如何管理遠端設定的版本 範本。

列出遠端設定範本的所有已儲存版本

您可以使用 所有已儲存的遠端設定範本版本現在說明一下操作方式：

  1. 在 Firebase 控制台中開啟遠端設定。

  2. 接著，從 參數 分頁標籤，選取「時鐘」右上方的圖示。

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

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

擷取特定版本的遠端設定範本

您可以擷取 遠端設定範本的版本擷取儲存的範本 版本：

  1. 開啟應用程式的詳細資料窗格 變更記錄：

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

  3. 可查看使用中範本與任何其他已儲存版本的詳細差異 將滑鼠遊標懸停在任何未選取版本的內容選單上 並選取「與所選版本比較」。

將遠端設定範本復原至特定已儲存的版本

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

  1. 找到 變更記錄 頁面。除非您確定要復原至原始版本，否則請按一下確認這項操作 並為所有應用程式和使用者立即使用這些值。

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

刪除遠端設定範本

您可以透過 Firebase 控制台刪除遠端設定範本。目的地： 刪除遠端設定範本：

1. 使用遠端設定 參數 頁面，按一下 變更記錄：

  1. 切換到要刪除的範本，然後按一下 請選取 [更多]，然後選取 刪除。

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

下載並發布遠端設定範本

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

您可以下載目前有效的遠端設定範本 之後，您就能更新 匯出 JSON 檔案並發布至相同專案，或發布至新的專案， 現有專案

假設您有多個專案 分別代表了不同的應用程式階段 軟體開發的生命週期，例如開發、測試、測試和正式環境 環境在這個例子中，您可以把經過完整測試的範本 從 測試環境並發布至正式版專案。

您也可以使用這個方法將設定從一項專案遷移至 也可以用來自 專案。

專為以下項目建立的參數和參數值： 匯出的範本中沒有 A/B 測試實驗。

如何匯出及匯入遠端設定範本：

  1. 下載目前的遠端設定設定範本。
  2. 驗證遠端設定範本。
  3. 發布遠端設定範本。

下載目前的遠端設定範本

透過下列指令，下載有效的遠端設定範本： JSON 格式：

  1. 從 遠端設定參數或條件 開啟 「選單」， 選取「下載目前的設定檔」。
  2. 系統顯示提示時，請點選「下載設定檔」，選擇儲存位置 然後按一下「儲存」即可儲存檔案。

驗證遠端設定範本

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

發布遠端設定範本

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

發布範本後，系統會將整個現有設定範本替換成 更新 檔案，並將範本版本 1 遞增。由於整個 設定替換，如果您從 JSON 檔案刪除參數 該參數就會從伺服器中刪除，並且不再提供 。

發布後，參數和值的異動立即可用 為應用程式和使用者提供服務如有需要，您可以 復原為先前版本

使用下列指令發布範本：

  1. 從 遠端設定參數或條件 開啟「選單」分頁， 然後選取「透過檔案發布」。
  2. 系統提示時，按一下「Browse」(瀏覽)，瀏覽至並選取 要發布的遠端設定檔，然後按一下「選取」。
  3. 檔案會通過驗證，如果成功，你可以按一下 發布：將設定立即提供給 應用程式和使用者

後續步驟