Getting Started

Installazione del nuovo progetto

Puoi utilizzare la nostra configurazione assistita dall'IA per installare Capacitor+. Aggiungi le Capgo competenze al tuo strumento di AI utilizzando il seguente comando:

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

Poi utilizza la seguente richiesta:

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 l'installazione manuale, installa i pacchetti eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

1. Installa 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 già un progetto Capacitor esistente, 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 changes required! Capacitor+ has the same API as official Capacitor. Your imports and code remain exactly the same.

Utilizzo

Dal momento che Capacitor+ è compatibile con API-, 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 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 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. Sync giornaliero: GitHub Azioni recuperano le ultime modifiche da ionic-team/capacitor
2. Creazione PR: Le modifiche vengono proposte come richieste di pull alle plus Ramo
3. Valutazione CI: Esegue l'intero set di test (lint, test unitari, build iOS, build Android)
4. Revisione di sicurezzaL'analisi basata su intelligenza artificiale controlla vulnerabilità e modifiche di sistema.
5. Auto-Merge: Solo se CI passa e la revisione di sicurezza approva
6. Auto-Pubblica: Nuova versione pubblicata su npm sotto @capacitor-plus/*

Dettagli della Revisione di Sicurezza

Ogni sincronizzazione upstream viene analizzata per:

Verifica	Cosa Cattura
Sicurezza	Iniezione di comando, XSS, percorso di traversal, segreti hardcoded
Modifiche significative	Modifiche/aggiornamenti delle API, cambiamenti di firma, modifiche di configurazione
Stabilità	Nulli riferimenti, eccezioni non gestite, condizioni di corsa, perdite di memoria
Sicurezza dei dati	Scenari di perdita di dati, violazioni della privacy, archiviazione non sicura
Integrità Code	code oscurato, chiamate di rete sospette, backdoor

Precauzione

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

Inviare il tuo PR

Hai un PR bloccato nel repository ufficiale Capacitor? Ottienilo fuso in Capacitor+:

1. Apri un problema in il Capacitor+ repository facendo riferimento al tuo PR upstream

2. O invia direttamente come un PR al plus ramo

3. La squadra esaminerà, eseguirà CI e unirà se passa

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

FAQ

È pronto per la produzione?

Sì. Capacitor+ viene utilizzato in applicazioni 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 @capacitor/* plugins work with Capacitor+ out of the box.

Cosa succede se rilasciano una modifica dirompente?

La revisione di sicurezza AI segnala modifiche di rottura per una revisione manuale. Vedrai le modifiche documentate prima che vengano merge.

Sezione intitolata “Come posso segnalare gli issue?”

Segnalare problemi sul Capacitor+ GitHub repositoryPer i problemi che anche interessano la versione ufficiale Capacitor, aiuteremo a coordinare l'aggiornamento.

Posso contribuire?

Sì! Sono accetti i PR. Puoi inviare direttamente le correzioni o richiedere che vengano integrate specifiche PR di upstream.

Keep going from Getting Started

Se stai utilizzando Getting Started per pianificare il lavoro di plugin nativo, connettilo con Utilizzare Capacitor+ (@capacitor-plus) Pacchetti per la capacità nativa in Utilizzare Capacitor+ (@capacitor-plus) Pacchetti, Directory dei plugin Capgo per il workflow del prodotto in Directory dei plugin Capgo Plugin Capacitor sviluppati da Capgo per i dettagli di implementazione in Plugin Capacitor sviluppati da Capgo Aggiungere o aggiornare i plugin per i dettagli di implementazione in Aggiungere o aggiornare i plugin, e Alternative plugin Enterprise Ionic per il workflow del prodotto in Alternative plugin Enterprise Ionic.