@Capacitor+ Core

Mit Capacitor+ (@capacitor-plus) Paketen arbeiten

Capacitor+ ist ein automatisiertes, immer synchronisiertes Fork von Capacitor von Capgo. Es bietet einen einbaufertigen Ersatz für die offiziellen Capacitor-Pakete mit einem wichtigen Vorteil: Community-PRs und -Fixes werden schneller integriert.

Warum Capacitor+ existiert

Die Ionic-Team hält Capacitor mit ihren eigenen Prioritäten und Release-Schema. Dies bedeutet, dass Community-Beiträge - Bugfixes, Verbesserungen und Funktionen - Monate oder sogar Jahre auf eine Merge warten können. Einige werden nie überhaupt integriert.

Capacitor+ löst dieses Problem durch:

1. Merging von PRs aus Forks - Wertvolle PRs, die sich im upstream-Queue befinden, werden aktiv integriert
2. Kontinuierliche Synchronisation - Jeder Änderung von upstream Capacitor wird automatisch gezogen, getestet und verifiziert
3. Schnelle Veröffentlichungen - Wenn Änderungen CI passieren, werden sie automatisch auf npm unter dem @capacitor-plus Scope
4. Community-orientiert - Ihre Beiträge zählen und werden priorisiert
5. Sicherheitsüberprüfung - Jeder Änderung wird von AI auf Sicherheitslücken, Änderungen, die den Betrieb beeinträchtigen und Stabilitätsrisiken analysiert

Verfügbare Pakete

Installation

Neues Projekt

Für ein neues Projekt verwenden Sie einfach die Capacitor+ Pakete anstatt 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

Von Official Capacitor auf Capgo migrieren

Um ein bestehendes Projekt von Official Capacitor auf Capacitor+ zu migrieren:

# 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

Da Capacitor+ ein einbaufertiges Ersatzteil mit demselben API ist, sind keine code Änderungen erforderlich. Ihre Imports bleiben gleich:

// 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: Ein GitHub-Action holt die neuesten Änderungen von 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 (Linter, Einheitstests, iOS-Build, Android-Build)
4. Claude Code Review: KI-gestützte umfassende Sicherheitsanalyse überprüft:
   • Sicherheitslücken (Einschübe, XSS usw.)
   • Zerbrechende API Änderungen
   • Risiken für Abstürze und Stabilitätsprobleme
   • Datenschutz- und Privatsphäre-Bedrohungen
   • Bösartige code Muster
5. Auto-Merge: Nur wenn CI erfolgreich ist UND Claude genehmigt (keine Probleme gefunden)
6. Auto-Publish: Eine neue Version wird unter npm veröffentlicht @capacitor-plus/*

Sicherheits-Review

Jeder Upstream-Sync wird auf folgende Aspekte analysiert:

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

Willst du, dass dein PR zusammengeführt wird?

Hast du einen PR, der im offiziellen Capacitor-Repo steckt? Hier ist, wie du ihn in Capacitor+ bekommst:

1. Öffne ein Issue im Capacitor+-Repo mit Verweis auf deinen upstream-PR
2. Oder submitte den PR direkt an den plus Zweig
3. Das Team wird ihn überprüfen, CI ausführen und ihn zusammenführen, wenn er besteht

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

Vorteile

• Jetzt PRs blockieren: Gemeinschafts-Fixes und -Features, die im Oberflächen-Branch warten, werden integriert
• Aktuell bleiben: Oberflächen-Fixes erhalten Sie, sobald sie die CI-Tests bestanden haben
• Sicherheit zuerst: Jeder Änderung wird auf mögliche Sicherheitslücken und Stabilitätsrisiken hin überprüft
• Verifizierte Releases: Nur Änderungen, die sowohl die CI-Tests als auch die Sicherheitsüberprüfung durch KI bestanden haben, werden veröffentlicht
• Einfach einsetzbar: Das gleiche API wie Capacitor, nur mit einer anderen Paket-Scope
• Ihre Stimme zählt: Senden Sie Ihre eigenen PRs oder fordern Sie spezifische upstream-PRs an, um sie zu mergen

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 es! 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.

Fortsetzen Sie mit Using Capacitor+ (@capacitor-plus) Packages

Wenn Sie " Verwenden Sie Capacitor+ (@capacitor-plus) Packages" zum Planen von native Plugin-Arbeit, verbinden Sie es mit " __CAPGO_KEEP_0__+" für die Implementierungsdetails in Capacitor+, Keep going from Using Capacitor+ (@__CAPGO_KEEP_1__-plus) Packages Capgo Plugin Verzeichnis für den Produktworkflow in Capgo Plugin Verzeichnis 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 Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen.