Android 上的 Firebase Google Login

简介

本指南将帮你在 Android 上集成 Google Sign-In 与 Firebase Authentication。这里假设你已经完成了 Firebase Google 通用配置

注意

我将假设您尚未在 Firebase Console 中创建 Android 应用。如果您已经创建过，后续步骤会有所不同。

设置步骤

1. 前往您的项目概览页面 console.cloud.google.com

   

2. 点击 Add app 按钮

   

   注意

   您可能需要在这里寻找该按钮。这仅适用于您已在 Firebase Console 中创建过其他应用的情况。

   

3. 选择 Android

   

4. 填写表单的第一部分

   1. 填写 Android package name
      1. 使用以下路径在 Android Studio 中打开您的应用 npx cap open android
      2. 在导航栏的最底部，找到 Gradle Scripts
      3. 找到 build.gradle 针对该模块 app
      4. 复制 android.defaultConfig.applicationId。这将是你的 package name 在 Firebase 控制台中

      注意

      此处显示的 ID 会与我在本指南后续部分使用的 ID 不同。我将使用 app.capgo.plugin.SocialLogin 用于本指南后续部分。

      5. 将其粘贴到 Firebase 控制台中
   2. 点击 Register app 按钮

5. 跳过此 Download and then add config file 步骤

   

6. 跳过此 Add firebase SDK 步骤

   

7. 点击 Continue to console 按钮

   

8. 如果未自动完成身份验证，请前往 settings -> general -> your apps -> 找到你的 Android 应用并点击它

   

9. 获取你的 SHA1 指纹

   请按照以下指南的第 10-11 步进行操作： Google Login Android 设置指南:

   1. 现在，打开终端。确保你已进入 android 应用的根目录并运行 ./gradlew signInReport

      

   2. 滚动到该命令的顶部。你应该能看到如下内容。复制 SHA1.

      

   注意

   在本文后续部分中，我会使用一个略有不同的 SHA1，因为在编写最初的 Google login android setup guide 之后，我更换了电脑。

   注意

   确保 SHA1 配置正确至关重要。如果配置错误，身份验证会出现各种异常失败。 请 阅读 Google Login Android 设置指南 以确保配置正确。

10. 将 SHA1 添加到 Firebase 项目

    1. 点击 Add fingerprint 按钮
    2. 粘贴上一步复制的 SHA1
    3. 点击 Save 按钮

11. 获取你的 Web Client ID

    1. 前往 Build -> Authentication
    2. 点击 Sign-in method 按钮
    3. 点击 Google 提供方
    4. 点击 Web SDK configuration 按钮
    5. 复制 Web client ID。这将是你的 webClientId ，详见 initialize 插件方法。
    

12. 在 JS 中使用 web client ID。

    注意

    我建议使用 authenticateWithGoogle 这个辅助函数，它位于 authUtils.ts 示例应用的工程文件。

至此，你已经 从技术层面来说 可以在 Android 上通过 Firebase Authentication 使用 Google Sign-In 了。不过，我建议按照下一步的说明，再次检查 Google Cloud console 中的配置。

再次检查 Google Cloud console 中的配置

为了确保配置无误，你应该在 Google Cloud console 中再次检查配置。

1. 前往 console.cloud.google.com

2. 找到你的项目

   1. 点击项目选择器
   2. 通过 Firebase 项目的准确名称搜索您的项目并点击它。以我为例，它是 sociallogin-tutorial-app.

3. 打开搜索栏并打开 credentials

   1. 打开搜索栏
   2. 搜索 credentials 并点击 APIs and Services 其中一个（对应截图中的第 2 项）

4. 确认您在列表中同时看到了 Android 和 Web 的 Client ID。

   

   注意

   如果在列表中没有同时看到 Android 和 Web 客户端 ID，说明配置有误。请返回并检查之前的步骤。

   还有一种可能（我也遇到过）：你已经用相同的 App ID 在另一个项目中添加过 Android SHA1 哈希值。这会导致 Firebase 无法创建 Android 客户端 ID。在这种情况下，你需要从另一个项目和 Firebase 中移除该 SHA1（通过 Firebase 控制台删除该 Android 应用），然后在 Firebase 中重新创建。

5. 请确认 Firebase 控制台中已正确配置 Android 客户端 ID。

   1. 点击 Android 应用
   2. 确认 SHA1 哈希值配置正确，且与你在之前步骤中复制的内容一致。

6. 请确认 Firebase 控制台中已正确配置 Web 客户端 ID。

   1. 点击 Web 应用
   2. 请确认 Client ID 与你在前几步中复制的一致。

   注意

   请忽略 Web Client 的其余设置。我们将在 Web 设置指南.

大功告成！你现在可以在 Android 上通过 Firebase Authentication 使用 Google Sign-In 了。

故障排除

如果身份验证卡住或失败：

• 请检查 idToken 受众匹配您的 Firebase Web Client ID
• 检查 Firebase Console 中是否已启用 Google Sign-In
• 确保 SHA-1 指纹配置正确
• 请查阅 示例应用 code 供参考

继续完成 Android 端 Firebase Google Login 配置

如果你正在使用 Android 上的 Firebase Google Login 用来规划身份验证和账户流程，并将它与 使用 @capgo/capacitor-social-login 关于使用 @capgo/capacitor-social-login 的原生能力， @capgo/capacitor-social-login 在 @capgo/capacitor-social-login 中查看实现细节， @capgo/capacitor-passkey 有关 @capgo/capacitor-passkey 的实现细节， @capgo/capacitor-native-biometric 以及 @capgo/capacitor-native-biometric 中的实现细节， 双因素认证 有关双重身份验证的实现细节。