以下是我们在 I/O 大会上宣布的所有内容，从新的 Firebase Studio 功能到集成 AI 的更多方式，内容非常丰富。阅读博客。

使用电子邮件链接进行 Firebase 身份验证 (Android)

借助 Firebase Authentication，您可以向用户发送包含链接的电子邮件，让用户点击此链接进行登录。在此过程中，用户的电子邮件地址也会得到验证。

通过电子邮件登录的好处有很多：

提供顺畅的注册和登录体验。
降低在不同应用中重复使用密码的风险。即使是精心挑选的密码，如果重复使用，安全性也会受到影响。
能够在验证用户身份的同时，验证用户的确是电子邮件地址的合法所有者。
用户只需一个可访问的电子邮件账号即可登录，不需要拥有电话号码或社交媒体账号。
用户可以安全地登录，而无需提供（或记住）密码。在移动设备上，输密码可能很不方便。
此前使用电子邮件标识符（密码或联合登录服务）登录的现有用户可以升级为仅使用电子邮件登录。例如，用户即使忘记密码也仍可登录，无需重置密码。

准备工作

设置 Android 项目

将 Firebase 添加到您的 Android 项目（如果尚未添加）。
在模块（应用级）Gradle 文件（通常是 <project>/<app-module>/build.gradle.kts 或 <project>/<app-module>/build.gradle）中，添加 Firebase Authentication 库的依赖项。我们建议使用 Firebase Android BoM 来实现库版本控制。

此外，在设置 Firebase Authentication 时，您还需要将 Google Play 服务 SDK 添加到您的应用中。
```
dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.16.0"))

    // Add the dependency for the Firebase Authentication library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-auth")

    // Also add the dependency for the Google Play services library and specify its version
    implementation("com.google.android.gms:play-services-auth:21.3.0")
}
```
借助 Firebase Android BoM，可确保您的应用使用的始终是 Firebase Android 库的兼容版本。
（替代方法）在不使用 BoM 的情况下添加 Firebase 库依赖项

如果您选择不使用 Firebase BoM，则必须在每个 Firebase 库的依赖项行中指定相应的库版本。

请注意，如果您在应用中使用多个 Firebase 库，我们强烈建议您使用 BoM 来管理库版本，从而确保所有版本都兼容。
```
dependencies {
    // Add the dependency for the Firebase Authentication library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-auth:23.2.1")

    // Also add the dependency for the Google Play services library and specify its version
    implementation("com.google.android.gms:play-services-auth:21.3.0")
}
```
是否想要查找 Kotlin 专用的库模块？ 从 2023 年 10 月 (Firebase BoM 32.5.0) 开始，Kotlin 和 Java 开发者可以依赖于主库模块（如需了解详情，请参阅关于此计划的常见问题解答）。

为了让用户能够通过邮件链接登录，您必须先为 Firebase 项目启用邮件服务提供商和邮件链接登录方法，操作步骤如下：

在 Firebase 控制台中，打开 Auth 部分。
在 Sign in method（登录方法）标签页中，启用电子邮件地址/密码提供方。请注意，必须启用电子邮件地址/密码登录才能使用电子邮件链接登录流程。
在同一部分中，启用电子邮件链接（无密码登录）登录方法。
点击保存。

向用户的电子邮件地址发送身份验证链接

如需启动身份验证流程，请向用户显示一个要求其提供电子邮件地址的界面，然后调用 sendSignInLinkToEmail，请求 Firebase 向该用户的电子邮件地址发送身份验证链接。

