Salta al contenuto principale
@capacitor-plus/core Strumenti per sviluppatori Open source

Capacitor+ Core Plugin Capacitor

Capacitor è un fork automatizzato e sempre sincronizzato di Capacitor, con PR della community integrate e rilasci rapidi

Installa

bun add @capacitor-plus/core bunx cap sync
npm, pnpm o yarn
  • npm install @capacitor-plus/core
  • pnpm add @capacitor-plus/core
  • yarn add @capacitor-plus/core

Guida

Come usare Capacitor+ Core in Capacitor

Utilizzo dei pacchetti Capacitor+ (@capacitor-plus)

Capacitor+ è un fork automatizzato e sempre sincronizzato di Capacitor mantenuto da Capgo. È un'alternativa drop-in ai pacchetti ufficiali Capacitor con un vantaggio chiave: le PR e le fix della community vengono merge più velocemente.

Perché esiste Capacitor+

Il team Ionic mantiene Capacitor secondo le proprie priorità e il proprio piano di rilascio. Questo significa che i contributi della community - fix di bug, miglioramenti e nuove feature - possono aspettare mesi o addirittura anni per essere merge. Alcuni non vengono mai integrati.

Capacitor+ risolve questo problema:

  1. Merge delle PR dai Fork - Le PR preziose bloccate nella coda upstream vengono attivamente merge
  2. Sync Continuo - Ogni modifica da upstream Capacitor viene automaticamente pullata, testata e verificata
  3. Rilasci Rapidi - Quando le modifiche passano la CI, vengono automaticamente pubblicate su npm sotto il @capacitor-plus ambito
  4. Prima la community - I tuoi contributi contano e hanno la priorità
  5. Sicurezza verificata - Ogni modifica è analizzata dall'IA per vulnerabilità, breaking changes e rischi di stabilità

Pacchetti disponibili

Pacchetto Descrizione
@capacitor-plus/core Libreria runtime core
@capacitor-plus/cli Interfaccia a riga di comando
@capacitor-plus/android Runtime Android
@capacitor-plus/ios Runtime iOS

Installazione

Nuovo progetto

Per un nuovo progetto, basta usare i pacchetti Capacitor+ al posto di quelli ufficiali:

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

Poi inizializza il tuo progetto:

npx cap init
npx cap add android
npx cap add ios

Migrazione da Capacitor ufficiale

Per migrare un progetto esistente da Capacitor ufficiale a Capacitor+:

# Remove official packages
npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

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

Poiché Capacitor+ è un sostituto drop-in con la stessa API, non sono necessarie modifiche al code. I tuoi import restano gli stessi:

// These imports work the same with Capacitor+
import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

Come funziona

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  ionic-team/        │     │  CI/CD           │     │  Claude Code     │     │  npm publish    │
│  capacitor          │────▶│  Pipeline        │────▶│  Security Review │────▶│  @capacitor-plus│
│  (upstream)         │     │  (daily sync)    │     │  (AI analysis)   │     │  packages       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘
  1. Daily Sync: un'Action di GitHub recupera le ultime modifiche da ionic-team/capacitor
  2. Creazione PR: le modifiche vengono proposte come pull request a plus branch
  3. Validazione CI: Esecuzione della suite di test completa (lint, unit test, build iOS, build Android)
  4. Review Claude Code: Analisi di sicurezza completa basata su AI che verifica:
    • Vulnerabilità di sicurezza (injection, XSS, ecc.)
    • Modifiche API breaking
    • Rischi di crash e problemi di stabilità
    • Integrità dei dati e preoccupazioni sulla privacy
    • Pattern code malevoli
  5. Auto-Merge: Solo se la CI passa E Claude approva (nessun problema rilevato)
  6. Auto-Publish: Una nuova versione viene pubblicata su npm in @capacitor-plus/*

Revisione di sicurezza

Ogni sincronizzazione upstream viene analizzata per:

Verifica Descrizione
Sicurezza Command injection, XSS, path traversal, segreti hardcoded, ecc.
Breaking changes API rimosse/rinominate, firme modificate, modifiche al formato config
Stabilità Null dereference, eccezioni non gestite, race condition, memory leak
Sicurezza dei dati Scenari di perdita dati, violazioni della privacy, archiviazione non sicura
Integrità di Code code offuscato, chiamate di rete sospette, backdoor

Se vengono rilevati problemi, la PR viene segnalata per una revisione manuale e NON verrà unita automaticamente.

Vuoi che la tua PR venga unita?

Hai una PR bloccata nel repo ufficiale di Capacitor? Ecco come farla entrare in Capacitor+:

  1. Apri un issue nel repo Capacitor+ con link al tuo PR upstream
  2. Oppure invia la PR direttamente al plus branch
  3. Il team lo esaminerà, eseguirà la CI e lo mergerà se supera i test

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

Vantaggi

  • PR bloccate ora: Le correzioni e le funzionalità della community in attesa upstream vengono mergeate
  • Resta aggiornato: Ricevi le correzioni upstream non appena superano la CI
  • Sicurezza prima di tutto: Ogni modifica viene esaminata per vulnerabilità e rischi di stabilità
  • Rilasci verificati: Vengono pubblicate solo le modifiche che superano sia i test CI che la revisione di sicurezza AI
  • Sostituzione drop-in: Stesso API di Capacitor, solo con un diverso scope del pacchetto
  • La tua opinione conta: Invia le tue PR o richiedi il merge di specifiche PR upstream

Esempio: usare Capacitor+ con i plugin

Tutti i plugin ufficiali Capacitor funzionano perfettamente con Capacitor+:

import { Capacitor } from '@capacitor/core';
import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';

// Everything works exactly the same
const platform = Capacitor.getPlatform();

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

const position = await Geolocation.getCurrentPosition();

Anche i plugin Capgo funzionano perfettamente con Capacitor+:

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

// Use Capgo plugins with Capacitor+
await CapacitorUpdater.notifyAppReady();
await ScreenOrientation.lock({ orientation: 'portrait' });

Tutto qui! Ora hai una versione di Capacitor aggiornata più velocemente, con i miglioramenti della community integrati prima. Le tue app beneficeranno di bug fix e nuove feature senza attendere il ciclo di rilascio ufficiale.

Continua da Usare i pacchetti Capacitor+ (@capacitor-plus)

Se stai usando Utilizzo dei pacchetti Capacitor+ (@capacitor-plus) per pianificare il lavoro sui plugin nativi, collegalo a Capacitor+ per i dettagli di implementazione in Capacitor+, 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.

FAQ

FAQ del plugin Capacitor+ Core

Come installo il plugin Capacitor+ Core in un'app Capacitor?

Esegui "bun add @capacitor-plus/core" (o "npm install @capacitor-plus/core"), poi esegui "bunx cap sync" in modo che i progetti iOS e Android includano il codice nativo code. Importalo da "@capacitor-plus/core" nel code della tua app.

@capacitor-plus/core funziona con React, Vue e Angular?

Sì. Capacitor+ Core è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira dentro Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capacitor-plus/core?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capacitor-plus/core è gratuito e open source?

Sì. Il code sorgente è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-plus/ e il pacchetto si installa gratuitamente da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Capacitor+ Core senza revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Pubblica modifiche a Capacitor+ Core senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo