Google Login 配置
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
本指南将教你如何使用 Capgo Social Login 设置 Google Login。要设置 Google Login,你需要准备以下内容:
- 一个 Google 账号
常规设置
标题为“通用设置”的章节在此部分,您将设置由 Google 显示的登录界面。
- 请访问 console.cloud.google.com
- 点击项目选择器
- 如果您还没有项目,请 创建新项目.
- 点击
New project
- 输入项目名称并点击
Create
- 确保你在正确的项目中
- 点击
- 开始配置
OAuth consent screen-
点击搜索栏
-
搜索
OAuth consent screen并点击它
-
配置同意屏幕
点击
create
-
- 填写应用信息
-
我们先从
App Information
- 请输入你的
App Name - 输入
user support email
-
您 可以 添加应用图标。
-
您 建议 配置
App domain
-
您 必须 提供开发者邮箱
-
点击
save and continue
- 请输入你的
-
- 配置权限范围
-
点击
add or remove scopes
-
选择以下权限范围并点击
update
-
点击
save and continue
-
- 添加测试用户
- 点击
add users
- 输入您的 Google 邮箱,按回车键,然后点击
add
- 点击
save and continue
- 点击
- 点击
back to dashboard
- 提交您的应用进行验证
在线访问与离线访问的区别
标题为“在线访问与离线访问的区别”的章节使用 Google Login 配合 Capacitor 有多种方式。下表总结了这两种方式的区别:
| 在线访问 | 离线访问 | |
|---|---|---|
| 需要后端 | ❌ | ✅ |
| 长期有效的 access token | ❌ | ✅ |
| 配置简单 | ✅ | ❌ |
如果你仍不确定该选哪一个,请参考以下场景:
-
你希望用户登录后,立即为其签发自定义 JWT。你的 App 不会调用 Google APIs
这种情况下,请选择 online access。
-
你的 App 会从客户端调用一些 Google APIs,但绝不会从后端调用
这种情况下,请选择 online access
-
你的 App 会从后端调用一些 Google APIs,但仅在用户正在使用 App 时调用
这种情况下,请选择 online access
-
你的 App 会定期检查用户的日历,即使用户当前并未使用 App
这种情况下,请选择 offline access
online access 的后端示例
标题为“在线访问的后端示例”的章节在本教程的这一部分,我将演示如何在你的后端验证用户。
本示例将非常简单,基于以下技术:
你可以找到此示例的 code 这里
如图所示:
思路相当简单。你发送一个简单的 GET 请求到 https://www.googleapis.com/oauth2/v3/tokeninfo 这会告诉你 token 是否有效;如果有效,还会返回用户的邮箱,以及该用户 token 的其他信息。
基于此,你可以为用户签发自己的 JWT,或签发某种 session cookie。最终的鉴权实现有无限可能。
如果你确实想调用 Google 的 API,我强烈建议看看 Google OAuth 2.0 Playground。通过它,你可以轻松查看有哪些 API 可调用。
在自有后端使用离线访问
标题为“在自有后端使用离线访问”的部分要使用离线访问,你需要以下内容:
- 一台 HTTP 服务器
在本例中,我将使用以下技术在应用中提供离线访问:
-
LowDb (一个简单的数据库)
本示例的 code 可以在这里找到 这里
至于客户端 code,如下所示:
import { Capacitor } from '@capacitor/core';import { GoogleLoginOfflineResponse, SocialLogin } from '@capgo/capacitor-social-login';import { usePopoutStore } from '@/popoutStore'; // <-- specific to my app
const baseURL = "[redacted]";
async function fullLogin() { await SocialLogin.initialize({ google: { webClientId: '[redacted]', iOSClientId: '[redacted]', iOSServerClientId: 'The same value as webClientId', mode: 'offline' // <-- important } }) const response = await SocialLogin.login({ provider: 'google', options: { forceRefreshToken: true // <-- important } })
if (response.provider === 'google') { const result = response.result as GoogleLoginOfflineResponse const res = await fetch(`${baseURL}/auth/google_offline`, { headers: { "Content-Type": "application/json" }, body: JSON.stringify({ serverAuthCode: result.serverAuthCode, platform: Capacitor.getPlatform() }), method: "POST" })
if (res.status !== 200) { popoutStore.popout("Full google login failed", "check console"); return }
const { jwt } = await res.json(); const userinfo = await fetch(`${baseURL}/auth/get_google_user`, { headers: { Authorization: `Bearer ${jwt}` } }) if (userinfo.status !== 200) { popoutStore.popout("Full google (userinfo) login failed", "check console"); return } popoutStore.popout("userinfo res", await userinfo.text()); }}请注意这里缺少了什么:应用中没有 SocialLogin.refresh() 调用。这是有意为之的。在 Google 离线模式下,刷新会在您的后端完成交换 serverAuthCode 并安全存储 refresh token 之后发生。
从 Google Login 配置继续
“继续 Google 登录设置”部分如果你正在使用 Google Login 配置 用来规划身份验证和账户流程,并将它与 使用 @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 中的实现细节, 双因素认证 有关双重身份验证的实现细节。