Firebase Google 登录 (Android)

介绍

本指南将帮助您在 Android 上将 Google Sign-In 与 Firebase Authentication 集成。假设您已经完成了 Firebase Google 的基本设置。 基本 Firebase Google 设置

注意

我假设您尚未在 Firebase 控制台中创建 Android 应用。如果您已经创建了应用，则您的步骤会有所不同。

设置步骤

1. console.cloud.google.com Firebase 项目概览

   

2. 步骤 Add app button

   

   注意

   可能需要在这里寻找此按钮。仅当您已在 Firebase 控制台中创建了不同的应用时才适用。

   

3. 选择 Android

   

4. 填写表单的第一部分

   1. 填写 Android package name
      1. 打开 Android Studio 并在您的应用中 npx cap open android
      2. 在导航器的最底部找到 Gradle Scripts
      3. 查找 build.gradle 为模块 app
      4. build.gradle (Module: app) 文件 android.defaultConfig.applicationId复制 package name 这是您在 Firebase 控制台中的

      注意

      本节中显示的 ID 与我将在本指南后续使用的 ID 不同。 我将在本指南后续使用 app.capgo.plugin.SocialLogin 用于本指南后续的 ID

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

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

   

6. 步骤 Add firebase SDK Firebase 添加应用 Android 跳过

   

7. Firebase 添加应用 Android 跳过 Continue to console button

   

8. 如果您没有自动登录，请前往 settings -> general -> your apps -> 在 Android 应用列表中找到您的应用并点击它

   

9. 获取您的 SHA1 指纹

   按照第 10-11 步的 Google 登录 Android 设置指南:

   1. 现在，打开终端。确保您在应用的文件夹中并运行 android 终端显示 gradlew signInReport 命令 ./gradlew signInReport

      

   2. ... SHA1.

      

   注意

   本指南后续将使用不同的SHA1，因为我已经更换了计算机，自从写了原版Google登录Android设置指南。

   警告

   SHA1非常重要，必须准确。如果您弄错了，认证将会以奇怪的方式失败。 请 阅读Google登录Android设置指南 才能正确配置。

10. 将SHA1添加到Firebase项目

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

11. 获取您的 Web 客户端 ID

    1. 前往 Build -> Authentication
    2. 点击上面的 Sign-in method 按钮
    3. 点击 Firebase Authentication Sign-in Method Google Provider Google 点击
    4. 点击 Web SDK configuration 按钮
    5. 复制 Web client ID。这个将是你的 webClientId 在 initialize 插件的
    

12. Firebase Authentication Sign-in Method Web __CAPGO_KEEP_0__ 配置 Web Client ID

    注意

    我建议使用 authenticateWithGoogle 可用的帮助函数 authUtils.ts 文件中的示例应用

在这个阶段，您 技术上 已经准备好使用Google Sign-In与Firebase Authentication在Android上

然而，我建议双重检查Google Cloud控制台中的设置，如下一步中所述

标题为“双重检查Google Cloud控制台中的设置”

1. 前往 console.cloud.google.com

2. 找到您的项目

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

3. 打开搜索栏并打开 credentials

   1. 打开搜索栏
   2. 搜索 credentials 并点击 APIs and Services 截图中的第二个 (数字)

4. 确认您在列表中看到 Android 和 Web 客户端 ID。

   

   注意

   如果您没有在列表中看到 Android 和 Web 客户端 ID，请检查您的设置步骤是否有错误。请返回并重新检查。

   另外，也有可能您已经在其他项目中添加了相同 App ID 的 Android SHA1 散列。这样会导致 Firebase 无法创建 Android 客户端 ID。在这种情况下，您需要在其他项目中以及 Firebase 控制台中（使用 Firebase 控制台删除 Android 应用）删除 SHA1 散列，然后在 Firebase 中重新创建它。

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

   1. 点击 Android 应用
   2. 确认 SHA1 散列值已正确配置，并且与您在前一步骤中复制的散列值匹配。

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

   1. 点击 Web 应用
   2. 确认客户端 ID 与您在前一步骤中复制的 ID 匹配。

   注意

   请忽略 Web 客户端的其余设置，我们将在 Web 设置指南中讨论此内容。 web setup guide.

哇!您现在已经准备好使用Google Sign-In与Firebase Authentication在Android上。

故障排除

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

• 验证您的 idToken 受众与Firebase Web客户端ID匹配
• 检查Firebase控制台中是否启用了Google Sign-In
• 确保SHA-1指纹正确配置
• 查看 示例应用code 参考

继续从Firebase Google Login on Android

如果您正在使用 Firebase Google Android 登录 来规划身份验证和帐户流程，连接它到 使用 @capgo/capacitor 社交登录 为 Firebase Google Android 登录的本机能力使用 @capgo/capacitor 社交登录 @capgo/capacitor 社交登录 为 @capgo/capacitor 社交登录的实现细节 @capgo/capacitor Passkey 为 @capgo/capacitor Passkey 的实现细节 @capgo/capacitor 本机生物识别 为 @capgo/capacitor 本机生物识别的实现细节 双重认证 双重认证的实现细节