Cosa Cambia quando si lascia Cordova

Capacitor è più vicino a un'app nativa che ospita la tua app web. Invi con progetti Xcode e Android Studio reali, mantieni il tuo code esistente e modernizza i plugin con API Capacitor-prima.

Elenco di migrazione (Ordine pratico)

1) Verifica la tua app Cordova

Esporta ciò che hai oggi e conservalo 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, sostituzioni di manifesto, schemi di URL)
Hook/script personalizzati su cui ti fidi
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 al cartello di output di compilazione (ad es. 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 a rischio alto (autenticazione, pagamenti, servizi di background) presto.

Caso d'uso	Plugin di Cordova (Esempi)	Sostituzione consigliata Capacitor
Cattura della fotocamera	`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`
Biometrie	`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`
Acquisti in-app	`cordova-plugin-purchase`	`@capgo/capacitor-native-purchases`
Scanning dei documenti	`cordova-plugin-document-scanner`	`@capgo/capacitor-document-scanner`
Aggiornamenti OTA / live	`Ionic Appflow`	`@capgo/capacitor-updater`

Esplora il catalogo dei plugin Capgo e mappa per capacità: Capgo plugin.

Promemoria di AI da copiare/incollare

Questi promemoria sono progettati per produrre output utilizzabili (tabelle, checklist, piani), non consigli vaghi.

Promemoria 1: 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).

Promemoria 2: Converti le preferenze di config.xml in Capacitor + Cambiamenti 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.

Promemoria 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 di 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 Capacitor migrazioni. Capgo pubblica skill open-source per Capacitor: plugin, migliori pratiche, debug, CI/CD e aggiornamenti in tempo reale.

Vedi: Capacitor Skill per Agenti AI.

Hai bisogno dell'Opzione Tutti Inclusi?

Se sei preoccupato per i bloccatori di negozio, le regressioni dei plugin o i rischi di percorso di aggiornamento per gli utenti esistenti, possiamo eseguire la migrazione da capo a capo.

AI-Assisted Cordova to Capacitor Migration (2026)