Android 上的 Firebase Google 登录

简介

本指南将帮助你在 Android 上集成带有 Firebase Authentication 的 Google 登录。我假设你已经完成了通用 Firebase Google 设置

Note

我将假设你尚未在 Firebase Console 中创建 Android 应用。如果已创建,你的步骤会略有不同。

设置步骤

1. 在 console.cloud.google.com 转到项目概览

   

2. 点击 Add app 按钮

   

   Note

   你可能需要在此处查找此按钮。这仅适用于你已在 Firebase Console 中创建了不同应用的情况。

   

3. 选择 Android

   

4. 填写表单的第一部分

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

      Note

      此处显示的 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 指纹

   按照 Google Login Android 设置指南中的步骤 10-11:

   1. 现在,打开终端。确保你在应用的 android 文件夹中并运行 ./gradlew signInReport

      

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

      

   Note

   我将在本指南的其余部分使用略有不同的 SHA1,因为自编写原始 Google 登录 Android 设置指南以来,我已更换了计算机。

   Caution

   SHA1 非常重要,必须正确。如果搞错了,身份验证将以奇怪的方式失败。 请__阅读 GOOGLE LOGIN 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。这将是插件的 initialize 方法中的 webClientId。
    

12. 在 JS 中使用 Web 客户端 ID。

    Note

    我建议使用示例应用的 authUtils.ts 文件中提供的 authenticateWithGoogle 辅助函数。

此时,你技术上已准备好在 Android 上使用带有 Firebase Authentication 的 Google 登录。但是,我建议按照下一步中的说明在 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 那个(截图上的第 2 个)

4. 验证你在列表中看到 Android 和 Web 客户端 ID。

   

   Caution

   如果你在列表中看不到 Android 和 Web 客户端 ID,说明你在设置中犯了错误。请返回并检查你的步骤。

   也有可能,这发生在我身上,你已经在不同的项目中使用相同的应用 ID 添加了 Android SHA1 哈希。这将导致 Firebase 无法创建 Android 客户端 ID。在这种情况下,你需要从其他项目以及 Firebase 上删除 SHA1(使用 Firebase 控制台删除 Android 应用),并在 Firebase 上重新创建它

5. 验证 Android 客户端 ID 在 Firebase 控制台中是否正确配置。

   1. 点击 Android 应用
   2. 确认 SHA1 哈希配置正确,并且与你在之前步骤中复制的匹配。

6. 验证 Web 客户端 ID 在 Firebase 控制台中是否正确配置。

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

   Note

   请忽略 Web 客户端的其余设置。我们将在 Web 设置指南中讨论这个问题。

万岁!你现在已准备好在 Android 上使用带有 Firebase Authentication 的 Google 登录。

故障排除

如果身份验证挂起或失败:

• 验证 idToken audience 是否与你的 Firebase Web 客户端 ID 匹配
• 检查 Firebase Console 中是否启用了 Google 登录
• 确保 SHA-1 指纹配置正确
• 查看示例应用代码以供参考