Inizio

Installazione del nuovo progetto

1. Installare i pacchetti di base

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

2. Aggiungi pacchetti di 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 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

Migrare da Official Capacitor

Se hai un progetto esistente Capacitor, migrare a Capacitor+ è semplice:

1. Elimina 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

No code modifiche richieste! Capacitor+ ha le stesse API dell'Capacitor ufficiale. Le tue importazioni e le code rimangono esattamente le stesse.

Utilizzo

Poiché Capacitor+ è API-compatibile, 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 ufficiali Capacitor

Tutti i plugin Capacitor ufficiali 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 Capgo Plugin

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. Sincronizzazione quotidiana: GitHub Azioni recuperano le ultime modifiche da ionic-team/capacitor
2. Creazione PR: Le modifiche vengono proposte come richieste di pull alle plus Verifica CI
3. : Esegue l'intero set di test (lint, test unitari, build iOS, build Android)Rivista di sicurezza
4. Rivista di sicurezza: Analisi potenziata da AI controlla vulnerabilità e cambiamenti di versione
5. Auto-Merge: Solo se CI passa E la revisione di sicurezza approva
6. Auto-Publish: Nuova versione pubblicata su npm sotto @capacitor-plus/*

Dettagli della Revisione di Sicurezza

Ogni sincronizzazione upstream viene analizzata per:

Check	Cosa Cattura
Sicurezza	Iniezione di comando, XSS, percorso di navigazione, segreti hardcoded
Modifiche Critiche	API eliminati/rinominati, cambiati i segni di fine riga, modifiche di configurazione
Stabilità	Dereferenziazione di null, eccezioni non gestite, condizioni di corsa, perdite di memoria
Sicurezza dei Dati	Scenari di perdita di dati, violazioni della privacy, archiviazione non sicura
Code Integrità	Oscurezza di code, chiamate di rete sospette, porte di backdoor

Attenzione

Se vengono rilevati eventuali problemi, il PR viene segnalato per una revisione manuale e NON sarà automaticamente fuso. Ciò assicura che riceva sempre rilasci stabili e sicuri.

Invia il tuo PR

Hai una PR bloccata nel repository ufficiale Capacitor? Ottienila in Capacitor+:

1. Apri un issue nel Capacitor+ repository facendo riferimento alla tua PR upstream

2. O invia direttamente come una PR al plus ramo

3. L'equipaggio esaminerà, eseguirà CI e unirà se supera

In questo modo tu e gli altri potrete beneficiare del tuo lavoro immediatamente senza dover attendere il ciclo di rilascio upstream.

Domande frequenti

È pronto per la produzione?

Sì. Capacitor+ viene utilizzato negli app di produzione. Ogni rilascio supera lo stesso set di test ufficiale di Capacitor, più un'analisi di sicurezza aggiuntiva.

Funzioneranno ancora i miei plugin ufficiali?

Sì. Tutti i plugin funzionano con __CAPGO_KEEP_0__+ senza bisogno di modifiche. @capacitor/* plugins work with Capacitor+ out of the box.

Sezione intitolata “Cosa succede se gli sviluppatori rilasciano una modifica di rottura?”

Come posso segnalare problemi?

Sezione intitolata “Come posso segnalare problemi?”

Segnalare gli errori sul Capacitor + GitHub repository. Per gli errori che interessano anche il Capacitor ufficiale, aiuteremo a coordinare l'aggiornamento.

Posso contribuire?

Sì! Le PR sono benvenute. Puoi inviare direttamente le correzioni o richiedere che specifiche PR upstream vengano integrate.