Skip to main content
2026 Migrazione assistita dall'IA

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.

Ultimo aggiornamento:

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.