Android 上的 Google 登录

简介

在本指南中，您将学习如何在 Android 设备上设置 Google 登录和 Capgo 社交登录。 我假设您已经阅读了.

使用 Google 登录

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

注意

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

如果您已将应用程序部署到 Google Play 商店, 必须在生产版本中添加一个额外的Android客户端ID，包含来自Google Play控制台的SHA1。您可以在Google Play用于签名您的发布包的SHA1哈希下找到 最后，需要注意的是，如果您操作不当，错误将不会明显。它可能非常难以调试。如果您遇到设置问题，请查看 Test and release > Setup > App Signing.

__CAPGO_KEEP_0__问题 Github issues.

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

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

创建Android客户端ID。

1. 点击搜索栏

   1. targetLanguage

      

   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 folder of your app and run ./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 证书，请尝试使用自定义密钥库。 这里 是关于如何将密钥库添加到您的项目中的注释。