Migrazione da Cordova a Capacitor assistita dall'IA (2026)
Checklist pratica + mappa di sostituzione dei plugin + prompt IA copia/incolla. Per team che vogliono meno sorprese, un cutover più rapido e una baseline Capacitor stabile.
Cosa cambia quando lasci Cordova
Capacitor è più vicino a un'app nativa che ospita la tua web app. Distribuisci veri progetti Xcode e Android Studio, mantieni il tuo codice web esistente e modernizzi i plugin con API Capacitor-first.
Checklist di migrazione (ordine pratico)
1) Fai l'audit della tua app Cordova
Esporta ciò che hai oggi e usalo come input per la migrazione:
# In your Cordova project
cordova plugin list
cordova platform ls - config.xml preferenze (orientamento, status bar, ecc.)
- Variabili dei plugin (API key, placeholder del manifest, schemi URL)
- Hook/script personalizzati su cui fai affidamento
- Qualsiasi modifica nativa manuale dentro
platforms/
2) Aggiungi Capacitor alla tua web app
bun add @capacitor/core @capacitor/cli
bunx cap init Assicurati che webDir corrisponda alla cartella di output della build (es: dist, build, www).
3) Aggiungi i progetti iOS + Android
bun add @capacitor/ios @capacitor/android
bunx cap add ios
bunx cap add android 4) Build + Sync
bun run build
bunx cap sync Mappa di sostituzione dei plugin (Capgo-first)
La migrazione è il momento peggiore per accettare plugin che "più o meno funzionano". Sostituisci presto i plugin ad alto rischio (auth, pagamenti, servizi in background).
| Caso d'uso | Plugin Cordova (esempi) | Sostituzione Capacitor consigliata |
|---|---|---|
| Fotocamera | cordova-plugin-camera | @capacitor/camera + @capgo/capacitor-camera-preview |
| Browser in-app | cordova-plugin-inappbrowser | @nicholasalx/capacitor-inappbrowser |
| Geolocalizzazione in background | @transistorsoft/cordova-background-geolocation-lt / cordova-plugin-geolocation | @capgo/capacitor-background-geolocation |
| Biometria | cordova-plugin-fingerprint-aio / cordova-plugin-touch-id | @capgo/capacitor-native-biometric |
| Social login | 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 |
| Acquisti in-app | cordova-plugin-purchase | @capgo/capacitor-native-purchases |
| Scansione documenti | cordova-plugin-document-scanner | @capgo/capacitor-document-scanner |
| OTA / live updates | Ionic Appflow | @capgo/capacitor-updater |
Sfoglia il catalogo plugin di Capgo e mappa per funzionalità: Plugin Capgo.
Prompt IA da copiare/incollare
Questi prompt sono pensati per produrre output utilizzabili (tabelle, checklist, piani), non consigli vaghi.
Prompt 1: Costruisci un piano di sostituzione dei plugin
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: Converti le preferenze di config.xml in cambiamenti Capacitor + nativi
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: Piano di test di cutover (dispositivi reali)
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. Capgo Skills per agenti IA (adatte alla migrazione)
Se stai usando un agente di coding AI (Cursor, Claude Code, ecc.), otterrai risultati migliori quando l'agente segue un playbook coerente per le migrazioni Capacitor. Capgo pubblica skills open-source per Capacitor: plugin, best practice, debugging, CI/CD e live updates.
Vedi: Skills Capacitor per agenti IA.
Ti serve l'opzione all-inclusive?
Se temi blocchi dello store, regressioni dei plugin o rischi nel percorso di upgrade per gli utenti esistenti, possiamo gestire la migrazione end-to-end.