Google 登录 Android

介绍

在本指南中，您将学习如何在 Android 设备上设置 Google 登录和 Capgo 社交登录。 一般设置指南.

在 Android 设备上使用 Google 登录

在本部分中，您将学习如何在 Android 上设置 Google 登录。

注意

Android SHA1 证书设置非常痛苦，我不希望任何人必须设置此项。以下步骤假设最简单的情况，即未发布到 Google Play 商店的应用，并且仅在本地模拟器或开发硬件设备上使用。

如果您已将应用部署到 Google Play 商店，则 必须 添加一个额外的 Android 客户端 ID，包含 Google Play 控制台中的 SHA1，从而适用于生产发布。您可以在 Test and release > Setup > App Signing.

最后，重要的是要提到，如果您出错，错误将不会明显。它可能非常难以调试。如果您遇到设置问题，请查看 Github 问题.

此外，您还可以查看 Google Login Android 设置 的故障排除部分，了解更多信息。

注意

您可以创建多个Android客户端ID。这是必要的，如果您有多个SHA1证书。

1. 创建Android客户端ID

   1. 点击搜索栏

      

   2. 搜索 credentials 并点击 APIs and Services 截图中的第2个（数字2）

      

   3. 点击 create credentials

      

   4. 选择 OAuth client ID

      

   5. 选择 Android 应用程序类型

      

   6. 打开 Android Studio

   7. 在导航器的最下方找到 Gradle Scripts

      

   8. 在 Gradle Scripts 部分中找到 build.gradle 模块 app

      

   9. 复制 android.defaultConfig.applicationId. 这将是你的 package name 在 Google 控制台

      

   10. 现在，打开终端。确保你在你的应用程序的文件夹中并运行 android 终端显示 gradlew signInReport 命令 ./gradlew signInReport

   
   11. 终端输出显示 SHA1 证书指纹 SHA1.
   
   12. 作为 applicationId 并你的 SHA1 在证书字段中并点击 Package Name Android 客户端创建表单，包名和 SHA1 字段已填充 create
   

2. 创建一个 Web 客户端（这是 Android 必须的）

   1. 前往 Create credentials 页面在 Google 控制台

   2. 设置应用类型为 Web

      

   3. 点击 Create

      

   4. 复制客户 ID，您将其作为 webClientId 在您的 JS/TS code

      

3. 修改您的 MainActivity

   1. 请打开您的应用程序在 Android Studio 中。您可以运行 cap open android

   2. 在 Android Studio 项目导航器中找到 MainActivity.java

      1. 在 Android Studio 项目结构中找到 app 找到你的

         

      2. MainActivity.java 文件在包结构中 java

         

      3. 请添加以下内容 __CAPGO_KEEP_0__ MainActivity.java 复制到剪贴板

         

   3. 在 Android Studio 项目结构中找到 Java 文件夹 MainActivity.java. Please add the following code

      import ee.forgr.capacitor.social.login.GoogleProvider;
      import ee.forgr.capacitor.social.login.SocialLoginPlugin;
      import ee.forgr.capacitor.social.login.ModifiedMainActivityForSocialLoginPlugin;
      import com.getcapacitor.PluginHandle;
      import com.getcapacitor.Plugin;
      import android.content.Intent;
      import android.util.Log;
      import com.getcapacitor.BridgeActivity;
      
      // ModifiedMainActivityForSocialLoginPlugin is VERY VERY important !!!!!!
      public class MainActivity extends BridgeActivity implements ModifiedMainActivityForSocialLoginPlugin {
      
            @Override
            public void onActivityResult(int requestCode, int resultCode, Intent data) {
              super.onActivityResult(requestCode, resultCode, data);
      
              if (requestCode >= GoogleProvider.REQUEST_AUTHORIZE_GOOGLE_MIN && requestCode < GoogleProvider.REQUEST_AUTHORIZE_GOOGLE_MAX) {
                PluginHandle pluginHandle = getBridge().getPlugin("SocialLogin");
                if (pluginHandle == null) {
                  Log.i("Google Activity Result", "SocialLogin login handle is null");
                  return;
                }
                Plugin plugin = pluginHandle.getInstance();
                if (!(plugin instanceof SocialLoginPlugin)) {
                  Log.i("Google Activity Result", "SocialLogin plugin instance is not SocialLoginPlugin");
                  return;
                }
                ((SocialLoginPlugin) plugin).handleGoogleLoginIntent(requestCode, data);
              }
            }
      
            // This function will never be called, leave it empty
            @Override
            public void IHaveModifiedTheMainActivityForTheUseWithSocialLoginPlugin() {}
      }

   4. 保存文件

4. 在应用程序中使用 Google 登录

   1. 首先，导入 SocialLogin

      import { SocialLogin } from '@capgo/capacitor-social-login';

   2. 调用 initialize。应仅在此处调用一次。

      // onMounted is Vue specific
      // webClientId is the client ID you got in the web client creation step not the android client ID.
      onMounted(() => {
        SocialLogin.initialize({
          google: {
            webClientId: '673324426943-avl4v9ubdas7a0u7igf7in03pdj1dkmg.apps.googleusercontent.com',
          }
        })
      })

   3. 调用 SocialLogin.login. 创建一个按钮并在点击时运行以下 code。

      const res = await SocialLogin.login({
        provider: 'google',
        options: {}
      })
      // handle the response
      console.log(JSON.stringify(res))

      注意

      如果您在 Google 中初始化 mode: 'offline', SocialLogin.login() 为您的后端交换流程返回。不要在应用程序中调用 serverAuthCode 在应用程序中不调用 SocialLogin.refresh({ provider: 'google' }) 在您的后端上交换 serverAuthCode 在您的后端存储 Google 刷新令牌，并在后端刷新

5. 配置模拟器进行测试

   1. 进入 Device manager 在 Android Studio 中的设备管理器中点击加号按钮

      

   2. 虚拟设备配置中的创建虚拟设备按钮

      

   3. 图标的设备 Play Store Select any device with a

      

      如您所见， pixel 8 支持 Play Store 服务

   4. 点击 next

      

   5. 确保OS镜像类型为 Google Play. 必须 类型为 Google Play

      

   6. 点击下一步

      

   7. 确认您的设备。您可以为模拟器命名

      

   8. 进入 Device Manager 并启动您的模拟器

      

   9. 模拟器启动后，进入其设置

      

   10. 进入 Google Play

   
   11. 点击 Update 并等待约60秒
   

6. 测试您的应用程序

   如果您做得正确，应该看到Google登录流程正常工作：

   

故障排除

如果您遇到任何问题，请查看 Github问题.

与Google登录相关的问题 总是 与SHA1证书有关。

如果您无法获得开发SHA1证书，请尝试使用自定义keystore。 这里 如何添加keystore到您的项目中是通过以下方式进行的。

继续使用Google登录Android

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