跳过主要内容
@capgo/capacitor社交登录 认证与安全 开源

社交登录 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中使用社交登录

使用@capgo/capacitor-social-login

支持Web、iOS和Android的所有社交登录。它支持Google、Apple、Facebook、Twitter/X和通用OAuth2/OIDC提供商,如GitHub、Microsoft Entra ID、Auth0、Okta和Keycloak。

安装

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-社交登录 的实现细节在@capgo/capacitor-social-login中 开始 实现细节在开始中 @capgo/capacitor-passkey 实现细节在@capgo/capacitor-passkey中 @capgo/capacitor-原生生物识别 查看@capgo/capacitor-native-biometric的实现细节 双因素认证 查看双因素认证的实现细节

常见问题

社交登录插件常见问题

如何在Capacitor应用中安装社交登录插件?

运行"bun add @capgo/capacitor-social-login" (或 "npm install @capgo/capacitor-social-login"),然后运行 "bunx cap sync" 以便 iOS 和 Android 项目捕获 native code。从 "@capgo/capacitor-social-login" 导入您的应用code。

是否@capgo/capacitor-social-login与React、Vue和Angular兼容?

是。社交登录是一个Capacitor包,因此它与任何在Capacitor内运行的 web 框架兼容,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

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

Capgo 插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件 v8 与Capacitor 8)。在GitHub README 中的兼容性表格列出了维护的版本。

capgo/capacitor社交登录是否免费且开源?

是。源code在GitHub上公开可见于 https://github.com/Cap-go/capacitor-social-login/,并且该包从npm免费安装。欢迎 bug 报告和 pull 请求。

是否可以在不经过 App Store 审核的情况下更新使用社交登录的code?

安装或升级插件会更改 native code,因此需要新建一个商店构建。之后,JavaScript、HTML 和 CSS 的更改可以立即通过Capgo live 更新发布。

无需等待应用程序审查即可将社交登录的更改部署

一旦插件在您的商店构建中,Capgo 即刻将您的 JavaScript、HTML 和 CSS 更改推送给用户。

开始使用 Capgo