Primeros pasos
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-social-login`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/social-login/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Instalación
Sección titulada “Instalación”Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:
npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-pluginsLuego usa el siguiente prompt:
Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-social-login` plugin in my project.Si prefieres la configuración manual, instala el plugin ejecutando estos comandos y sigue las instrucciones de cada plataforma:
-
Instala el paquete
Ventana de terminal bun add @capgo/capacitor-social-login -
Sincroniza con proyectos nativos
Ventana de terminal bunx cap sync -
Inicializar en el arranque de la app
import { SocialLogin } from '@capgo/capacitor-social-login';await SocialLogin.initialize({google: {webClientId: 'your-google-web-client-id',iOSClientId: 'your-google-ios-client-id',iOSServerClientId: 'your-google-web-client-id',mode: 'online',},apple: {clientId: 'your-apple-service-id',useProperTokenExchange: true,useBroadcastChannel: true,},facebook: {appId: 'your-facebook-app-id',},twitter: {clientId: 'your-twitter-client-id',redirectUrl: 'myapp://oauth/twitter',},oauth2: {github: {appId: 'your-github-client-id',authorizationBaseUrl: 'https://github.com/login/oauth/authorize',accessTokenEndpoint: 'https://github.com/login/oauth/access_token',redirectUrl: 'myapp://oauth/github',scope: 'read:user user:email',pkceEnabled: true,},},});
Cuándo eligen los equipos este plugin
Sección titulada “Cuando los equipos eligen este plugin”- Un solo paquete para Google, Apple, Facebook, Twitter/X y proveedores personalizados de OAuth2 u OIDC.
- Android Google Sign-In mediante Credential Manager en lugar de plugins de la comunidad obsoletos.
- Proveedores estilo Ionic Auth Connect a través de la capa de compatibilidad documentada.
- Apps que deben compartir el login code entre las builds móviles y web.
Ejemplos del flujo principal
Sección titulada “Ejemplos del flujo principal”await SocialLogin.login({ provider: 'google', options: { scopes: ['profile', 'email'] },});
await SocialLogin.login({ provider: 'oauth2', options: { providerId: 'github', scope: 'read:user user:email', },});Comprobaciones de sesión
Sección titulada “Verificaciones de sesión”const status = await SocialLogin.isLoggedIn({ provider: 'google' });await SocialLogin.logout({ provider: 'google' });Códigos de autenticación y refresh
Sección titulada “Códigos de autenticación y renovación”// For providers that support this modeconst authCodeResult = await SocialLogin.getAuthorizationCode({ provider: 'google' });await SocialLogin.refresh({ provider: 'google', options: {} as never });Helpers avanzados
Sección titulada “Funciones avanzadas”const jwt = await SocialLogin.decodeIdToken({ idToken: 'eyJhbGciOi...',});
const { date } = await SocialLogin.getAccessTokenExpirationDate({ accessTokenExpirationDate: Date.now() + 3600 * 1000,});
const expired = await SocialLogin.isAccessTokenExpired({ accessTokenExpirationDate: Date.now() + 1000,});
const active = await SocialLogin.isRefreshTokenAvailable({ refreshToken: 'a-token' });Notas por proveedor
Sección titulada “Notas específicas del proveedor”Modo offline de Google
Sección titulada “Modo sin conexión de Google”google.mode: 'offline' devuelve serverAuthCode desde login. En este modo, logout, isLoggedIn, getAuthorizationCode y refresh no están disponibles.
Usa serverAuthCode solo como entrada para el intercambio de token en tu backend. Si necesitas llamar a SocialLogin.refresh() en la app, usa google.mode: 'online' en su lugar.
Configurar useProperTokenExchange: true para un manejo estricto de tokens y useBroadcastChannel: true para una configuración simplificada en Android.
Flujo de redirección web OAuth2
Sección titulada “Flujo de redirección web OAuth2”Usa OAuth2LoginOptions.flow: 'redirect' para flujos web que navegan fuera de la página.
Dependencias dinámicas de proveedores
Sección titulada “Dependencias dinámicas de proveedores”Puedes configurar qué proveedores incluir para reducir el tamaño de la app nativa. Esto es más útil cuando tu app solo necesita proveedores específicos.
Añade la configuración del proveedor a capacitor.config.ts:
import type { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = { appId: 'com.example.app', appName: 'MyApp', webDir: 'dist', plugins: { SocialLogin: { providers: { google: true, facebook: true, apple: true, twitter: false, }, logLevel: 1, }, },};
export default config;Los valores de provider significan:
true: el provider está habilitado y sus dependencias nativas están incluidas en el bundle.false: el provider está deshabilitado y sus dependencias nativas no están incluidas en el bundle.
Detalles importantes:
- Ejecuta
bunx cap syncdespués de cambiar la configuración del provider. - Si no se proporciona configuración de provider, todos los providers usan por defecto
truepor compatibilidad hacia atrás. - Deshabilitar un provider con
falselo hace no disponible en tiempo de ejecución, incluso si ese provider solo usa APIs del sistema. - Esta configuración solo afecta a iOS y Android; no afecta a Web.
- Apple Sign-In en Android usa OAuth sin dependencias externas de SDK.
- Twitter/X usa OAuth 2.0 estándar sin dependencias externas de SDK.
Para incluir solo Google Sign-In y Apple Sign-In:
plugins: { SocialLogin: { providers: { google: true, facebook: false, apple: true, twitter: false, }, },}Documentación relacionada
Sección titulada “Documentación relacionada”- Resumen de integraciones
- Integración con Better Auth
- Proveedores OAuth2 y OIDC
- Solución de problemas
- Privacy manifest y manejadores de URL de iOS
- Migrar de Ionic Auth Connect
- Guía de migración de Social Login Auth Connect
- Migrar proveedores heredados
- Solución de migración de plugins de Ionic Enterprise
Continúa desde Getting Started
Sección titulada “Continúa desde Primeros pasos”Si estás usando Primeros pasos para planificar los flujos de autenticación y de cuenta, conéctalo con Uso de @capgo/capacitor-social-login para la capacidad nativa en el uso de @capgo/capacitor-social-login, @capgo/capacitor-social-login para los detalles de implementación en @capgo/capacitor-social-login, @capgo/capacitor-passkey para el detalle de implementación en @capgo/capacitor-passkey, @capgo/capacitor-native-biometric para el detalle de implementación en @capgo/capacitor-native-biometric, y Autenticación de dos factores para el detalle de implementación en la autenticación de dos factores.