构建 ActionCodeSettings 对象，以向 Firebase 提供有关如何构建电子邮件链接的指令。设置以下字段：
- url：要嵌入的深层链接以及要传递的其他任何状态。您必须在 Firebase 控制台的“已获授权的网域”列表中添加链接的网域。您可以在“Sign in method”（登录方法）标签页（“Authentication”->“Sign in method”）中找到这些网域。如果用户的设备上尚未安装应用且过去无法安装应用，链接会将用户重定向到此网址。
重要提示：在 2025 年 4 月 28 日之后创建的项目中，Firebase Authentication 默认不再将 localhost 包含为已获授权的网域。Google 强烈不建议在生产项目中使用 localhost。如果您选择为 localhost 授权，则可以前往设置页面上的已获授权的网域部分，然后点击添加网域手动添加它。
- androidPackageName 和 iOSBundleId：可帮助 Firebase Authentication 确定是否应创建在 Android 或 Apple 设备上打开的仅限网页链接或移动链接。
- handleCodeInApp：设置为 true。与其他带外电子邮件操作（密码重置和电子邮件验证）不同，登录操作必须始终在应用中完成。这是因为按照预期，在流程结束时用户应该已经登录，并且他们的身份验证状态应在应用内持久保存。
- linkDomain：如果为项目定义了自定义 Hosting 链接网域，请指定在通过指定的移动应用打开链接时应使用哪个网域。否则，系统会自动选择默认网域（例如 PROJECT_ID.firebaseapp.com）。
- dynamicLinkDomain：已弃用。请勿指定此参数。
Kotlin
```
val actionCodeSettings = actionCodeSettings {
    // URL you want to redirect back to. The domain (www.example.com) for this
    // URL must be whitelisted in the Firebase Console.
    url = "https://www.example.com/finishSignUp?cartId=1234"
    // This must be true
    handleCodeInApp = true
    setIOSBundleId("com.example.ios")
    setAndroidPackageName(
        "com.example.android",
        true, // installIfNotAvailable
        "12", // minimumVersion
    )
}MainActivity.kt
```
Java
```
ActionCodeSettings actionCodeSettings =
        ActionCodeSettings.newBuilder()
                // URL you want to redirect back to. The domain (www.example.com) for this
                // URL must be whitelisted in the Firebase Console.
                .setUrl("https://www.example.com/finishSignUp?cartId=1234")
                // This must be true
                .setHandleCodeInApp(true)
                .setIOSBundleId("com.example.ios")
                .setAndroidPackageName(
                        "com.example.android",
                        true, /* installIfNotAvailable */
                        "12"    /* minimumVersion */)
                .build();MainActivity.java
```
如需详细了解 ActionCodeSettings，请参阅在电子邮件操作中传递状态部分的内容。
要求用户输入电子邮件地址。

向用户的电子邮件地址发送身份验证链接，并保存用户的电子邮件地址，因为用户可能在同一设备上完成电子邮件登录。

Kotlin

Firebase.auth.sendSignInLinkToEmail(email, actionCodeSettings)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "Email sent.")
        }
    }MainActivity.kt

Java

FirebaseAuth auth = FirebaseAuth.getInstance();
auth.sendSignInLinkToEmail(email, actionCodeSettings)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "Email sent.");
                }
            }
        });MainActivity.java

使用电子邮件链接完成登录

安全考量

为防止有人以非预期用户身份或在非预期设备上使用登录链接登录，Firebase Authentication 要求在完成登录流程时提供用户的电子邮件地址。要成功登录，此电子邮件地址必须与登录链接最初发送到的地址一致。

对于在发出链接请求的同一设备上打开登录链接的用户，您可以在发送登录电子邮件时将他们的电子邮件地址存储在本地（例如使用 SharedPreferences），以简化登录流程。然后，使用这个地址来完成该流程。请勿在重定向网址参数中传递用户的电子邮件地址并重复使用该地址，这可能会带来会话注入风险。

登录完成后，用户之前未经过验证的登录机制都将被移除，且任何现有会话都将失效。例如，如果之前有人使用相同的电子邮件地址和密码创建了一个未经验证的账号，系统会移除其密码，以防之前冒名顶替并创建了该账号的人使用未验证的电子邮件地址和密码再次登录。

同时，请确保在生产环境中使用 HTTPS 网址，以免您的链接被中间服务器拦截。

Firebase Authentication 使用 Firebase Hosting 将电子邮件链接发送到移动设备。为了通过移动应用完成登录，必须对应用进行配置，使其检测传入的应用链接，解析底层的深层链接，然后完成登录。如需了解详情，请参阅 Android App Links 文档。

配置 Firebase Hosting

在创建和发送要在移动应用中打开的链接时，Firebase Authentication 会使用 Firebase Hosting 网域。系统已为您配置默认的 Firebase Hosting 网域。

配置 Firebase Hosting 网域：

在 Firebase 控制台中，打开 Hosting 部分。
- 如果您想为移动应用中打开的电子邮件链接使用默认网域，请前往默认网站，并记下默认的 Hosting 网域。默认的 Hosting 网域通常如下所示：PROJECT_ID.firebaseapp.com。
  
  配置应用以拦截传入链接时，您需要用到此值。
- 如果您想为电子邮件链接使用自定义网域，可以向 Firebase Hosting 注册一个网域，并将其用作链接的网域。
配置 Android 应用：

