Démarrage rapide

Installation de nouveau projet

You can use our AI-Assisted Setup to install Capacitor+. Add the Capgo skills to your AI tool using the following command:

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

Copier dans le presse-papier

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.

Si vous préférez la configuration manuelle, installez les packages en exécutant les commandes suivantes et suivez les instructions spécifiques à la plateforme ci-dessous :

1. Installer les packages de base

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

2. Ajouter les packages de plateforme

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

3. Initialiser Capacitor

   npm

   npx cap init

   pnpm

   pnpm cap init

   yarn

   yarn cap init

   bun

   bunx cap init

4. Ajouter des plateformes

   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

Migrer depuis l'official Capacitor

Si vous avez un projet Capacitor existant, la migration vers Capacitor+ est simple :

1. Supprimer les packages officiels

   npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

2. Installer 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

3. Synchroniser votre projet

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Note

No code changes required! Capacitor+ has the same API as official Capacitor. Your imports and code remain exactly the same.

Utilisation

Depuis Capacitor+ est API-compatible, vos code existants fonctionnent sans modifications :

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

Avec les plugins officiels Capacitor

Tous les plugins officiels Capacitor fonctionnent sans heurt :

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

Avec Capgo Plugins

Les plugins Capgo fonctionnent parfaitement avec 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();

Comment fonctionne la synchronisation

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  ionic-team/        │     │  CI/CD           │     │  Claude Code     │     │  npm publish    │
│  capacitor          │────▶│  Pipeline        │────▶│  Security Review │────▶│  @capacitor-plus│
│  (upstream)         │     │  (daily sync)    │     │  (AI analysis)   │     │  packages       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘

1. Synchronisation quotidienne: GitHub Actions récupèrent les dernières modifications depuis ionic-team/capacitor
2. Création de PR: Les modifications sont proposées sous forme de requêtes de fusion vers le plus Validation CI
3. : Tout le jeu de tests est exécuté (lint, tests unitaires, build iOS, build Android)Révision de sécurité
4. : L'analyse par intelligence artificielle vérifie les vulnérabilités et les changements brisantsMise automatique à jour
5. : Seulement si CI passe ET la révision de sécurité approuve__CAPGO_KEEP_0__
6. Publier automatiquement: Nouvelle version publiée sur npm sous @capacitor-plus/*

Détails de la revue de sécurité

Tout synchronisme upstream est analysé pour :

Vérifier	Ce qu'il attrape
Sécurité	Injection de commandes, XSS, parcours de chemins, secrets fixés
Changements de rupture	API supprimées/renommées, signatures modifiées, changements de configuration
Stabilité	Références null, exceptions non gérées, conditions de course, fuites de mémoire
Sécurité des données	__CAPGO_KEEP_0__ Intégrité, scénarios de perte de données, violations de la vie privée, stockage non sécurisé
Code Integrity	Obfuscated code, suspicious network calls, backdoors

Soumettre votre PR

Section intitulée « Soumettre votre PR »

Avez-vous un PR bloqué dans le référentiel officiel __CAPGO_KEEP_0__ ? Obtenez-le fusionné en __CAPGO_KEEP_1__+:

Have a PR stuck in the official Capacitor repo? Get it merged in Capacitor+:

1. Ouvrir une question In le Capacitor+ dépôt Se référer à votre PR upstream

2. Ou soumettre directement Comme un PR à la plus branch

3. L'équipe passera en revue, exécutera la CI, et fusionnera si cela passe

Cela permet à vous et aux autres de bénéficier de votre travail immédiatement sans attendre le cycle de mise en production de l'upstream.

FAQ

Est-ce que cela est prêt pour la production?

Yes. Capacitor+ est utilisé dans les applications de production. Chaque mise à jour passe le même ensemble de tests que la version officielle Capacitor, plus une analyse de sécurité supplémentaire.

Mon plugins officiels fonctionneront-ils toujours ?

Oui. Tous les @capacitor/* plugins fonctionnent avec Capacitor+ sans modification.

Quoi se passe si les développeurs upstream publient une modification de rupture ?

La revue de sécurité par l'IA signale les modifications de rupture pour examen manuel. Vous verrez les modifications documentées avant qu'elles soient fusionnées.

Comment signaler des problèmes ?

Signalez des problèmes sur le Capacitor+ GitHub repo. Pour les problèmes qui affectent également Capacitor, nous aiderons à coordonner l'amont.

Puis-je contribuer ?

Absolument ! Les PR sont les bienvenus. Vous pouvez soumettre des correctifs directement ou demander que des PR spécifiques de l'amont soient fusionnés.

Continuez de la section « Démarrage »

Si vous utilisez Démarrage pour planifier le travail de plugin natif, connectez-le avec Utilisation de Capacitor+ (@capacitor-plus) Packages pour la capacité native dans Utilisation de Capacitor+ (@capacitor-plus) Packages, Capgo Répertoire des plugins pour le flux de produit dans le répertoire de plugin Capgo les plugins Capacitor par Capgo pour le détail d'implémentation dans les plugins Capacitor par Capgo, Ajouter ou Mettre à Jour les Plugins pour le détail d'implémentation dans Ajouter ou Mettre à Jour les Plugins, et Alternatives de Plugin d'Entreprise Ionic pour le flux de produit dans Alternatives de Plugin d'Entreprise Ionic.