Firebase Google 登录 (Android)

介绍

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

注意

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

设置步骤

1. 请访问 console.cloud.google.com

   

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. 复制 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 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. Scroll to the top of this command. You should see the following. Copy the 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. 点击 Google 提供者
    4. 点击 Web SDK configuration 按钮
    5. 复制 Web client ID。 这将是您的 webClientId 在 initialize 插件的
    

12. Firebase Authentication Sign-in Method Web __CAPGO_KEEP_0__ 配置 Web 客户端 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，说明您在设置过程中出现了错误。请返回并检查您的步骤。

   另外，也有可能，您已经在其他项目中添加了相同 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 设置指南.

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

故障排除

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

• 确认您的Firebase Web客户端ID与目标受众匹配 idToken 检查Firebase控制台中是否已启用Google Sign-In
• 确保SHA-1指纹正确配置
• 查看示例应用__CAPGO_KEEP_0__
• 参考 example app code 故障排除

故障排除

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