Android 上的 Google 登录

简介

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

在 Android 设备上使用 Google 登录

注意

Android SHA1 证书设置非常痛苦，我不希望任何人必须设置此项。以下步骤假设应用程序没有发布到 Google Play 商店，并且仅在本地模拟器或开发硬件设备上使用。如果您已将应用程序部署到 Google Play 商店,

The Android SHA1 certificate is beyond painful and I wouldn’t wish it on anyone to have to set this up. The following steps assume the simplest scenario of an app that isn’t published to Google Play Store and that is only used by the local simulator, or development hardware device.

If you have deployed your app to Google Play Store, you 必须在生产版本中添加一个包含Google Play控制台中的SHA1的额外Android客户端ID。您可以在Google Play用于签署您的发布包的SHA1哈希下找到 最后，值得注意的是，如果您出错，错误将不会很明显。它可能会非常难以调试。如果您遇到设置问题，请查看 Test and release > Setup > App Signing.

__CAPGO_KEEP_0__问题 Github issues.

Google Android登录设置的故障排除 获取更多信息。 注意

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

创建一个Android客户端ID。

1. 点击搜索栏

   1. __CAPGO_KEEP_0__

      

   2. 在 credentials 中搜索并点击 APIs and Services 截图中的第 2 项

      

   3. 点击 create credentials

      

   4. 选择 OAuth client ID

      

   5. 选择 Android 应用类型

      

   6. 打开 Android Studio

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

      

   8. 找到 build.gradle 为模块 app

      

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

      

   10. 现在，打开终端。确保您位于应用程序的 android 应用程序的文件夹并运行 ./gradlew signInReport

   
   11. 滚动到此命令的顶部。您应该看到以下内容。复制 SHA1.
   
   12. 现在，返回Google控制台。输入 applicationId 作为 Package Name 并您的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. 查找 MainActivity.java

      1. 打开 app 文件夹

         

      2. 查找 java

         

      3. 找到你的 MainActivity.java 并点击它

         

   3. 修改 MainActivity.java. 请添加以下内容 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 并点击加号按钮

      

   2. 创建虚拟设备

      

   3. 选择任何一个带有 Play Store 的设备

      

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

   4. 点击 next

      

   5. 确保操作系统镜像类型为 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继续

如果您正在使用 Android上Google登录 为了计划身份验证和帐户流程，连接它与 使用 @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 的实现细节，以及 双因素身份验证 对于双因素身份验证的实现细节