从 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 网域添加到关联的网域功能。如果使用默认的 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. 向用户的电子邮件地址发送身份验证链接，其中包含将自定义网域作为 linkDomain 的已更新 ActionCodeSettings 对象。
  1. 您可以重复使用任何 Firebase Dynamic Links 网域作为自定义网域。不过，系统将不再支持任何 Firebase Dynamic Links 功能（例如，如果用户的设备上未安装应用，则无法将用户重定向到应用商店）。
  2. 向用户的电子邮件地址发送身份验证链接，其中包含将自定义网域作为 linkDomain 的已更新 ActionCodeSettings 对象。