更新记录

1.0.0（2025-12-24）

V1.0.0版本上线，支持安卓端Google 账号登录、退出登录、获取当前用户信息、静默登录

平台兼容性

uni-app(4.66)

uni-app x(4.66)

关于插件

本插件为uniapp提供原生Android 端的 Google 登录插件，支持 Google 账号登录、退出登录、获取用户信息、静默登录等功能 。

如何使用

引入

import {
  googleSignIn,
  googleSignOut,
  googleGetCurrentUser,
  googleSignInSilently
} from "@/uni_modules/wh-google-signin"

API 说明

googleSignIn - Google 登录

发起 Google 登录流程。

参数说明

注意：对于单纯的 Google 登录，scopes 参数不需要填写。插件默认会请求以下信息：

• 用户ID
• 用户邮箱
• 用户显示名称
• 用户头像
• ID Token

只有在需要访问其他 Google 服务（如 Google Drive、Gmail 等）时，才需要填写 scopes。

成功回调参数

失败回调错误码

调用示例

googleSignIn({
  serverClientId: 'your-server-client-id', // 仅后端验证时需要，web的clientID
  success: (res) => {
    console.log('登录成功', res)
    console.log('用户ID:', res.user.id)
    console.log('用户邮箱:', res.user.email)
    console.log('用户名称:', res.user.displayName)
    console.log('用户头像:', res.user.photoUrl)
    console.log('ID Token:', res.idToken)
  },
  fail: (err) => {
    console.log('登录失败', err)
  }
})

googleSignOut - 退出登录

退出当前 Google 账号登录。

参数说明

调用示例

googleSignOut({
  success: () => {
    console.log('退出登录成功')
  },
  fail: (err) => {
    console.log('退出登录失败', err)
  }
})

googleGetCurrentUser - 获取当前用户信息

获取当前已登录的 Google 用户信息。

参数说明

成功回调参数

与 googleSignIn 成功回调参数相同。

调用示例

googleGetCurrentUser({
  success: (res) => {
    console.log('当前用户信息', res)
  },
  fail: (err) => {
    console.log('获取用户信息失败', err)
  }
})

googleSignInSilently - 静默登录

尝试静默登录（如果之前已经登录过）。

参数说明

调用示例

googleSignInSilently({
  success: (res) => {
    console.log('静默登录成功', res)
  },
  fail: (err) => {
    console.log('静默登录失败', err)
    // 如果静默登录失败，可以调用 googleSignIn 进行显式登录
  }
})

配置说明

注意事项：

• OAuth 2.0 客户端 ID 必须是在 Google Cloud Console 中创建的 Web 应用类型 的客户端 ID
• 客户端 ID 格式通常为：xxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com
• 确保在 Google Cloud Console 中正确配置了应用的包名和 SHA-1 签名证书指纹