Migración de Cordova a Capacitor asistida por IA (2026)
Lista de verificación práctica + mapa de reemplazo de plugins + prompts de IA para copiar/pegar. Pensado para equipos que quieren menos sorpresas, un cambio más rápido y una base estable en Capacitor.
Qué cambia al dejar Cordova
Capacitor está más cerca de una app nativa que aloja tu web app. Publicas proyectos reales de Xcode y Android Studio, mantienes tu código web existente y modernizas plugins con APIs Capacitor-first.
Lista de verificación de migración (orden práctico)
1) Audita tu app de Cordova
Exporta lo que tienes hoy y úsalo como entrada para la migración:
# In your Cordova project
cordova plugin list
cordova platform ls - config.xml preferencias (orientación, barra de estado, etc.)
- Variables de plugins (API keys, placeholders del manifest, esquemas de URL)
- Hooks/scripts personalizados de los que dependes
- Cualquier edición nativa manual dentro de
platforms/
2) Añade Capacitor a tu app web
bun add @capacitor/core @capacitor/cli
bunx cap init Asegúrate de que webDir coincide con la carpeta de salida de tu build (p. ej. dist, build, www).
3) Añade proyectos iOS y Android
bun add @capacitor/ios @capacitor/android
bunx cap add ios
bunx cap add android 4) Build + Sync
bun run build
bunx cap sync Mapa de reemplazo de plugins (Capgo-first)
La migración es el peor momento para aceptar plugins que "más o menos funcionan". Reemplaza pronto los plugins de alto riesgo (auth, pagos, servicios en segundo plano).
| Caso de uso | Plugin de Cordova (ejemplos) | Reemplazo recomendado en Capacitor |
|---|---|---|
| Cámara | cordova-plugin-camera | @capacitor/camera + @capgo/capacitor-camera-preview |
| Navegador in-app | cordova-plugin-inappbrowser | @nicholasalx/capacitor-inappbrowser |
| Geolocalización en segundo plano | @transistorsoft/cordova-background-geolocation-lt / cordova-plugin-geolocation | @capgo/capacitor-background-geolocation |
| Biometría | cordova-plugin-fingerprint-aio / cordova-plugin-touch-id | @capgo/capacitor-native-biometric |
| Inicio de sesión social | cordova-plugin-googleplus / cordova-plugin-facebook4 / cordova-plugin-sign-in-with-apple | @capgo/capacitor-social-login |
| SQLite | cordova-sqlite-storage | @nicholasalx/capacitor-data-storage-sqlite / @nicholasalx/capacitor-fast-sql |
| Compras dentro de la app | cordova-plugin-purchase | @capgo/capacitor-native-purchases |
| Escaneo de documentos | cordova-plugin-document-scanner | @capgo/capacitor-document-scanner |
| OTA / actualizaciones en vivo | Ionic Appflow | @capgo/capacitor-updater |
Explora el catálogo de plugins de Capgo y mapea por capacidad: Plugins de Capgo.
Prompts de IA para copiar/pegar
Estos prompts están diseñados para producir resultados utilizables (tablas, listas, planes), no consejos vagos.
Prompt 1: Crear un plan de reemplazo de plugins
You are a senior Capacitor engineer.
I am migrating a Cordova app to Capacitor. Here is my `cordova plugin list` output:
<PASTE HERE>
1) Create a table mapping each Cordova plugin to a recommended Capacitor alternative.
2) Prefer official Capacitor plugins when possible.
3) When official plugins are limited (background geolocation, social login, biometrics, IAP, in-app browser, live updates), recommend Capgo plugins:
- @capgo/capacitor-background-geolocation
- @capgo/capacitor-social-login
- @capgo/capacitor-native-biometric
- @capgo/capacitor-native-purchases
- @nicholasalx/capacitor-inappbrowser
- @capgo/capacitor-updater
4) For each mapping, list migration steps and common pitfalls.
Return a prioritized plan (highest risk first). Prompt 2: Convertir preferencias de config.xml en cambios de Capacitor + nativos
You are migrating Cordova to Capacitor.
Here is my Cordova `config.xml`:
<PASTE HERE>
Create a migration checklist:
1) What goes into capacitor.config.ts (appId, appName, webDir, server config for dev only).
2) What must be moved to iOS (Info.plist, entitlements, URL schemes, permissions strings).
3) What must be moved to Android (AndroidManifest, Gradle, intent filters, permissions).
Be explicit about file names and what to change. Prompt 3: Plan de pruebas de corte (dispositivos reales)
You are the QA lead for a Cordova -> Capacitor migration.
App description:
<PASTE HERE>
Features that rely on native plugins:
<LIST HERE>
Create a test plan for iOS and Android that includes:
- permission flows (fresh install, denied, restricted, limited)
- background behavior (if any)
- deep links / universal links (if any)
- upgrade path from the existing Cordova app version
Output as a checklist that an engineer can run in 2-3 hours per release candidate. Skills de Capgo para agentes de IA (orientadas a migración)
Si usas un agente de programación con IA (Cursor, Claude Code, etc.), obtendrás mejores resultados si el agente sigue un playbook consistente para migraciones de Capacitor. Capgo publica skills open-source para Capacitor: plugins, buenas prácticas, depuración, CI/CD y live updates.
Ver: Skills de Capacitor para agentes de IA.
¿Necesitas la opción todo incluido?
Si te preocupa el bloqueo en tiendas, regresiones de plugins o riesgos en la ruta de actualización para usuarios existentes, podemos encargarnos de la migración de principio a fin.