Empezar

Copie un prompt de configuración con los pasos de instalación y la guía de markdown completa para este complemento.

        Set up this Capacitor plugin in the project.

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

Instale el paquete
Ventana de terminal
```
bun add @capgo/capacitor-passkey
```
Sincronice proyectos nativos
Ventana de terminal
```
bunx cap sync
```

Agregar la configuración del plugin

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

const config: CapacitorConfig = {
  appId: 'app.capgo.passkey.example',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    CapacitorPasskey: {
      origin: 'https://signin.example.com',
      autoShim: true,
      domains: ['signin.example.com'],
    },
  },
};

export default config;

Instale el shim durante el arranque

import { CapacitorPasskey } from '@capgo/capacitor-passkey';

await CapacitorPasskey.autoShimWebAuthn();

Mantenga su flujo normal de WebAuthn

const registration = await navigator.credentials.create({
  publicKey: registrationOptions,
});

const authentication = await navigator.credentials.get({
  publicKey: requestOptions,
});

¿Qué hace la configuración del complemento?

La configuración se lee de plugins.CapacitorPasskey en capacitor.config.*.

origin: origen de HTTPS primario de terceros utilizado por el shim y directo API
domains: nombres de host de terceros adicionales para parchear en la configuración nativa durante la sincronización
autoShim: predeterminado true y controla la función de parcheo automático cap sync Hook de configuración nativa

¿Qué parches de sincronización te ofrece

Cuando ejecutes bunx cap syncel plugin actualiza el proyecto de host nativo generado:

iOS: configuración de dominios asociados y configuración de Xcode cuando sea necesario
Android: asset_statements metadatos y el recurso generado utilizado por el manifiesto

El hook no publica los archivos de confianza de tu sitio web por ti. Todavía necesitas hospedar:

https://your-domain/.well-known/apple-app-site-association
https://your-domain/.well-known/assetlinks.json

Guías de plataforma

Configuración de iOS

Dominios asociados y apple-app-site-association.

Configuración de Android

Enlaces de activos digitales y assetlinks.json.

Notas de backend

Validación de origen y advertencias de Android.