Guide
Comment utiliser Capacitor+ Core dans Capacitor
Utiliser les packages Capacitor+ (@capacitor-plus)
Capacitor+ est un fork automatisé et toujours synchronisé de Capacitor maintenu par Capgo. Il fournit un remplacement direct des packages officiels Capacitor, avec un avantage majeur : community PRs and fixes are merged faster.
Pourquoi Capacitor+ existe
L'équipe Ionic maintient Capacitor selon ses propres priorités et son calendrier de release. Cela signifie que les contributions de la communauté — correctifs de bugs, améliorations et fonctionnalités — peuvent mettre des mois, voire des années, à être fusionnées. Certaines ne sont jamais intégrées.
Capacitor+ résout ce problème en :
- Fusion des PR issues des forks Les PR utiles bloquées dans la file d'attente upstream sont activement fusionnées
- Synchronisation continue Chaque changement upstream de Capacitor est automatiquement récupéré, testé et vérifié
- Releases rapides Lorsque les changements passent la CI, ils sont automatiquement publiés sur npm sous le
@capacitor-pluspérimètre - Communauté d'abord - Vos contributions comptent et sont traitées en priorité
- Sécurité vérifiée - Chaque modification est analysée par l'IA pour détecter les vulnérabilités, les changements cassants et les risques d'instabilité
Paquets disponibles
| Paquet | Description |
|---|---|
@capacitor-plus/core |
Bibliothèque runtime principale |
@capacitor-plus/cli |
Interface en ligne de commande |
@capacitor-plus/android |
Runtime Android |
@capacitor-plus/ios |
Runtime iOS |
Installation
Nouveau projet
Pour un nouveau projet, utilisez simplement les paquets Capacitor+ à la place des paquets officiels :
npm install @capacitor-plus/core @capacitor-plus/cli
npm install @capacitor-plus/android # for Android
npm install @capacitor-plus/ios # for iOS
Puis initialisez votre projet :
npx cap init
npx cap add android
npx cap add ios
Migration depuis Capacitor officiel
Pour migrer un projet existant des paquets officiels Capacitor vers 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
Puisque Capacitor+ est un remplacement direct avec la même API, aucune modification de code n’est requise. Vos imports restent identiques :
// These imports work the same with Capacitor+
import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';
Comment ça marche
┌─────────────────────┐ ┌──────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ ionic-team/ │ │ CI/CD │ │ Claude Code │ │ npm publish │
│ capacitor │────▶│ Pipeline │────▶│ Security Review │────▶│ @capacitor-plus│
│ (upstream) │ │ (daily sync) │ │ (AI analysis) │ │ packages │
└─────────────────────┘ └──────────────────┘ └──────────────────┘ └─────────────────┘
- Daily Sync: une Action GitHub récupère les dernières modifications depuis
ionic-team/capacitor - Création de la PR: Les changements sont proposés via des pull requests vers le
plusbranche - Validation CI: Exécution de la suite de tests complète (lint, tests unitaires, build iOS, build Android)
- Revue Claude Code: Une analyse de sécurité complète par IA vérifie :
- Les vulnérabilités de sécurité (injection, XSS, etc.)
- Les changements cassants de API
- Risques de crash et problèmes de stabilité
- Enjeux d’intégrité des données et de confidentialité
- Les patterns malveillants dans le code
- Auto-merge: Uniquement si la CI passe ET si Claude approuve (aucun problème détecté)
- Auto-publication: Une nouvelle version est publiée sur npm sous
@capacitor-plus/*
Revue de sécurité
Chaque synchronisation en amont est analysée pour :
| Vérifier | Description |
|---|---|
| Sécurité | Injection de commandes, XSS, path traversal, secrets codés en dur, etc. |
| Breaking changes | API supprimées ou renommées, signatures modifiées, changements de format de config |
| Stabilité | Déréférencements de null, exceptions non gérées, race conditions, fuites de mémoire |
| Data Safety | Scénarios de perte de données, atteintes à la vie privée, stockage non sécurisé |
| Intégrité de l'Code | code obfusqué, appels réseau suspects, backdoors |
Si des problèmes sont détectés, la PR est signalée pour une revue manuelle et ne sera PAS fusionnée automatiquement.
Vous voulez que votre PR soit fusionnée ?
Une PR est bloquée dans le repo officiel de Capacitor ? Voici comment l'intégrer à Capacitor+ :
- Ouvrir une issue dans l' Repo Capacitor+ faisant le lien avec votre PR upstream
- Ou soumettez directement la PR aux
plusbranche - L'équipe l'examinera, lancera la CI et la mergera si elle passe
Ainsi, vous et d'autres pouvez bénéficier de votre travail immédiatement, sans attendre le cycle de release upstream.
Avantages
- Récupérez les PR bloquées maintenantLes correctifs et fonctionnalités de la communauté en attente côté upstream sont mergés
- Restez à jourRecevez les correctifs upstream dès qu'ils passent la CI
- La sécurité d'abordChaque modification est examinée pour détecter d'éventuelles vulnérabilités ou risques de stabilité
- Releases vérifiées: Seules les modifications qui passent les tests CI ET la revue de sécurité IA sont publiées
- Remplacement direct: Même API que Capacitor, juste un scope de package différent
- Votre avis compte: Soumettez vos propres PR ou demandez la fusion de PR upstream spécifiques
Exemple : utiliser Capacitor+ avec des plugins
Tous les plugins officiels Capacitor fonctionnent parfaitement avec 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();
Les plugins Capgo fonctionnent aussi parfaitement avec 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' });
C’est tout ! Vous avez maintenant une version de Capacitor mise à jour plus rapidement, avec les améliorations de la communauté fusionnées plus vite. Vos applications bénéficieront de correctifs et de nouvelles fonctionnalités sans attendre le cycle de release officiel.
Continuez avec Utilisation des packages Capacitor+ (@capacitor-plus)
Si vous utilisez Utiliser les packages Capacitor+ (@capacitor-plus) pour planifier le travail sur les plugins natifs, connectez-l’à Capacitor+ pour les détails d'implémentation dans Capacitor+, Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Ajout ou mise à jour de plugins, et Alternatives aux plugins Ionic Enterprise pour le workflow produit dans Alternatives aux plugins Ionic Enterprise.