Prise en main

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

Coller 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 existant Capacitor, la migration vers Capacitor+ est simple :

1. Supprimer les packages officiels

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

2. Installez 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. Synchronisez 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 les 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. Daily Sync: GitHub Actions récupèrent les dernières mises à jour depuis ionic-team/capacitor
2. Création de PR: Changes are proposed as pull requests to the 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 brisants
5. Auto-MergeSeulement si le CI passe et que la revue de sécurité approuve.
6. Auto-Publication: Nouvelle version publiée sous npm @capacitor-plus/*

Détails de la Revue de Sécurité

Chaque synchronisation en amont est analysée pour :

Vérifier	Ce Qu'il Capture
Sécurité	Injection de commande, XSS, parcours de chemins, secrets fixés
Changements Importants	Mises à jour des APIs, changements de signatures, modifications de configuration
Stabilité	Fuites de pointeurs null, exceptions non gérées, conditions de course, fuites de mémoire
Data Safety	Scénarios de perte de données, violations de confidentialité, stockage non sécurisé
Intégrité Code	L'intégrité code obscurcie, appels réseau suspects, backdoors

Attention

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

Soumettre votre PR

Vous avez un PR bloqué dans le référentiel officiel Capacitor ? Le fait de le fusionner vous prendra Capacitor+ :

1. Ouvrir une question dans le Capacitor+ dépôt lié à votre PR upstream

2. Ou soumettre directement en tant que PR à la plus branch

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

Vous et les autres pouvez ainsi profiter de votre travail immédiatement sans attendre le cycle de mise à jour du upstream.

FAQ

Est-ce qu'il est prêt pour la production ?

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

Ma plugin officiel fonctionnera-t-il toujours ?

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

What if upstream releases a breaking change?

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

Comment puis-je signaler des problèmes ?

Signalez des problèmes sur le Capacitor+ GitHub dépôt. Pour les problèmes qui affectent également Capacitor officiel, nous coordonnerons l'amont.

Puis-je contribuer ?

Oui ! Les PR sont les bienvenus. Vous pouvez soumettre des correctifs directement ou demander la fusion de PR spécifiques upstream.

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, Répertoire du Plugin Capgo pour le flux de travail du produit dans le répertoire du plugin Capgo Capacitor Plugins by Capgo pour les détails d'implémentation dans Capacitor Plugins par Capgo Ajouter ou Mettre à Jour des Plugins pour les détails d'implémentation dans l'article Ajouter ou Mettre à Jour des Plugins. Alternatives de plugins Ionic Enterprise pour le flux de travail du produit dans les alternatives du plugin Entreprise Ionic.