Firebase Google Login on Android

介绍

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

注意

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

Setup Steps

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

   

2. 点击 Add app 按钮

   

   注意

   可能需要在这里寻找此按钮，仅当您在 Firebase 控制台中已创建其他应用时才会出现。

   

3. 选择 Android

   

4. 填写表单的第一部分

   1. 填写 Android package name
      1. 打开使用 App 的 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 步骤

   

7. 点击 Continue to console 按钮

   

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

   

9. 获取您的 SHA1 指纹

   按照第 10-11 步执行 Google 登录 Android 设置指南 现在，打开终端。确保您在应用程序的文件夹中并运行:

   1. 终端显示 gradlew signInReport 命令 android 滚动到此命令的顶部。您应该看到以下内容。复制 ./gradlew signInReport

      

   2. 注意 SHA1.

      

   警告

   警告

   终端显示 gradlew signInReport 命令

   SHA1非常重要，确保准确无误。如果出现问题，认证将会以奇怪的方式失败。 请 阅读Google登录Android设置指南 以正确的方式进行

10. 将SHA1添加到Firebase项目

    1. 点击 Add fingerprint Firebase添加AppAndroid添加指纹按钮
    2. Firebase添加AppAndroid添加指纹SHA1字段
    3. Firebase添加AppAndroid添加指纹保存按钮 Save targetLanguage

11. 获取您的 Web 客户端 ID

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

12. 使用 Web Client ID 在 JS 中

    注意

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

在这个阶段，您已经 TECHNICALLY 准备好使用 Google Sign-In 与 Firebase 身份验证在 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 第一个（截图中的第 2 个）

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

   

   注意

   如果您没有在列表中看到 Android 和 Web 客户端 ID，请检查您的设置步骤。

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

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

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

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

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

   注意

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

哇！您现在已经准备好使用 Firebase 身份验证和 Google Sign-In 在 Android 上。

故障排除

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

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

继续使用 Firebase Google Login on Android

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