为了可以在 Android 应用中处理这些链接，需要在 Firebase 控制台项目设置中指定应用的软件包名称。此外，您还需要提供应用证书的 SHA-1 和 SHA-256。

如果您希望这些链接重定向到特定 activity，则需要在 AndroidManifest.xml 文件中配置 intent 过滤器。该 intent 过滤器应能捕获您的网域的电子邮件链接。在 AndroidManifest.xml 中：
```
<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.BROWSABLE" />
  <category android:name="android.intent.category.DEFAULT" />
  <data
    android:scheme="https"
    android:host="<PROJECT_ID>.firebaseapp.com or your custom domain"
    android:pathPrefix="/__/auth/links" />
</intent-filter>
```
当用户打开包含 /__/auth/links 路径以及您指定的架构和主机的托管链接时，您的应用将会启动包含此 intent 过滤器的 activity 来处理该链接。

验证链接并登录

在按上述说明收到链接后，验证链接是否适用于电子邮件链接身份验证并完成登录。

Kotlin

val auth = Firebase.auth
val intent = intent
val emailLink = intent.data.toString()

// Confirm the link is a sign-in with email link.
if (auth.isSignInWithEmailLink(emailLink)) {
    // Retrieve this from wherever you stored it
    val email = "someemail@domain.com"

    // The client SDK will parse the code from the link for you.
    auth.signInWithEmailLink(email, emailLink)
        .addOnCompleteListener { task ->
            if (task.isSuccessful) {
                Log.d(TAG, "Successfully signed in with email link!")
                val result = task.result
                // You can access the new user via result.getUser()
                // Additional user info profile *not* available via:
                // result.getAdditionalUserInfo().getProfile() == null
                // You can check if the user is new or existing:
                // result.getAdditionalUserInfo().isNewUser()
            } else {
                Log.e(TAG, "Error signing in with email link", task.exception)
            }
        }
}MainActivity.kt

Java

FirebaseAuth auth = FirebaseAuth.getInstance();
Intent intent = getIntent();
String emailLink = intent.getData().toString();

// Confirm the link is a sign-in with email link.
if (auth.isSignInWithEmailLink(emailLink)) {
    // Retrieve this from wherever you stored it
    String email = "someemail@domain.com";

    // The client SDK will parse the code from the link for you.
    auth.signInWithEmailLink(email, emailLink)
            .addOnCompleteListener(new OnCompleteListener<AuthResult>() {
                @Override
                public void onComplete(@NonNull Task<AuthResult> task) {
                    if (task.isSuccessful()) {
                        Log.d(TAG, "Successfully signed in with email link!");
                        AuthResult result = task.getResult();
                        // You can access the new user via result.getUser()
                        // Additional user info profile *not* available via:
                        // result.getAdditionalUserInfo().getProfile() == null
                        // You can check if the user is new or existing:
                        // result.getAdditionalUserInfo().isNewUser()
                    } else {
                        Log.e(TAG, "Error signing in with email link", task.getException());
                    }
                }
            });
}MainActivity.java

如需详细了解如何在 Apple 应用中处理使用电子邮件链接进行的登录，请参阅 Apple 平台指南。

如需了解如何在 Web 应用中处理使用电子邮件链接的登录，请参阅 Web 指南。

使用电子邮件链接进行关联/重新验证身份

您还可以将此身份验证方法与现有用户相关联。例如，以前使用其他提供方（例如电话号码）进行身份验证的用户，可以将此登录方法添加到其现有账号。

不同之处在于操作的后半部分：

Kotlin

// Construct the email link credential from the current URL.
val credential = EmailAuthProvider.getCredentialWithLink(email, emailLink)

// Link the credential to the current user.
Firebase.auth.currentUser!!.linkWithCredential(credential)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "Successfully linked emailLink credential!")
            val result = task.result
            // You can access the new user via result.getUser()
            // Additional user info profile *not* available via:
            // result.getAdditionalUserInfo().getProfile() == null
            // You can check if the user is new or existing:
            // result.getAdditionalUserInfo().isNewUser()
        } else {
            Log.e(TAG, "Error linking emailLink credential", task.exception)
        }
    }MainActivity.kt

Java

// Construct the email link credential from the current URL.
AuthCredential credential =
        EmailAuthProvider.getCredentialWithLink(email, emailLink);

