Per iniziare

Avvio rapido

bun add @capgo/capacitor-plus
npx cap sync

Errori comuni

• Sostituisci tutte le dipendenze @capacitor/*.
• Rigenera i progetti nativi dopo la migrazione.
• Leggi le release notes prima di aggiornare.

Installazione di un nuovo progetto

Puoi usare il nostro setup assistito dall'IA per installare Capacitor. Aggiungi le competenze Capgo al tuo strumento di IA usando questo comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Poi usa il seguente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capacitor-plus/core`, `@capacitor-plus/cli`, `@capacitor-plus/android`, and `@capacitor-plus/ios` packages in my project.

Se preferisci il setup manuale, installa i pacchetti eseguendo questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:

1. Installa i pacchetti core

   npm install @capacitor-plus/core @capacitor-plus/cli

2. Aggiungi i pacchetti della piattaforma

   npm install @capacitor-plus/android  # for Android
   npm install @capacitor-plus/ios      # for iOS

3. Inizializza Capacitor

   npm

   npx cap init

   pnpm

   pnpm cap init

   yarn

   yarn cap init

   bun

   bunx cap init

4. Aggiungi le piattaforme

   npm

   npx cap add android

   pnpm

   pnpm cap add android

   yarn

   yarn cap add android

   bun

   bunx cap add android

   npm

   npx cap add ios

   pnpm

   pnpm cap add ios

   yarn

   yarn cap add ios

   bun

   bunx cap add ios

Migrazione da Capacitor ufficiale

Se hai già un progetto Capacitor, migrare a Capacitor+ è semplicissimo:

1. Rimuovi i pacchetti ufficiali

   npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

2. Installa i pacchetti Capacitor+

   npm install @capacitor-plus/core @capacitor-plus/cli
   npm install @capacitor-plus/android  # if using Android
   npm install @capacitor-plus/ios      # if using iOS

3. Sincronizza il tuo progetto

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Nota

Nessuna modifica a code necessaria! Capacitor+ ha la stessa API della versione ufficiale di Capacitor. I tuoi import e code restano identici.

Utilizzo

Poiché Capacitor+ è API-compatible, il tuo code esistente funziona senza modifiche:

import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

// Check platform
const platform = Capacitor.getPlatform();
console.log('Running on:', platform);

// Check if native
if (Capacitor.isNativePlatform()) {
  console.log('Running on native platform');
}

// Register a custom plugin
const MyPlugin = registerPlugin('MyPlugin');

Con plugin Capacitor ufficiali

Tutti i plugin ufficiali Capacitor funzionano senza problemi:

import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';
import { Storage } from '@capacitor/preferences';

// Camera
const photo = await Camera.getPhoto({
  quality: 90,
  resultType: CameraResultType.Uri
});

// Geolocation
const position = await Geolocation.getCurrentPosition();

// Storage
await Storage.set({ key: 'name', value: 'John' });

Con plugin Capgo

I plugin Capgo funzionano perfettamente con Capacitor+:

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';
import { CapacitorFlash } from '@capgo/capacitor-flash';

// Live updates
await CapacitorUpdater.notifyAppReady();

// Screen orientation
await ScreenOrientation.lock({ orientation: 'portrait' });

// Flashlight
await CapacitorFlash.toggle();

Come funziona la sincronizzazione

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  ionic-team/        │     │  CI/CD           │     │  Claude Code     │     │  npm publish    │
│  capacitor          │────▶│  Pipeline        │────▶│  Security Review │────▶│  @capacitor-plus│
│  (upstream)         │     │  (daily sync)    │     │  (AI analysis)   │     │  packages       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘

1. Daily Sync: Le GitHub Actions recuperano le ultime modifiche da ionic-team/capacitor
2. Creazione PR: Le modifiche vengono proposte come pull request su plus branch
3. Validazione CI: Esecuzione suite di test completa (lint, unit test, build iOS, build Android)
4. Revisione di sicurezza: Analisi AI per vulnerabilità e breaking changes
5. Auto-Merge: Solo se la CI passa E la security review approva
6. Auto-Publish: Nuova versione pubblicata su npm sotto @capacitor-plus/*

Dettagli della security review

Ogni sincronizzazione upstream viene analizzata per:

Verifica	Cosa rileva
Sicurezza	Command injection, XSS, path traversal, segreti hardcoded
Breaking changes	API rimosse/rinominate, firme modificate, modifiche alla config
Stabilità	Null dereference, eccezioni non gestite, race condition, memory leak
Sicurezza dei dati	Scenari di data loss, violazioni della privacy, storage non sicuro
Integrità di Code	code offuscato, chiamate di rete sospette, backdoor

Attenzione

Se vengono rilevati problemi, la PR viene segnalata per una revisione manuale e NON verrà unita automaticamente. Questo garantisce rilasci sempre stabili e sicuri.

Inviare la tua PR

Hai una PR bloccata nel repo ufficiale di Capacitor? Fallo approvare in Capacitor+:

1. Apri un issue nel Repo Capacitor+ collegamento alla tua PR upstream

2. Oppure invia direttamente come PR al plus branch

3. Il team farà la review, eseguirà la CI e farà il merge se passa

In questo modo tu e gli altri potete beneficiare subito del tuo lavoro, senza aspettare il ciclo di rilascio upstream.

FAQ

È pronto per la produzione?

Sì. Capacitor+ è usato in app in produzione. Ogni release supera la stessa suite di test dei Capacitor ufficiali, più analisi di sicurezza aggiuntive.

I miei plugin ufficiali funzioneranno ancora?

Sì. Tutti @capacitor/* i plugin funzionano con Capacitor+ subito.

Cosa succede se l'upstream rilascia una breaking change?

La revisione di sicurezza AI segnala le breaking change per una revisione manuale. Vedrai le modifiche documentate prima del merge.

Come segnalo un problema?

Apri un issue sul repo Capacitor+ GitHub. Per i problemi che colpiscono anche Capacitor ufficiali, aiuteremo a coordinare l'upstream.

Posso contribuire?

Certamente! Le PR sono benvenute. Puoi inviare fix direttamente o richiedere il merge di specifiche PR upstream.

Continua da Getting Started

Se stai usando Per iniziare per pianificare il lavoro sui plugin nativi, collegalo a Utilizzo dei pacchetti Capacitor+ (@capacitor-plus) per la funzionalità nativa in Utilizzo dei pacchetti Capacitor+ (@capacitor-plus), Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli su come aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin Ionic Enterprise.