Capacitor+ Core

Verwendung von Capacitor+ (@capacitor-plus) Paketen

Capacitor+ ist ein automatisiertes, immer synchronisiertes Fork von Capacitor unterhalten von Capgo. Es bietet eine einfache Ersatzlösung für die offiziellen Capacitor-Pakete mit einem wichtigen Vorteil: Kommunale PRs und Fixes werden schneller integriert.

Why Capacitor+ Exists

Die Ionic-Team pflegt Capacitor mit ihren eigenen Prioritäten und Veröffentlichungszeiträumen. Dies bedeutet, dass Community-Beiträge - Fehlerkorrekturen, Verbesserungen und Funktionen - Monate oder sogar Jahre auf eine Merge warten müssen. Einige werden nie integriert.

Capacitor+ löst dieses Problem auf folgende Weise:

1. Pull Requests von Forks integrieren - Wichtige Pull Requests, die im Hauptstromstamm stecken, werden aktiv integriert
2. Kontinuierliche Synchronisation - Jeder Änderungsvorschlag aus dem Hauptstrom Capacitor wird automatisch gezogen, getestet und überprüft
3. Schnelle Veröffentlichungen - When changes pass CI, they're automatically published to npm under the @capacitor-plus Spielraum
4. Scope Community-orientiertes Vorgehen ist wichtig, da Ihre Beiträge priorisiert werden
5. Sicherheitsüberprüfung Jeder Änderung wird durch KI für Sicherheitslücken, Änderungen, die den Betrieb beeinträchtigen, und Stabilitätsrisiken analysiert

Verfügbare Pakete

Installation

Neuer Projekt

Für ein neues Projekt verwenden Sie einfach die Capacitor+-Pakete anstelle der offiziellen:

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

Dann initialisieren Sie Ihr Projekt:

npx cap init
npx cap add android
npx cap add ios

Migrating from Official Capacitor

To migrate an existing project from official Capacitor to 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

Since Capacitor+ is a drop-in replacement with the same API, no code changes are required. Your imports remain the same:

// These imports work the same with Capacitor+
import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

Wie es funktioniert

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

1. Tägliche Synchronisierung: A GitHub Action fetches the latest changes from ionic-team/capacitor
2. Erstellung von Pull Requests: Änderungen werden als Pull Requests zur plus Zweig
3. Validierung durch CI: Vollständige Test-Suite läuft (Lint, Einheitstests, iOS-Build, Android-Build)
4. Claude Code Review: KI-gestützte umfassende Sicherheitsanalyse prüft:
   • Sicherheitslücken (Einschübe, XSS usw.)
   • Breaking API changes
   • Risiken für Abstürze und Stabilitätsprobleme
   • Datensicherheit und Datenschutzbedenken
   • Malicious code patterns
5. Auto-Merge: Nur wenn CI erfolgreich ist UND Claude genehmigt (keine Probleme gefunden)
6. Auto-Publish: A new version is published to npm under @capacitor-plus/*

Sicherheitsüberprüfung veröffentlicht

Jeder Upstream-Synchronisierungsvorgang wird auf folgende Aspekte analysiert:

Wenn bei der Überprüfung Probleme festgestellt werden, wird der Pull-Request für eine manuelle Überprüfung markiert und wird NICHT automatisch zusammengeführt.

Willst du, dass dein Pull-Request zusammengeführt wird?

Hast du einen Pull-Request, der im offiziellen Capacitor-Repository steckt? Hier ist, wie du ihn in Capacitor+ einbringen kannst:

1. Öffne ein Issue im Capacitor+ Repository mit einem Link zu deinem upstream-Pull-Request
2. Oder submitte den Pull-Request direkt in die plus Zweig
3. Branch

So können Sie und andere sofort von Ihrem Werk profitieren, ohne auf das Release-Zyklus der Oberfläche zu warten.

Vorteile

• Aktuelle Pull RequestsCommunity-Fixes und -Features, die in der Oberfläche warten, werden integriert
• Aktuell bleibenAktuelle Fixes von der Oberfläche erhalten, sobald sie die CI-Tests bestanden haben
• Sicherheit zuerstJeder Änderung wird auf mögliche Sicherheitslücken und Stabilitätsrisiken hin überprüft
• Gewährleistete ReleasesNur Änderungen, die sowohl die CI-Tests als auch die Sicherheitsprüfung bestanden haben, werden veröffentlicht
• Einfach einsetzbares Ersatzteil: Same API as Capacitor, just a different package scope
• Ihre Stimme zählt: Unterbreiten Sie Ihre eigenen Pull Requests oder fordern Sie spezifische Pull Requests von oben an, um sie zu melden

Beispiel: Verwenden Sie Capacitor+ mit Plugins

Alle offiziellen Capacitor-Plugins funktionieren reibungslos mit 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();

Capgo-Plugins funktionieren auch perfekt mit 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' });

Das ist alles! Sie haben jetzt eine schneller aktualisierte Version von Capacitor mit Community-Verbesserungen, die schneller integriert werden. Ihre Apps werden von Bug-Fixes und Funktionen profitieren, ohne auf das offizielle Release-Zyklus warten zu müssen.

Weitermachen von Verwenden Sie Capacitor+ (@capacitor-plus) Packages

Wenn Sie __CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) Packages verwenden Verwenden Sie Capacitor+ (@capacitor-plus) Packages Um native Plugin-Arbeit zu planen, verbinden Sie es mit Capacitor+ für die Implementierungsdetails in Capacitor+ Plugin-Verzeichnis von Capgo für den Produktworkflow in Plugin-Verzeichnis von Capgo Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren und Alternativen zu Ionic Enterprise Plugins für den Produktworkflow in Alternativen zu Ionic Enterprise Plugins.