Inizia con Capgo

Installazione di un nuovo progetto

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

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

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

1. Installa i pacchetti di base

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

2. Aggiungi i 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 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

Nessuna modifica code richiesta! Capacitor+ ha le stesse API ufficiali Capacitor. Le tue importazioni e code rimangono esattamente le stesse.

Uso

Poiché 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 Plugins

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();

How the Sync Works

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  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 della PR: Le modifiche vengono proposte come richieste di pull alle plus ramo
3. Validazione CI: Esegue l'intero set di test (lint, test unitari, build iOS, build Android)
4. Revisione della sicurezza: L'analisi basata sull'intelligenza artificiale controlla le vulnerabilità e le modifiche che rompono il codice
5. Auto-Merge: Solo se CI passa E la revisione di sicurezza approva
6. Auto-Publish: Nuova versione pubblicata su npm sotto @capacitor-plus/*

Scheda di Revisione di Sicurezza

Ogni sincronizzazione upstream viene analizzata per:

Verifica	Cosa Cattura
Sicurezza	: Iniezione di comando, XSS, percorso di navigazione, segreti hardcoded
Modifiche Rilevanti	Rimosse/ripristinate API, cambiati i segni di firma, modifiche alle impostazioni
Stabilità	Condizioni di nullità, 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à	code non chiarito, chiamate di rete sospette, porte di servizio

Preavviso

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.

Inviare il tuo PR

Ha un PR bloccato nel repository ufficiale Capacitor? Ottienilo integrato in Capacitor+:

1. Apre un issue nel Capacitor+ repository facendo riferimento al tuo PR upstream

2. Oltre a ciò, puoi inviare direttamente come un PR al plus ramo

3. La squadra esaminerà, eseguirà CI e integrerà 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 in applicazioni di produzione. Ogni rilascio supera lo stesso set di test della versione ufficiale 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 problemi sul Capacitor+ GitHub repository. Per i problemi che interessano anche 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.

Continua da Inizia

Se stai utilizzando Inizia per pianificare il lavoro sui plugin nativi, connettilo con Utilizzare Capacitor+ (@capacitor-plus) Pacchetti per la capacità nativa in Utilizzo Capacitor+ (@capacitor-plus) Pacchetti, Capgo Directory Plugin per il flusso di lavoro del prodotto in Capgo Directory Plugin, Capacitor Plugin da Capgo per la dettaglio di implementazione in Capacitor Plugin da Capgo Aggiungere o Aggiornare Plugin per la dettaglio di implementazione in Aggiungere o Aggiornare Plugin, e Sostituti di Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Sostituti di Plugin Enterprise Ionic.