遠程配置參數和條件

當使用火力地堡控制台或遠程配置後端的API ，可以定義一個或多個參數（鍵值對），並為這些參數提供應用程序內的默認值。您可以通過定義服務器端參數值來覆蓋應用內默認值。參數鍵和參數值是字符串，但當您在應用程序中使用這些值時，可以將參數值轉換為其他數據類型。

使用火力地堡控制台或遠程配置REST API ，可以為您的參數，以及所使用的應用程序實例的目標群體條件值創建新的默認值。每次您在 Firebase 控制台中更新配置時，Firebase 都會創建並發布遠程配置模板的新版本。存儲以前的版本，允許您根據需要檢索或回滾。您也可以通過 REST API 使用這些操作。

本指南解釋了參數、條件、規則、條件值，以及如何在遠程配置服務器和您的應用程序中對各種參數值進行優先級排序。它還提供有關用於創建條件的規則類型的詳細信息。

條件、規則和條件值

條件用於定位一組應用程序實例。條件是由該都必須計算為一個或多個規則了true的情況，以評估true對一個給定的應用實例。如果規則中的值是不確定的（例如，當沒有可用的值），該規則將評估為false 。

例如，定義了一個應用程序的初始頁面的參數可以使用簡單的規則顯示基於OS類型不同的圖像if device_os = Android ：

或者，時間條件可以用來當你的應用程序顯示的特殊促銷品來控制。

一個參數可以有多個使用不同條件的條件值，並且參數可以在一個項目中共享條件。在參數標籤的火力地堡控制台，您可以查看每個參數的條件值的提取比例。此指標表示過去 24 小時內收到每個值的請求的百分比。

參數值優先級

一個參數可能有幾個與之關聯的條件值。以下規則確定從遠程配置服務器獲取哪個值，以及在特定時間點在給定應用程序實例中使用哪個值：

根據以下優先級列表獲取服務器端參數值

1. 首先，有條件的值應用，如果有任何一個評估為條件， true為給定的應用實例。如果多個條件評價為true ，第一（頂部）一個在火力地堡控制台UI中所示的優先級，並且當應用程序從後端獲取值被提供與該條件相關聯的條件的值。您可以通過拖動並在條件標籤下探條件發生變化的條件下的優先級。

2. 如果有與計算結果為條件沒有條件值true ，提供服務器端的默認值，當一個應用程序從後端獲取值。如果參數不會在後端存在，或者如果默認值設置為使用應用默認值，則沒有提供任何值該參數只有當應用的取值。

在您的應用程序，參數值由返回get方法根據下面的優先級列表

1. 如果從後端獲取值然後激活，則應用程序使用獲取的值。激活的參數值是持久的。
2. 如果沒有從後端獲取值，或者如果從遠程配置後端獲取的值尚未激活，則應用程序使用應用程序內默認值。
3. 如果沒有應用程式默認值已設置，則應用程序使用（如靜態類型值0為int和false為boolean ）。

此圖總結了遠程配置後端和您的應用程序中參數值的優先級：

參數值數據類型

遠程配置允許您為每個參數選擇數據類型，並在模板更新之前根據該類型驗證所有服務器端值。該數據類型被存儲並在返回getRemoteConfig請求。

目前支持的類型有：

• String
• Boolean
• Number
• JSON

在 Firebase 控制台 UI 中，可以從參數鍵旁邊的下拉列表中選擇數據類型。在REST API類型可以使用被設置value_type參數對象內場。

參數組

遠程配置允許您將參數組合在一起，以獲得更有條理的 UI 和思維模型。

例如，假設您在推出新的登錄功能時需要啟用或禁用三種不同的身份驗證類型。使用遠程配置，您可以創建三個參數以根據需要啟用類型，然後將它們組織在名為“新登錄”的組中，無需添加前綴或特殊排序。

您可以使用 Firebase 控制台或遠程配置 REST API 創建參數組。您創建的每個參數組在您的遠程配置模板中都有一個唯一的名稱。創建參數組時，請記住：

• 參數在任何時候都只能包含在一組中，並且參數鍵在所有參數中仍然必須是唯一的。
• 參數組名稱限制為 256 個字符。
• 如果您同時使用 REST API 和 Firebase 控制台，請確保更新任何 REST API 邏輯以處理髮佈時的參數組。

使用 Firebase 控制台創建或修改參數組

你可以在群組參數參數的火力地堡控制台選項卡。要創建或修改組：

1. 選擇管理組。
2. 為參數選擇複選框要添加並選擇移至組。
3. 選擇一個現有的組，或者通過輸入名稱和說明創建新組，並選擇創建新組。您保存一組後，可使用發布更改按鈕發布。

以編程方式創建組

在遠程配置REST API提供了一個自動化的方式來創建和發布的參數組。假設您熟悉 REST 並設置為授權對 API 的請求，您可以執行以下步驟以編程方式管理組：

1. 檢索當前模板
2. 添加 JSON 對象來表示您的參數組
3. 使用 HTTP PUT 請求發布參數組。

所述parameterGroups對象包含組密鑰，具有嵌套的描述和分組的參數的列表。請注意，每個組密鑰必須是全局唯一的。

例如，下面是一個模板修訂版帶有一個參數，添加參數組“新菜單”的摘錄pumpkin_spice_season ：

{
  "parameters": {},
  "version": {
    "versionNumber": "1",

    …


  },
  "parameterGroups": {
    "new menu": {
      "description": "New Menu",
      "parameters": {
        "pumpkin_spice_season": {
          "defaultValue": {
            "value": "true"
          },
          "description": "Whether it's currently pumpkin spice season."
        }
      }
    }
  }
}

條件規則類型

Firebase 控制台支持以下規則類型。等效的功能是遠程配置REST API中提供，如在詳細條件表達式參考。

搜索參數和條件

您可以搜索項目的參數鍵，參數值和條件，從火力地堡控制台使用搜索框在遠程配置參數選項卡的頂部。

參數和條件的限制

在 Firebase 項目中，您最多可以有 2000 個參數和 500 個條件。參數鍵最長可達 256 個字符，必須以下劃線或英文字母字符（AZ、az）開頭，還可以包含數字。項目中參數值字符串的總長度不能超過 800,000 個字符。

下一步

要開始配置你的火力地堡項目，請參閱設置了火力地堡遠程配置項目。