升級至正式環境模式

本頁面說明如何在正式版 Android 應用程式中使用 Firebase Phone Number Verification。請參閱「開始使用 Android」指南，瞭解如何使用無 SIM 卡測試模式，在 Android 應用程式中測試 Firebase PNV。

啟用正式環境模式後，只要裝置具備支援的硬體和電信業者，應用程式就能在實際裝置上取得已驗證的電話號碼。

事前準備

  • 按照「開始使用 Android」指南中的步驟，實作及測試 Firebase PNV 使用者流程和後端整合。

  • 您必須以專案成員的身分登入 Firebase 控制台，並具備應用程式 Firebase 專案的擁有者權限。

  • 您必須在擁有的自訂網域上，提供可公開存取的首頁和隱私權政策，才能完成 OAuth 品牌驗證。您可以使用 Firebase Hosting 代管這些頁面，但必須連結自訂網域，因為品牌驗證不接受預設的 .web.app 和 .firebaseapp.com 網域。

1. 在應用程式用戶端停用測試模式

正式版用戶端不得呼叫 enableTestSession()。

如果您已按照「開始使用」一節操作，發布子版本就會略過 enableTestSession()，因為呼叫只會在偵錯版本中執行，而發布子版本會將 FPNV_TEST_TOKEN 設為空值。確認沒有任何發布子版本類型或變體設定 FPNV_TEST_TOKEN，並發布正式版用戶端。

如果您在其他地方呼叫 enableTestSession()，請從正式版用戶端中移除該呼叫：

Kotlin 

fpnv.enableTestSession(/* token */)  // Remove this.

您可以繼續建立非公開的應用程式用戶端開發版本，並呼叫 enableTestSession()。

請注意，您必須完成下一節的步驟，電話號碼驗證功能才能在正式環境運作。

2. 在專案中啟用正式版

請按照下列步驟，為 Firebase 專案啟用 Firebase PNV 正式環境模式：

  1. 設定 Firebase Phone Number Verification API 的 API 限制。

    1. 在 Google Cloud 控制台中，依序前往「APIs & Services」(API 和服務) >「Credentials」(憑證) 頁面

    2. 開啟 Android API 金鑰，並將 Firebase Phone Number Verification API 新增至所選 API 清單。

  2. 如果您尚未設定帳單資訊，請先進行設定。

    Firebase PNV 必須採用即付即用 Blaze 定價方案。如果尚未將專案升級至 Blaze 定價方案，系統會在設定正式環境模式時提示您升級。

  3. 如果您尚未指定應用程式的 SHA-256 指紋，請先完成這項操作。

    1. 在 Firebase 控制台中，依序前往「 Settings」(設定) >「General」(一般) 分頁。

    2. 向下捲動至「Your apps」(您的應用程式) 資訊卡，選取 Android 應用程式，然後在「SHA certificate fingerprints」(SHA 憑證指紋) 欄位中新增 SHA-256 指紋。

    如要瞭解如何取得應用程式的 SHA-256 指紋，請參閱「驗證用戶端」。

  4. 升級至正式環境模式。

    1. 在 Firebase 控制台中，依序前往 「Security」(安全性) >「Phone Verification」(電話驗證) > 「Overview」(總覽) 分頁標籤， 然後選取「Production」(正式環境)。

    2. 按一下「升級為正式環境」。

      您會看到專案中將啟用正式版的應用程式清單，並可新增其他應用程式。

    3. 您必須將應用程式送交 OAuth 品牌驗證和隱私權政策審查。Google Cloud會驗證您是否清楚準確地識別應用程式及其隱私權政策。

      如果您在 Firebase Hosting (或其他共用代管服務) 上託管首頁和隱私權政策，請務必：

      • 連結您控制的自訂網域 (例如 example.com 或您擁有的網域子網域)。.web.app 和 .firebaseapp.com 等共用代管網域無法通過網域擁有權檢查。
      • 在 Google Search Console 中，使用 DNS TXT 記錄將自訂網域驗證為網域資源 (而非網址前置字元資源)，並使用在 Google Cloud 專案中具備擁有者角色的帳戶登入。
      • 在 Google Auth Platform 中，使用自訂網域設定首頁網址、隱私權政策網址和授權網域，並確保首頁清楚顯示應用程式名稱、說明應用程式功能，以及提供隱私權政策連結。

      如要開始審查，請按一下「Proceed in Google Cloud」(在 Google Cloud 中繼續)。這項程序有時可能需要 24 小時以上。

    4. 等待品牌驗證期間，請詳閱 Firebase Phone Number Verification 服務專屬條款，相關連結位於 Firebase 控制台。

    5. 通過品牌驗證後，請勾選方塊，確認您同意服務專屬條款，然後按一下「啟用」。

      Firebase Phone Number Verification 現已在正式環境模式中啟用。