Getting Started

Installation de Nouveau Projet

Vous pouvez utiliser notre configuration assistée par l'IA pour installer Capacitor+. Ajoutez les compétences Capgo à votre outil IA à l'aide de la commande suivante :

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

Utilisez ensuite la commande suivante :

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 le Capacitor officiel

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 les packages 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. Synchroniser votre projet

   npm

   npx cap sync

   __CAPGO_KEEP_0__

   pnpm cap sync

   __CAPGO_KEEP_0__

   yarn cap sync

   bun

   bunx cap sync

Remarque

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

Utilisation

Depuis que Capacitor+ est compatible avec API-, votre code existant fonctionne 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 les plugins Capgo

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

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. 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 demandes de tirage vers le plus branchement
3. Validation CI: Tout le jeu de tests est exécuté (lint, tests unitaires, build iOS, build Android)
4. Révision de sécurité: L'analyse par intelligence artificielle vérifie les vulnérabilités et les changements de rupture
5. Mise à jour automatique: Seulement si le CI passe ET la revue de sécurité approuve
6. Publier automatiquement: Nouvelle version publiée sous npm dans @capacitor-plus/*

Détails de la Revue de Sécurité

Chaque synchronisation en amont est analysée pour :

Vérifier	Ce qu'il repère
Sécurité	Injection de commande, XSS, parcours de chemins, secrets fixés
Changements de rupture	APIs supprimés/renommés, changements de signatures, modifications de la configuration
Stabilité	Stabilité
Références à null, exceptions non gérées, conditions de course, fuites de mémoire	Sécurité des données
Code Integrity	Obfuscated code, suspicious network calls, backdoors

Attention

Attention

Si des problèmes sont détectés, le PR est signalé pour examen manuel et NE sera PAS fusionné automatiquement. Cela vous assure toujours des mises à jour stables et sécurisées.

Vous avez un PR bloqué dans le dépôt officiel Capacitor ? Obtenez-l’intégré dans Capacitor+ :

1. Ouvrez une question dans le dépôt Capacitor+ en faisant référence à votre PR upstream

2. Ou soumettez directement comme un PR dans la plus branch

3. Équipe de révision, exécution de CI et intégration si elle passe

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

FAQ

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

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

Mes plugins officiels fonctionneront-ils toujours ?

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

Quoi faire si une mise à jour upstream introduit une modification de rupture ?

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

Comment signaler des problèmes ?

Signalez des problèmes sur le Capacitor+ GitHub repoPour les problèmes qui affectent également le Capacitor officiel, nous coordonnerons l'implémentation upstream.

Peut-on contribuer ?

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

Continuez de la section « Getting Started »

Si vous utilisez Getting Started pour planifier le travail de plugin natif, connectez-l’avec Utilisation de Capacitor+ (@capacitor-plus) Packages pour la capacité native dans l'utilisation de Capacitor+ (@capacitor-plus) Packages, Capgo Répertoire du plugin pour le flux de travail du produit dans Capgo Répertoire du plugin, Capacitor Plugins par Capgo pour le détail d'implémentation dans Capacitor Plugins 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 Plugins Entreprise Ionic pour le flux de travail du produit dans Alternatives de Plugins Entreprise Ionic.