RemoteConfig class

Firebase RemoteConfig 服務介面。

簽名:

export declare class RemoteConfig 

屬性

屬性 修飾符 類型 說明
應用程式 應用程式

方法

方法 修飾符 說明
createTemplateFromJSON(json) 透過 JSON 字串建立並傳回新的遠端設定範本。
getServerTemplate(選項) ServerTemplate 執行個體化,然後擷取並快取最新的專案範本版本。
getTemplate() 取得專案 RemoteConfigTemplate 目前使用中的版本。
getTemplateAtVersion(versionNumber) 取得專案的 RemoteConfigTemplate 要求版本。
initServerTemplate(選項) 同步將 ServerTemplate 執行個體化。
listVersions(選項) 取得已發布的遠端設定範本版本清單,並按時間順序由新至舊排序。系統只會儲存最近 300 個版本。凡是對應至非使用中遠端設定範本的版本 (即用戶端擷取的範本除外),只要版本建立於超過 90 天,都會一併遭到刪除。
publishTemplate(template, options) 發布遠端設定範本。
rollback(versionNumber) 將專案的已發布遠端設定範本復原至指定版本。復原等同於取得先前發布的遠端設定範本,然後使用強制更新重新發布範本。
validateTemplate(範本) 驗證 RemoteConfigTemplate

RemoteConfig.app

簽名:

readonly app: App;

RemoteConfig.createTemplateFromJSON()

透過 JSON 字串建立並傳回新的遠端設定範本。

簽名:

createTemplateFromJSON(json: string): RemoteConfigTemplate;

參數

參數 類型 說明
json 字串 要填入遠端設定範本的 JSON 字串。

傳回:

RemoteConfigTemplate

新的範本執行個體。

RemoteConfig.getServerTemplate()

ServerTemplate 執行個體化,然後擷取並快取最新的專案範本版本。

簽名:

getServerTemplate(options?: GetServerTemplateOptions): Promise<ServerTemplate>;

參數

參數 類型 說明
選項 GetServerTemplateOptions

傳回:

Promise<ServerTemplate>

RemoteConfig.getTemplate()

取得專案 RemoteConfigTemplate 目前使用中的版本。

簽名:

getTemplate(): Promise<RemoteConfigTemplate>;

傳回:

Promise<RemoteConfigTemplate>

利用 RemoteConfigTemplate 實現的承諾。

RemoteConfig.getTemplateAtVersion()

取得專案的 RemoteConfigTemplate 要求版本。

簽名:

getTemplateAtVersion(versionNumber: number | string): Promise<RemoteConfigTemplate>;

參數

參數 類型 說明
版本號碼 數字 |字串 要查詢的遠端設定範本版本號碼。

傳回:

Promise<RemoteConfigTemplate>

利用 RemoteConfigTemplate 實現的承諾。

RemoteConfig.initServerTemplate()

同步將 ServerTemplate 執行個體化。

簽名:

initServerTemplate(options?: InitServerTemplateOptions): ServerTemplate;

參數

參數 類型 說明
選項 InitServerTemplateOptions

傳回:

ServerTemplate

RemoteConfig.listVersions()

取得已發布的遠端設定範本版本清單,並按時間順序由新至舊排序。系統只會儲存最近 300 個版本。凡是對應至非使用中遠端設定範本的版本 (即用戶端擷取的範本除外),只要版本建立於超過 90 天,都會一併遭到刪除。

簽名:

listVersions(options?: ListVersionsOptions): Promise<ListVersionsResult>;

參數

參數 類型 說明
選項 ListVersions 選項 用於取得版本清單的選用選項物件。

傳回:

Promise<ListVersionsResult>

利用 ListVersionsResult 實現的承諾。

RemoteConfig.publishTemplate()

發布遠端設定範本。

簽名:

publishTemplate(template: RemoteConfigTemplate, options?: {
        force: boolean;
    }): Promise<RemoteConfigTemplate>;

參數

參數 類型 說明
範本 RemoteConfigTemplate 要發布的遠端設定範本。
選項 { force: boolean;} 發布遠端設定範本時的選用選項物件:- force:如將這個值設為 true,系統就會強制更新及規避 ETag。我們不建議採用這種做法,因為如果多個用戶端更新遠端設定範本,遠端設定範本可能會遺失更新。請參閱「ETag 使用情形與強制更新」一節。

傳回:

Promise<RemoteConfigTemplate>

用已發布的 RemoteConfigTemplate 實現的承諾。

RemoteConfig.rollback()

將專案的已發布遠端設定範本復原至指定版本。復原等同於取得先前發布的遠端設定範本,然後使用強制更新重新發布範本。

簽名:

rollback(versionNumber: number | string): Promise<RemoteConfigTemplate>;

參數

參數 類型 說明
版本號碼 數字 |字串 要復原的遠端設定範本版本號碼。指定的版本號碼必須低於目前的版本號碼,且因過時程度而未刪除。系統只會儲存最近 300 個版本。凡是對應至非使用中遠端設定範本的版本 (也就是說,除了用戶端擷取的範本外的所有版本),且已建立超過 90 天,系統也會刪除這些版本。

傳回:

Promise<RemoteConfigTemplate>

能履行已發布的 RemoteConfigTemplate 的承諾。

RemoteConfig.validateTemplate()

驗證 RemoteConfigTemplate

簽名:

validateTemplate(template: RemoteConfigTemplate): Promise<RemoteConfigTemplate>;

參數

參數 類型 說明
範本 RemoteConfigTemplate 要驗證的遠端設定範本。

傳回:

Promise<RemoteConfigTemplate>

保證能履行驗證的 RemoteConfigTemplate