Firebase Google 登录 (Android)

介绍

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

注意

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

设置步骤

1. 前往您的项目概览页面（位于 console.cloud.google.com） Firebase 项目概览

   

2. Click on the 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 本指南中

      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. 点击 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控制台中的设置”

1. 前往 https://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 控制台中（使用 Firebase 控制台删除 Android 应用）删除 SHA1，然后在 Firebase 中重新创建它。

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

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

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

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

   注意

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

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

故障排除

如果认证卡住或失败:

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

__CAPGO_KEEP_0__

如果您正在使用 Firebase Google Login on Android 来规划身份验证和帐户流程，连接它到 使用 @capgo/capacitor-social-login for the native capability in Using @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 的实现细节 双因素身份验证 双因素身份验证的实现细节。