// Link the credential to the current user.
auth.getCurrentUser().linkWithCredential(credential)
        .addOnCompleteListener(new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete(@NonNull Task<AuthResult> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "Successfully linked emailLink credential!");
                    AuthResult result = task.getResult();
                    // You can access the new user via result.getUser()
                    // Additional user info profile *not* available via:
                    // result.getAdditionalUserInfo().getProfile() == null
                    // You can check if the user is new or existing:
                    // result.getAdditionalUserInfo().isNewUser()
                } else {
                    Log.e(TAG, "Error linking emailLink credential", task.getException());
                }
            }
        });MainActivity.java

这也可以用于在执行敏感操作之前重新验证电子邮件链接用户的身份。

Kotlin

// Construct the email link credential from the current URL.
val credential = EmailAuthProvider.getCredentialWithLink(email, emailLink)

// Re-authenticate the user with this credential.
Firebase.auth.currentUser!!.reauthenticateAndRetrieveData(credential)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            // User is now successfully reauthenticated
        } else {
            Log.e(TAG, "Error reauthenticating", task.exception)
        }
    }MainActivity.kt

Java

// Construct the email link credential from the current URL.
AuthCredential credential =
        EmailAuthProvider.getCredentialWithLink(email, emailLink);

// Re-authenticate the user with this credential.
auth.getCurrentUser().reauthenticateAndRetrieveData(credential)
        .addOnCompleteListener(new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete(@NonNull Task<AuthResult> task) {
                if (task.isSuccessful()) {
                    // User is now successfully reauthenticated
                } else {
                    Log.e(TAG, "Error reauthenticating", task.getException());
                }
            }
        });MainActivity.java

但是，这个流程最后可能需要在原始用户未登录的其他设备上执行，因此可能无法完成。在这种情况下，系统可以向用户显示错误，要求他们在同一设备上打开链接。部分状态可以在链接中传递，提供有关操作类型和用户 uid 的信息。

已废弃：基于 Firebase Dynamic Links 的验证

电子邮件链接身份验证之前依赖于 Firebase Dynamic Links，该服务将于 2025 年 8 月 25 日关停。

我们已在 Firebase Authentication Android SDK v23.2.0+ 和 Firebase BoM v33.9.0+ 中发布了替代解决方案。

如果您的应用使用旧样式链接，您应将应用迁移到基于 Firebase Hosting 的新系统。

已弃用：区分电子邮件地址/密码与电子邮件链接登录

如果您的项目是在 2023 年 9 月 15 日当天或之后创建，则默认启用了电子邮件枚举保护功能。此功能可提高项目的用户账号的安全性，但会停用 fetchSignInMethodsForEmail() 方法，我们之前建议使用该方法来实现标识符优先流程。

虽然您可以为项目停用电子邮件枚举保护，但我们不建议您这样做。

如需了解详情，请参阅有关电子邮件枚举保护的文档。

后续步骤

在用户首次登录后，系统会创建一个新的用户账号，并将其与该用户登录时使用的凭据（即用户名和密码、电话号码或者身份验证提供方信息）相关联。此新账号存储在您的 Firebase 项目中，无论用户采用何种方式登录，您项目中的每个应用都可以使用此账号来识别用户。

在您的应用中，您可以从 FirebaseUser 对象获取用户的基本个人资料信息。请参阅管理用户。
在您的 Firebase Realtime Database 和 Cloud Storage 安全规则中，您可以从 auth 变量获取已登录用户的唯一用户 ID，然后利用此 ID 来控制用户可以访问哪些数据。

您可以通过将身份验证提供方凭据关联至现有用户账号，让用户可以使用多个身份验证提供方登录您的应用。

如需将用户退出登录，请调用 signOut：

Kotlin

Firebase.auth.signOut()MainActivity.kt

Java

FirebaseAuth.getInstance().signOut();MainActivity.java

使用电子邮件链接进行 Firebase 身份验证 (Android) 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

准备工作

设置 Android 项目

为 Firebase 项目启用电子邮件链接登录方法

向用户的电子邮件地址发送身份验证链接

Kotlin

Java

Kotlin

Java

使用电子邮件链接完成登录

安全考量

在 Android 应用中完成登录

配置 Firebase Hosting

验证链接并登录

Kotlin

Java

使用电子邮件链接进行关联/重新验证身份

Kotlin

Java

Kotlin

Java

已废弃：基于 Firebase Dynamic Links 的验证

已弃用：区分电子邮件地址/密码与电子邮件链接登录

后续步骤

Kotlin

Java

使用电子邮件链接进行 Firebase 身份验证 (Android)