Configuración de Android

Clave del sitio

Crea una clave de aplicación móvil para Android en Google Cloud reCAPTCHA. Registra el nombre del paquete de tu app Capacitor y luego configura la clave en capacitor.config.ts.

Android usa el SDK móvil de Google reCAPTCHA. En este plugin, el reCAPTCHA v3 estándar (no Enterprise) solo está disponible para Web; enterprise: false se rechaza en Android.

import type { CapacitorConfig } from '@capacitor/cli';
import '@capgo/capacitor-recaptcha';

const config: CapacitorConfig = {
  plugins: {
    Recaptcha: {
      androidSiteKey: 'ANDROID_SITE_KEY',
    },
  },
};

export default config;

Dependencia

El plugin incluye la dependencia de Google Android reCAPTCHA:

com.google.android.recaptcha:recaptcha:18.8.0

El SDK de reCAPTCHA para Android de Google requiere core library desugaring en la app que lo consume. El plugin lo habilita automáticamente durante npx cap sync android y añade:

com.android.tools:desugar_jdk_libs:2.1.5

Puedes sobrescribir la versión de la dependencia desde la configuración de Gradle de la app con recaptchaVersion cuando necesites fijar una versión más reciente de Google SDK. Puedes sobrescribir la dependencia de desugaring con desugarJdkLibsVersion.

Ejecuta

import { Recaptcha } from '@capgo/capacitor-recaptcha';

const { token } = await Recaptcha.execute({
  action: 'checkout',
  timeout: 10000,
});

Envía el token a tu backend inmediatamente y crea una evaluación de reCAPTCHA antes de aceptar la solicitud protegida.

Continúa desde la configuración de Android

Si estás usando Configuración de Android para planificar los flujos de autenticación y de cuenta, conéctalo con Uso de @capgo/capacitor-recaptcha para la capacidad nativa en Uso de @capgo/capacitor-recaptcha, @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.