Vai al contenuto principale
Capgo logo
Torna ai plugin
@capacitor-plus/core
Tutorial
@capacitor-plus/core

Capacitor+ Core plugin icon

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

Scaricamenti/mese

121

GitHub Stelle

18

Guida

Tutorial su Capacitor+ Core

Utilizzo di Capacitor+ (@capacitor-plus) Pacchetti

Capacitor+ è un fork automatizzato, sempre sincronizzato di Capacitor mantenuto da Capgo. Fornisce una sostituzione a gettone per i pacchetti ufficiali Capacitor con un vantaggio chiave: PRs e correzioni della community vengono integrate più velocemente.

Perché Capacitor+ Esiste

L'equipaggio Ionic mantiene Capacitor con le proprie priorità e calendario di rilascio. Ciò significa che le contribuzioni della community - correzioni di bug, miglioramenti e funzionalità - possono aspettare mesi o anche anni per essere integrate. Alcune non ci arrivano mai.

Capacitor+ risolve questo problema in questo modo:

  1. Integrazione di PR da Fork - I preziosi PR bloccati nella coda upstream vengono integrati attivamente
  2. Sincronizzazione Continua - Ogni modifica da upstream Capacitor viene automaticamente recuperata, testata e verificata
  3. Rilasci Rapidi - Quando le modifiche superano la CI, vengono pubblicate automaticamente su npm sotto il @capacitor-plus scopo
  4. Community-First - Le tue contribuzioni contano e vengono priorizzate
  5. Verificato per la Sicurezza - Ogni modifica viene analizzata dall'AI per vulnerabilità di sicurezza, modifiche che rompono e rischi di stabilità

Pacchetti Disponibili

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

Installazione

Progetto Nuovo

Per un nuovo progetto, utilizza semplicemente 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 Official Capacitor

Per migrare un progetto esistente da official Capacitor 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

Dato che Capacitor+ è un sostituto a caduta di mano con lo stesso API, non sono richieste modifiche code. Le tue importazioni rimangono le stesse:

// 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. Sync Giornaliera: Un'azione GitHub recupera le ultime modifiche da ionic-team/capacitor
  2. Creazione PR: Le modifiche vengono proposte come richieste di pull al plus ramo
  3. Validazione CI: Esegue il set completo di test (lint, test unitari, build iOS, build Android)
  4. Recensione di Claude Code: L'analisi di sicurezza a potenza di intelligenza controlla:
    • Vulnerabilità di sicurezza (iniezione, XSS, ecc.)
    • Modifiche di rottura API
    • Rischio di crash e problemi di stabilità
    • Preoccupazioni per l'integrità dei dati e la privacy
    • Modelli maliziosi di code
  5. Auto-Merge: Solo se CI passa E Claude approva (nessun problema rilevato)
  6. Auto-Pubblica: Una nuova versione viene pubblicata su npm sotto @capacitor-plus/*

Revisione di Sicurezza

Ogni sincronizzazione upstream viene analizzata per:

Controlla Descrizione
Sicurezza Iniezione di comando, XSS, percorso di traversal, segreti hardcoded, ecc.
Cambiamenti Rottami API rimosse/renominati, firme cambiate, cambiamenti di formato di configurazione
Stabilità Riferimenti a 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à Codice code oscurato, chiamate di rete sospette, porte di backdoor

Se vengono rilevati eventuali problemi, il PR viene segnalato per una revisione manuale e NON sarà auto-mergato.

Vuoi che il tuo PR venga Mergato?

Hai un PR bloccato nel repository ufficiale Capacitor? Ecco come farlo entrare in Capacitor+:

  1. Apri un issue nel Capacitor+ repository facendo riferimento al tuo PR upstream
  2. Sottoponi il PR direttamente alla plus ramo
  3. L'equipe lo esaminerà, eseguirà CI e lo unirà se supera

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

Benefici

  • Ricevi PR bloccati ora: Aggiornamenti della community e funzionalità che aspettano upstream vengono uniti
  • Resta al Passo: Ricevi aggiornamenti upstream non appena superano CI
  • Sicurezza Prima: Ogni modifica viene esaminata per vulnerabilità e rischi di stabilità
  • Rilasci VerificatiSolo le modifiche che superano sia le prove di CI che la revisione di sicurezza AI vengono pubblicate
  • Sostituzione FacileLo stesso API di Capacitor, solo con un diverso ambito di pacchetti
  • La tua Voce ContaInvia le tue PR o richiedi PR upstream specifiche per essere mergeate

Esempio: Utilizzo di Capacitor+ con Plugin

Tutti i plugin ufficiali Capacitor funzionano senza problemi 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();

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' });

Ecco fatto! Ora hai una versione aggiornata più velocemente di Capacitor con miglioramenti della community integrate più velocemente. Le tue app beneficeranno di correzioni di bug e funzionalità senza dover attendere il ciclo di rilascio ufficiale.

Continua con l'uso di Using Capacitor+ (@capacitor-plus) Pacchetti

Se stai utilizzando Utilizzando Capacitor+ (@capacitor-plus) Pacchetti per pianificare il lavoro di plugin nativi, connettilo con Capacitor+ per i dettagli di implementazione in Capacitor+ Capgo Directory dei Plugin per il flusso di lavoro del prodotto in Capgo Directory dei Plugin, Capacitor Plugin da Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo, Aggiungere o Aggiornare i Plugin per i dettagli di implementazione in Aggiungere o Aggiornare i Plugin, e Sostituti dei Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Sostituti dei Plugin Enterprise Ionic.