Remote Config 範本是您為 Firebase 專案建立的 JSON 格式參數和條件集。您可以建立用戶端範本 (應用程式會從中擷取值)，以及伺服器範本 (伺服器用戶端會從中擷取值)。
本節將討論伺服器範本。如要瞭解特定客戶的範本，請按一下「客戶範本」。您可以使用 Firebase 控制台修改及管理範本。依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定)，即可在「Parameters」(參數)和「Conditions」(條件)頁面中，以圖形格式查看範本內容。
以下是伺服器範本檔案的範例：
{
"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 控制台中執行這些版本管理工作 (依序前往「DevOps & Engagement」 >「Remote Config」)：
- 列出所有儲存的範本版本
- 擷取特定版本
- 復原至特定用戶端版本
- 從「變更記錄」頁面刪除 Remote Config 個範本。
每個範本類型最多可儲存 300 個版本 (300 個用戶端範本和 300 個伺服器範本)，包括已刪除範本的儲存版本號碼。如果專案生命週期內，每個範本類型發布的範本版本超過 300 個，系統會刪除最早的版本，將該類型的版本數量維持在最多 300 個。
每次更新參數時，Remote Config 都會建立新的版本化 Remote Config 範本，並將先前的範本儲存為版本，方便您視需要擷取或復原。版本號碼會從 Remote Config 儲存的初始值開始，依序遞增。如圖所示，所有範本都包含 version 欄位，其中含有特定版本的中繼資料。
您可以在 Firebase 控制台的「DevOps & Engagement」(DevOps 和參與度) >「Remote Config」(遠端設定) >「變更記錄」頁面視需要刪除 Remote Config 範本。
管理 Remote Config 範本版本
本節說明如何管理Remote Config範本版本。
列出 Remote Config 範本的所有儲存版本
您可以擷取 Remote Config 範本的所有儲存版本清單。步驟如下：
在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定) >「Parameters」(參數) 頁面。
選取右上方的「時鐘」圖示。
「變更記錄」頁面隨即開啟，右側的清單選單會列出所有儲存的範本版本。
範本清單會列出所有儲存版本的相關中繼資料，包括更新時間、更新者和更新方式。
擷取特定版本的 Remote Config 範本
您可以擷取 Remote Config 範本的任何特定儲存版本。 如要擷取儲存的範本版本，請按照下列步驟操作：
在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定) >「變更記錄」頁面。
根據預設，頁面會顯示目前有效的範本。如要查看其他版本，請在右側的詳細資料窗格中選取。
如要查看有效範本與任何其他儲存版本的詳細差異，請將游標懸停在任何未選取版本的內容選單上，然後選取「與所選版本比較」。
復原至 Remote Config 範本的特定儲存版本
您可以復原範本的任何儲存版本。如要復原範本，請按照下列步驟操作：
在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定) >「變更記錄」頁面。
在頁面右上角找到選項按鈕，即可查看可還原的舊版範本。
只有在確定要復原至該版本，並立即將這些值套用至所有應用程式和使用者時，才點選並確認。
請注意，這項回溯作業實際上會建立新的編號版本。舉例來說，從版本 10 復原至版本 6，實際上會建立版本 6 的新副本，與原始版本唯一的不同之處在於版本號碼為 11。假設原始版本 6 尚未過期，系統仍會儲存該版本，而版本 11 則會成為有效範本。
刪除 Remote Config 範本
您可以使用 Firebase 控制台刪除 Remote Config 範本。如要刪除範本，請按照下列步驟操作：
在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定) >「Parameters」(參數) 頁面。
切換至要刪除的範本，依序點選「更多」圖示
和「刪除」。 系統提示確認刪除時，請按一下「刪除」。
下載及發布 Remote Config 範本
下載並發布 Remote Config 範本，將其整合至來源控制和建構系統、自動更新設定，並確保多個專案的參數和值保持同步。
您可以透過程式輔助或從 Firebase 控制台，下載目前有效的 Remote Config 範本。 接著，您可以更新匯出的 JSON 檔案，並發布至相同專案，或發布至新專案或現有專案。
假設您有多個專案，分別代表軟體開發生命週期的不同階段，例如開發、測試、試行和實際工作環境。在這種情況下，您可以從暫存專案下載經過完整測試的範本，然後發布至正式專案，將範本從暫存環境升級至正式環境。
您也可以使用這個方法，將設定從一個專案遷移至另一個專案，或從現有專案將參數和值填入新專案。
在 A/B Testing 實驗中專門建立為變體的參數和參數值，不會納入匯出的範本。
如要匯出及匯入Remote Config範本，請按照下列步驟操作：
下載目前的遠端設定範本
使用下列指令，以 JSON 格式下載有效範本：Remote Config
在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定) >「Parameters」(參數) 或「Conditions」(條件) 頁面。
開啟「選單」
，然後選取「下載目前的設定檔」。 系統提示時，請按一下「下載設定檔」，選擇要儲存檔案的位置，然後按一下「儲存」。
驗證遠端設定範本
嘗試從Firebase控制台發布時，系統會驗證伺服器範本。請注意，系統可以匯入「隨機百分比中的使用者」條件，但如果條件不受支援，上傳時會產生錯誤。如果您要發布的範本是從用戶端範本匯出，請務必先移除所有用戶端專屬條件。
發布「Remote Config」範本
下載範本、對 JSON 內容進行必要變更並驗證後，即可發布至專案。
發布範本時，系統會以更新後的檔案取代整個現有設定範本，並將範本版本遞增 1。由於系統會取代整個設定，因此如果您從 JSON 檔案刪除參數並發布，系統就會從伺服器刪除該參數，用戶端也無法再使用。
發布後，參數和值的變更會立即套用至應用程式和使用者。如有必要，可以復原至先前版本。
請使用下列指令發布範本：
在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定) >「Parameters」(參數) 或「Conditions」(條件) 頁面。
開啟「選單」
，然後選取「從檔案發布」。 出現提示時，按一下「瀏覽」，然後前往並選取要發布的 Remote Config 檔案，再按一下「選取」。
系統會驗證檔案，如果驗證成功，您可以按一下「發布」，讓應用程式和使用者立即使用設定。