Aller au contenu principal
@capacitor-plus/core Outils développeurs Open source

Capacitor + Core Plugin Capacitor

Capacitor+ est un fork automatisé et toujours synchronisé de Capacitor, incluant les PR de la communauté et des releases rapides

Installer

bun add @capacitor-plus/core bunx cap sync
npm, pnpm ou yarn
  • npm install @capacitor-plus/core
  • pnpm add @capacitor-plus/core
  • yarn add @capacitor-plus/core

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 :

  1. Fusion des PR issues des forks Les PR utiles bloquées dans la file d'attente upstream sont activement fusionnées
  2. Synchronisation continue Chaque changement upstream de Capacitor est automatiquement récupéré, testé et vérifié
  3. Releases rapides Lorsque les changements passent la CI, ils sont automatiquement publiés sur npm sous le @capacitor-plus périmètre
  4. Communauté d'abord - Vos contributions comptent et sont traitées en priorité
  5. 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       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘
  1. Daily Sync: une Action GitHub récupère les dernières modifications depuis ionic-team/capacitor
  2. Création de la PR: Les changements sont proposés via des pull requests vers le plus branche
  3. Validation CI: Exécution de la suite de tests complète (lint, tests unitaires, build iOS, build Android)
  4. 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
  5. Auto-merge: Uniquement si la CI passe ET si Claude approuve (aucun problème détecté)
  6. 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+ :

  1. Ouvrir une issue dans l' Repo Capacitor+ faisant le lien avec votre PR upstream
  2. Ou soumettez directement la PR aux plus branche
  3. 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.

FAQ

FAQ du plugin Capacitor+ Core

Comment installer le plugin Capacitor+ Core dans une application Capacitor ?

Exécutez "bun add @capacitor-plus/core" (ou "npm install @capacitor-plus/core"), puis lancez "bunx cap sync" pour que les projets iOS et Android récupèrent le code natif de code. Importez-le depuis "@capacitor-plus/core" dans le code de votre application.

Est-ce que @capacitor-plus/core fonctionne avec React, Vue et Angular ?

Oui. Capacitor+ Core est un package Capacitor, il fonctionne donc avec n'importe quel framework web qui tourne dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et du JavaScript simple.

Quelle version de Capacitor @capacitor-plus/core prend-il en charge ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capacitor-plus/core est gratuit et open source ?

Oui. Le code source de code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-plus/ et le package s'installe gratuitement depuis npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Capacitor+ Core sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez Capacitor+ et des changements Core sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo