將電子郵件連結登入功能從 Firebase Dynamic Links 遷移 (iOS)

電子郵件連結驗證功能先前仰賴 Firebase Dynamic Links，而這項服務將在 2025 年 8 月 25 日停用。我們已在 Firebase Authentication iOS SDK 11.8.0 以上版本中發布替代解決方案。如果您的應用程式使用 Firebase Dynamic Links，則應將應用程式遷移至新的 Firebase Hosting 架構系統。

將相關聯的 Firebase Dynamic Links 網域遷移至 Firebase Hosting 網域

往後，Firebase Authentication 將使用專案的 Firebase Hosting 預設網域，而非 Firebase Dynamic Links 網域，在行動應用程式中建立電子郵件連結和其他非頻道連結動作的連結。這表示您也必須更新應用程式，以便使用這個預設網域做為行動應用程式電子郵件驗證連結的關聯網域。

您可以按照「在 Apple 平台上使用電子郵件連結與 Firebase 進行驗證」中的指示，更新應用程式，以便使用新提供的自動配置 Firebase Hosting 預設網域。

請按照下列操作說明處理新網域的連結，並指示 Firebase Authentication 開始使用 Firebase Hosting 網域產生行動應用程式連結。

如果您想繼續使用任何自訂 Firebase Hosting 網域，甚至將自訂 Firebase Dynamic Links 網域設為新的關聯網域，請按照「自訂行動版連結」一節中的操作說明調整步驟，以便使用您要使用的網域。

  1. 將 Firebase Hosting 網域連結至應用程式關聯網域。

    您必須將所選網域設為應用程式連結的相關聯網域。如要在應用程式中設定授權，請在 Xcode 中開啟目標的「Signing & Capabilities」分頁，然後將上一個步驟中的 Firebase Hosting 網域新增至「Associated Domains」功能。如果使用預設的 Firebase Hosting 網域，則會是 applinks:PROJECT_ID.firebaseapp.com。

    詳情請參閱 Apple 說明文件網站上的「支援相關網域」。

    已在所有 Firebase Hosting 網域下部署相關網域檔案。如要存取該服務，請前往 PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association。這個 AASA 檔案可供覆寫；詳情請參閱「建立及代管通用連結設定檔」。

  2. 設定專案以使用新連結。

    準備好處理新網域連結時，您可以使用 Firebase Admin SDK 更新電子郵件連結產生方式，並指示後端開始使用新 Firebase Hosting 網域產生連結。

    const updateRequest = {
mobileLinksConfig: {
    domain: 'HOSTING_DOMAIN'
}
}
const updateProjectConfig = () => {
projectConfigManager.updateProjectConfig(updateRequest)
.then((response) => {
    // updated project config
}).catch((error) => {
    console.log('Error updating the project:', error);
});
}

  3. 傳送並兌換電子郵件連結。

    請按照先前的方式傳送電子郵件登入連結。使用者點選連結後，如果已安裝應用程式，系統會將他們重新導向至應用程式，以便完成登入程序。

您可以使用自訂 Firebase Hosting 網域，或重複使用自訂 Firebase Dynamic Links 網域，做為新的行動連結網域。

使用自訂 Firebase Hosting 網域

  1. 請按照Firebase Hosting指南設定自訂網域。
  2. 將自訂網域連結至應用程式關聯網域。
  3. 使用更新後的 ActionCodeSettings 物件 (其中包含自訂網域 linkDomain)，將驗證連結傳送至使用者的電子郵件地址。
  1. 您可以將任何 Firebase Dynamic Links 網域重複使用為自訂網域。不過，系統將不再支援任何 Firebase Dynamic Links 功能 (例如，如果裝置上未安裝應用程式，使用者就無法重新導向至應用程式商店)。
  2. 使用更新後的 ActionCodeSettings 物件 (其中包含自訂網域 linkDomain)，將驗證連結傳送至使用者的電子郵件地址。