firebase-remote-config-basics

Remote Config

此技能提供在 Android 或 iOS 上開始使用 Remote Config 的完整指南。Remote Config 讓您無需發布應用程式更新，即可透過維護雲端設定範本來改變應用程式的行為和外觀。

先決條件

佈建 Remote Config 需要一個 Firebase 專案和一個 Firebase 應用程式（Android 或 iOS）。若要透過命令列管理 Remote Config 範本和條件，請使用 Firebase CLI。有關專案初始化的參考，請參閱 firebase-basics 技能。

執行疑難排解

處理 npx 403 禁止錯誤

如果 npx -y firebase-tools@latest 因註冊表權限問題（403 錯誤）而失敗：

1. 告知使用者：「我無法透過 npx 取得最新的 Firebase 工具，因為註冊表錯誤。」
2. 備援方案：如果使用者確認已全域安裝 Firebase CLI（npm install -g firebase-tools），則嘗試直接使用本機的 firebase 指令。

處理專案上下文問題

如果指令因「未選取有效專案」而失敗：

1. 檢查登入狀態：執行 npx -y firebase-tools@latest login:list。
2. 要求提供 ID：如果已登入但沒有啟用中的專案，請詢問使用者：「請提供您的 Firebase 專案 ID 以繼續。」
3. 使用旗標：在後續每個指令後加上 --project <PROJECT_ID>。

SDK 設定

若要了解如何在應用程式程式碼中設定 Remote Config，請選擇您的平台：

• Android：android_setup.md
• iOS：ios_setup.md

最佳做法與範本管理

請遵循以下指南並使用相關的 CLI 工具，以確保 Remote Config 的使用效率與安全性。

擷取策略

為最佳化應用程式效能與使用者體驗，請遵循以下建議模式（請參閱載入策略）：

• 為下次啟動載入新值：最有效的模式是在啟動時立即啟用先前擷取的值，並在背景擷取新值供下次使用。這可將使用者等待時間降至最低。
• 即時更新：使用 SDK 的即時監聽器，在伺服器端設定變更時立即更新應用程式，無需重新整理。

透過 CLI 管理範本

使用以下指令透過終端機管理 Remote Config 範本與版本歷史：

透過 CLI 管理範本

使用以下指令透過終端機管理 Remote Config 範本與版本歷史：

• 取得目前範本：將遠端範本儲存到本機 JSON 檔案，以便稽核或修改。

  npx -y firebase-tools@latest remoteconfig:get -o remote_config.json
  

• 自主編輯與探索：直接修改本機的 remote_config.json。判斷正確的訊號（例如 device.country 或 percent），並相應更新「conditions」陣列與「parameters」對應。

• 強制：使用者審查與驗證：在繼續部署前，請停止並要求使用者驗證您的變更。

  • 動作：告知使用者：「我已準備好 remote_config.json 中的變更。請檢查檔案的正確性。確認無誤後，請告訴我『deploy』以讓變更生效。」

• 部署協調：若要推送變更，您必須確保環境已設定為可部署。

  • 設定對應：如果缺少 firebase.json 檔案，請建立一個以將本機 JSON 對應到 Remote Config 服務：

    { "remoteconfig": { "template": "remote_config.json" } }
  

  • 部署：執行部分部署指令

    npx -y firebase-tools@latest deploy --only remoteconfig
    

• 驗證：部署後，透過列出版本歷史來驗證更新。

  npx -y firebase-tools@latest remoteconfig:versions:list
  

SDK 提供多項功能，讓您的應用程式更具動態性，並能回應不同使用者區隔。

• 設定應用程式內預設值：定義基準值，確保應用程式在離線或首次擷取前能正常運作。
• 擷取與啟用：從 Firebase 後端擷取值，並套用至本機 UI/邏輯。
• 範本管理：使用 Firebase CLI 進行版本控制、取得和部署您的設定 JSON 檔案。