Firebase Google 登录 (Android)

介绍

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

注意

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

设置步骤

1. Firebase 项目概览 点击

   

2. Cloudflare 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. 复制 android.defaultConfig.applicationId这是您在 Firebase 控制台中的 package name 显示应用 ID 配置的 Build.gradle 文件

      本节中显示的 ID 与我将在本指南的其余部分中使用的 ID 不同。 我将使用

      本指南的其余部分 app.capgo.plugin.SocialLogin 在本指南的其余部分

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

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

   

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

   

7. 点击 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. 在 JS 中使用 Web Client ID

    注意

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

在这个阶段，您 技术上 准备好使用Google Sign-In与Firebase Authentication在Android上。然而，我建议双重检查Google Cloud控制台中的设置，如下一步中所述。

双重检查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，请检查您的设置步骤。您可能需要返回并重新检查。

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

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

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

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

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

   注意

   请忽略 Web 客户端的其他设置，我们将在 Web 设置指南.

您现在已经准备好使用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 本机生物识别的实现细节 双因素身份验证 双因素身份验证的实现细节。