Inizia a utilizzare

Installazione del Progetto Nuovo

Puoi utilizzare la nostra configurazione assistita dall'IA per installare Capacitor+. Aggiungi le Capgo abilità al tuo strumento di IA 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 la configurazione Manuale, installa i pacchetti eseguendo i seguenti comandi e segui le istruzioni specifiche del tuo sistema operativo qui sotto:

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 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 Capacitor+ pacchetti

   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

Non sono necessarie modifiche a code! Capacitor+ ha le stesse API di Capacitor ufficiale. Le tue importazioni e 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 ufficiale 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();

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 per il recupero delle ultime modifiche da ionic-team/capacitor
2. Creazione PR: Le modifiche vengono proposte come richieste di pull ai plus ramo
3. Validazione CI: Esegue l'intero set di test (lint, test unitari, build iOS, build Android)
4. Rivista di sicurezza: L'analisi basata sull'intelligenza artificiale controlla per vulnerabilità e modifiche breaking
5. Auto-Merge: Solo se CI passa E la revisione di sicurezza approva
6. Auto-Pubblicazione: Nuova versione pubblicata su npm sotto @capacitor-plus/*

Dettagli della Revisione di Sicurezza

Tutti gli aggiornamenti sincronizzati vengono analizzati per:

Controlla	Cosa Cattura
Sicurezza	Iniezione di comando, XSS, percorso di navigazione, segreti hardcoded
Cambiamenti Rilevanti	API rimosse/renominati, cambiamenti di firma, modifiche di configurazione
Stabilità	Riferimenti a null, eccezioni non gestite, condizioni di corsa, perdite di memoria
Salute dei Dati	Scenari di perdita di dati, violazioni della privacy, archiviazione non sicura
Code Integrità	code oscurato, chiamate di rete sospette, backdoor

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

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

1. Apri un issue nel Capacitor+ repository Collegamento al tuo PR upstream

2. O invia direttamente come un PR al plus ramo

3. L'equipe 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.

Domande frequenti

È pronto per la produzione?

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

Risponderanno ancora i miei plugin ufficiali?

Sì. Tutti i @capacitor/* plugin funzionano con Capacitor+ senza bisogno di alcuna modifica.

Cosa succede se l'upstream rilascia una modifica di rottura?

L'analisi di sicurezza AI segnala le modifiche di rottura per una revisione manuale. Vedrai le modifiche documentate prima che vengano incorporate.

Come posso segnalare gli issue?

Segnalare gli issue sul Capacitor+ GitHub repo. Per gli issue che interessano anche i plugin ufficiali Capacitor, aiuteremo a coordinare l'upstream.

Posso contribuire?

Sì! Sono accetti i PR. Puoi inviare modifiche direttamente o richiedere che specifici PR upstream vengano fusi.

Continua da Getting Started

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