Migrazione Assistita da AI da Cordova a Capacitor (2026)
Un elenco pratico + mappa di sostituzione dei plugin + promemoria per incollare e copiare con l'assistenza di AI. Costruito per le squadre che desiderano meno sorprese, una cutover più veloce e una baseline stabile di Capacitor.
Cosa Cambia Quando Abbandoni Cordova
Capacitor è più vicino a un'app nativa che ospita la tua app web. Invi in realtà progetti Xcode e Android Studio, mantieni il tuo web code esistente e modernizza i plugin con API Capacitor-prima.
Elenco di Migrazione (Ordine Pratico)
1) Audit la tua App Cordova
Esporta ciò che hai oggi e mantienilo come input di migrazione:
# In your Cordova project
cordova plugin list
cordova platform ls - config.xml preferenze (orientamento, barra dello stato, ecc.)
- Variabili dei plugin (API chiavi, placeholder del manifesto, schemi URL)
- Hook personalizzati/schermate su cui conti
- Qualsiasi modifica nativa manuale all'interno
platforms/
2) Aggiungi Capacitor alla tua App Web
bun add @capacitor/core @capacitor/cli
bunx cap init Assicurati che il tuo webDir corrisponda alla cartella di output di compilazione (ad esempio dist, build, www).
3) Aggiungi Progetti iOS + Android
bun add @capacitor/ios @capacitor/android
bunx cap add ios
bunx cap add android 4) Costruisci + Sincronizza
bun run build
bunx cap sync Mappa di sostituzione del Plugin (Capgo-Primo)
La migrazione è il momento peggiore per accettare il comportamento del plugin "funziona un po'". Sostituisci i plugin ad alto rischio in anticipo (autenticazione, pagamenti, servizi di background).
| Caso d'uso | Plugin Cordova (Esempi) | Sostituzione di Capacitor Raccomandata |
|---|---|---|
| Cattura della camera | cordova-plugin-camera | @capacitor/camera + @capgo/capacitor-camera-preview |
| Navegatore in-app | cordova-plugin-inappbrowser | @nicholasalx/capacitor-inappbrowser |
| Geolocalizzazione di 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 |
| Accesso con 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 |
| Acquisto in-app | cordova-plugin-purchase | @capgo/capacitor-native-purchases |
| Scanning dei documenti | cordova-plugin-document-scanner | @capgo/capacitor-document-scanner |
| Aggiornamenti in tempo reale / live | Ionic Appflow | @capgo/capacitor-updater |
Esplora il catalogo dei plugin di Capgo e mappa per capacità: Capgo plugin.
Promemoria di AI da copiare/incollare
These prompts sono progettati per produrre output utilizzabili (tabelle, elenchi di controllo, piani), non consigli vaghi.
Prompt 1: Crea un piano di sostituzione del 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 Capacitor + modifiche native
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. Abilità di Capgo per gli agenti AI (compatibili con la migrazione)
Se stai utilizzando un agente di codifica AI (Cursor, Claude Code, ecc.), otterrai risultati migliori quando l'agente segue un playbook coerente per le migrazioni di Capacitor. Capgo pubblica skill open-source per Capacitor: plugin, migliori pratiche, debug, CI/CD e aggiornamenti in tempo reale.
Vedi: Abilità di Capacitor per gli agenti AI.
Hai bisogno dell'Opzione Tutti Inclusi?
Se sei preoccupato per gli ostacoli degli store di app, le regressioni dei plugin o i rischi di percorso di aggiornamento per gli utenti esistenti, possiamo eseguire la migrazione da capo a fondo.