跳转至正文
@capgo/capacitor-social-login 身份验证与安全 开源

社交登录 Capacitor 插件

通过 Google、Facebook 和 Apple Sign-In 验证用户,轻松实现社交登录

安装

bun add @capgo/capacitor-social-login bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-social-login
  • pnpm add @capgo/capacitor-social-login
  • yarn add @capgo/capacitor-social-login

指南

如何在 Capacitor 中使用 Social Login

使用 @capgo/capacitor-social-login

一个插件搞定 Web、iOS 和 Android 的所有社交登录。支持 Google、Apple、Facebook、Twitter/X 以及 GitHub、Microsoft Entra ID、Auth0、Okta 和 Keycloak 等通用 OAuth2/OIDC 提供商。

安装

npm install @capgo/capacitor-social-login
npx cap sync

插件暴露的内容

  • initialize - 初始化插件。
  • login - 使用选定的提供商登录。
  • logout - 退出登录。
  • isLoggedIn - IsLoggedIn。

用法示例

initialize

初始化插件。

import { SocialLogin } from '@capgo/capacitor-social-login';

await SocialLogin.initialize({ telegram: { botId: '123456789' } });

login

使用选定的提供商登录。

import { SocialLogin } from '@capgo/capacitor-social-login';

const result = await SocialLogin.login({
  provider: 'facebook',
  options: { permissions: ['permission'] },
});
// The result holds sensitive values: use it without logging it.

logout

退出登录。

import { SocialLogin } from '@capgo/capacitor-social-login';

await SocialLogin.logout({} as {
    provider: 'apple' | 'google' | 'facebook' | 'twitter' | 'oauth2';
    providerId?: string;
  });

isLoggedIn

IsLoggedIn。

import { SocialLogin } from '@capgo/capacitor-social-login';

const result = await SocialLogin.isLoggedIn({ provider: 'apple' });
console.log(result);

完整参考

继续阅读:使用 @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 中的实现细节, 双因素认证 有关双重身份验证的实现细节。

常见问题

Social Login 插件常见问题

如何在 Capacitor 应用中安装 Social Login 插件?

运行 "bun add @capgo/capacitor-social-login"(或 "npm install @capgo/capacitor-social-login"),然后运行 "bunx cap sync",使 iOS 和 Android 项目同步 native code。最后在你的应用 code 中从 "@capgo/capacitor-social-login" 导入即可。

@capgo/capacitor-social-login 是否支持 React、Vue 和 Angular?

支持。Social Login 是一个 Capacitor 包,因此它支持任何在 Capacitor 中运行的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 以及原生 JavaScript。

@capgo/capacitor-social-login 支持哪个版本的 Capacitor?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-social-login 是免费开源的吗?

是的。code 的源码已在 GitHub 公开,地址为 https://github.com/Cap-go/capacitor-social-login/,你可以通过 npm 免费安装该包。欢迎提交 Bug 报告和 Pull Request。

我可以在不经过 App Store 审核的情况下,更新使用了 Social Login 的 code 吗?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待 App Store 审核,即可快速发布 Social Login 更新

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo