更新记录

1.0.1（2026-03-26）

更新插件说明文档等

1.0.0（2026-03-25）

首次发布插件

平台兼容性

uni-app(3.7.2)

uni-app x(3.7.3)

gt-google-login

Google 授权登录 UTS 插件，支持 Android / iOS。

API

登录

import { login } from "@/uni_modules/gt-google-login"

login({
  clientId: "YOUR_WEB_CLIENT_ID.apps.googleusercontent.com"
}, (res) => {
  console.log("google login result:", res)
})

登出

import { logout } from "@/uni_modules/gt-google-login"

logout((res) => {
  console.log("google logout result:", res)
})

返回结构

{
  code: number,      // 200 成功，404 失败
  errorCode?: number,
  msg: string,
  userId?: string,
  email?: string,
  displayName?: string,
  familyName?: string,
  givenName?: string,
  token?: string,
  userAvatar?: string
}

注意事项

• 谷歌登录官网地址：https://console.cloud.google.com/apis/credentials
• Android: 请在 Google Cloud Console 配置应用签名 SHA-1 / SHA-256，并使用 Web Client ID 作为 clientId。
• iOS: 请在 Google Cloud Console 配置 iOS Client，并在项目中正确配置 REVERSED_CLIENT_ID URL Scheme。

iOS平台配置

1. 配置 Info.plist

编辑插件内的 uni_modules/gt-google-login/utssdk/app-ios/Info.plist，将以下配置项补充为您的实际值：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>GIDClientID</key>
    <string>YOUR_IOS_CLIENT_ID</string>
    <key>CFBundleURLTypes</key>
    <array>
      <dict>
        <key>CFBundleURLSchemes</key>
        <array>
          <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
        </array>
      </dict>
    </array>
  </dict>
</plist>

配置说明：

• YOUR_IOS_CLIENT_ID: 替换为您的 iOS OAuth 客户端 ID（格式：123456789-abcdefg.apps.googleusercontent.com）
• YOUR_DOT_REVERSED_IOS_CLIENT_ID: 替换为反向的客户端 ID（格式：com.googleusercontent.apps.123456789-abcdefg）
  • 反向客户端 ID：将客户端 ID 中的点（.）分隔的字段按相反顺序排列
  • 例如：123456789-abcdefg.apps.googleusercontent.com → com.googleusercontent.apps.123456789-abcdefg
  • 在 Google Cloud Console 的 iOS OAuth 客户端详情页面可以找到 "iOS URL Scheme"