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-shake`
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/shake/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.
Instalar
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/capgo-skills --skill capacitor-pluginsLuego usa el siguiente prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-shake` plugin in my project.Si prefieres la configuración manual, instala el plugin ejecutando los siguientes comandos y sigue las instrucciones específicas para cada plataforma a continuación:
bun add @capgo/capacitor-shakebunx cap syncImportar
Sección titulada “Importar”import { CapacitorShake } from '@capgo/capacitor-shake';Inicio rápido
Sección titulada “Inicio rápido”import { CapacitorShake } from '@capgo/capacitor-shake';
const listener = await CapacitorShake.addListener('shake', () => { openFeedbackSheet();});
// on logout or route leaveawait listener.remove();Ejemplo: throttle en la app code
Sección titulada “Ejemplo: throttle en la app code”Shake puede activarse en ráfagas. Usa debounce antes de abrir modales o llamar a APIs.
Errores comunes
Sección titulada “Errores comunes”- Web: no hay API de shake en navegadores móviles mediante este plugin.
- Limpieza del listener: elimina los listeners al salir de la pantalla para evitar handlers duplicados.
- Android vs iOS: la sensibilidad varía; prueba en hardware real.
Resumen de API
Sección titulada “Descripción general de API”addListener
Sección titulada “addListener”Escucha el evento de shake en el dispositivo.
Registra un listener que se ejecutará cada vez que se detecte un gesto de shake. La detección de shake utiliza el acelerómetro del dispositivo para identificar patrones.
import { CapacitorShake } from '@capgo/capacitor-shake';
const listener = await CapacitorShake.addListener('shake', () => { console.log('Shake detected!');});
// To remove the listener:await listener.remove();getPluginVersion
Sección titulada “getPluginVersion”Obtén la versión nativa del plugin Capacitor.
Devuelve la versión actual de la implementación del plugin nativo.
import { CapacitorShake } from '@capgo/capacitor-shake';
const { version } = await CapacitorShake.getPluginVersion();console.log('Plugin version:', version);Fuente de verdad
Sección titulada “Fuente de verdad”Esta página se genera desde el src/definitions.tsVuelve a ejecutar la sincronización cuando cambie el API público en el upstream.
Continúa desde Primeros pasos
Sección titulada “Continúa desde Primeros pasos”Si estás usando Primeros pasos para planificar el dashboard y las operaciones de API, conéctalo con Usando @capgo/capacitor-shake para la capacidad nativa en Usando @capgo/capacitor-shake, Resumen de API para el detalle de implementación en Resumen de API Overview, Introducción para el detalle de implementación en Introducción, Claves de API para el detalle de implementación en Claves de API, y Dispositivos para el detalle de implementación en Dispositivos.