Firebase Google Login on Android

简介

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

注意

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

设置步骤

1. 前往您的项目概览 console.cloud.google.com

   

2. 点击 Add app 按钮

   

   注意

   您可能需要在这里寻找此按钮。仅当您已经在 Firebase 控制台中创建了不同的应用时才适用。

   

3. 选择 Android

   

4. 填写表单的第一部分

   1. 填写 Android package name
      1. 打开 Android Studio 并在您的应用中 npx cap open android
      2. At the very bottom of the navigator, find the Gradle Scripts
      3. Find build.gradle 为该模块 app
      4. Copy the android.defaultConfig.applicationId。 这将是您的 package name 在 Firebase 控制台中

      注意

      所示的 ID 与我将在本指南中使用的 ID 不同。 我将使用 app.capgo.plugin.SocialLogin for the rest of the guide.

      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. 现在，打开终端。确保您在应用程序的文件夹中并运行 android 终端显示 gradlew signInReport 命令 ./gradlew signInReport

      

   2. Scroll to the top of this command. You should see the following. Copy the SHA1.

      

   注意

   由于我在写原版Google登录Android设置指南时已经更改了计算机，因此我将在本指南中使用一个略微不同的SHA1。

   注意

   SHA1非常重要，必须准确。如果您弄错了，认证将以奇怪的方式失败。 请 阅读Google登录Android设置指南 以确保准确。

10. 将SHA1添加到Firebase项目中

    1. 点击 Add fingerprint button
    2. 粘贴您在上一步中复制的 SHA1 值
    3. 点击 Save button

11. 获取您的 Web 客户端 ID

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

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

    注意

    我建议使用 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 截图中的第二个（第 2 个）

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

   

   注意

   如果您没有在列表中看到 Android 和 Web 客户端 ID，说明您在设置过程中出现了错误。请返回并检查您的步骤。

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

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

   1. 点击 Android 应用
   2. __CAPGO_KEEP_0__

6. 请在 Firebase 控制台中确认 Web 客户端 ID 是否正确配置

   1. 点击 Web 应用
   2. __CAPGO_KEEP_0__

   注意

   请忽略 Web 客户端的其余设置，我们将在后续讨论 web 设计指南.

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

故障排除

如果认证卡住或失败：

• 验证 idToken 您的 Firebase web 客户端 ID
• 检查 Firebase 控制台中是否启用了 Google Sign-In
• 确保 SHA-1 指纹正确配置
• 查看 示例应用 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 的实现细节 双因素认证 对于双因素认证的实现细节