Avvio rapido

Copia un prompt di impostazione con i passaggi di installazione e la guida markdown completa per questo plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-recaptcha`
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/recaptcha/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.

Installare

Puoi utilizzare la nostra configurazione assistita da AI per installare il plugin. Aggiungi le Capgo competenze al tuo strumento AI utilizzando il seguente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Usa poi il seguente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-recaptcha` plugin in my project.

Se preferisci la configurazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche del tuo platform sotto:

npm install @capgo/capacitor-recaptcha
npx cap sync

Configura le chiavi del sito

Crea le chiavi del platform in Google Cloud reCAPTCHA, quindi aggiungile a capacitor.config.ts.

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

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example',
  webDir: 'dist',
  plugins: {
    Recaptcha: {
      androidSiteKey: 'ANDROID_SITE_KEY',
      iosSiteKey: 'IOS_SITE_KEY',
      webSiteKey: 'WEB_SITE_KEY',
      enterprise: true,
    },
  },
};

export default config;

androidSiteKey, iosSiteKeyEcco alcune opzioni, e webSiteKey sovrascrivere le impostazioni condivise siteKey. Puoi anche passare un siteKey direttamente a load() o execute() contexto: frammento di testo HTML da una stringa di UI Capgo più lunga (chiave genitrice `alternatives_cta_questions`). Pagina/area: pagina di confronto delle alternative di Capacitor live-update. Ruolo: lungo paragrafo di marketing o legale. Visualizzato in: pagina alternatives.astro. Preservare esattamente i termini di prodotto/marca e sviluppatore di Capgo. Chiave del messaggio `alternatives_cta_questions` (Domande per le alternative CTA). | Frammento di testo HTML da una stringa di UI Capgo più lunga (chiave genitrice `appflow_cta_questions`). Pagina/area: pagina di confronto e migrazione di Appflow. Ruolo: lungo paragrafo di marketing o legale. Visualizzato in: pagina ionic-appflow.astro. Preservare esattamente i termini di prodotto/marca e sviluppatore di Capgo. Chiave del messaggio `appflow_cta_questions` (Domande per le alternative CTA di Appflow). | Frammento di testo HTML da una stringa di UI Capgo più lunga (chiave genitrice `capwesome_cta_questions`). Pagina/area: pagina di confronto di Capawesome. Ruolo: lungo paragrafo di marketing o legale. Visualizzato in: pagina capwesome.astro. Preservare esattamente i termini di prodotto/marca e sviluppatore di Capgo. Chiave del messaggio `capwesome_cta_questions` (Domande per le alternative CTA di Capawesome). | Frammento di testo HTML da una stringa di UI Capgo più lunga (chiave genitrice `consulting_faq_subtitle`). Pagina/area: pagina dei servizi di consulenza. Ruolo: sottotitolo o didascalia di sezione. Visualizzato in: pagina consulting.astro. Preservare esattamente i termini di prodotto/marca e sviluppatore di Capgo. Chiave del messaggio `consulting_faq_subtitle` (Sottotitolo delle domande frequenti per la consulenza). | Pagina/area: pagina di confronto e migrazione di Appflow. Ruolo: breve etichetta di UI o elemento di navigazione. Visualizzato in: pagina ionic-appflow.astro, pagina ionic-enterprise-plugins.astro, pagina solutions/ionic-enterprise-plugins.astro. Chiave del messaggio `appflow_plugins_or` (Appflow Plugins o).

Ecco alcune opzioni, e

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

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

await fetch('/api/recaptcha-assessment', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ token, action: 'login' }),
});

execute() direttamente a load() o

quando la chiave dipende dal tuo ambiente.

Imposta enterprise: false per caricare lo script standard Web reCAPTCHA v3 di Google.

const { token } = await Recaptcha.execute({
  siteKey: 'WEB_V3_SITE_KEY',
  enterprise: false,
  action: 'signup',
});

On Android and iOS, Google’s native mobile SDK path is Enterprise/mobile only. Passing enterprise: false su piattaforme native è rifiutato, quindi non viene utilizzato accidentalmente una chiave Web v3 standard.

Note di migrazione

Il plugin accetta gli alias delle vecchie opzioni Cordova sitekeyAndroid e sitekeyWeb in call options and Capacitor config. It also accepts sitekeyIos e sitekeyIOS come alias di migrazione per iOS. Preferisci i nomi di configurazione Capacitor per nuovi code.

Continua da Inizia

Se stai utilizzando Inizia per pianificare l'autenticazione e le flussi di account, connettilo con Utilizza @capgo/capacitor-recaptcha per la capacità nativa in Utilizza @capgo/capacitor-recaptcha, @capgo/capacitor-social-login per il dettaglio di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric per i dettagli di implementazione in @capgo/capacitor-native-biometric, e Autenticazione a due fattori per i dettagli di implementazione in Autenticazione a due fattori.