Leitfaden
Anleitung zu 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: Community-PRs und -Fehler werden schneller integriert.
Warum Capacitor+ existiert
Die Ionic-Team pflegt Capacitor mit ihren eigenen Prioritäten und Veröffentlichungszeiträumen. Dies bedeutet, dass Community-Beiträge - Fehlerbehebungen, Verbesserungen und Funktionen - Monate oder sogar Jahre auf sich warten lassen, um integriert zu werden. Einige werden nie überhaupt integriert.
Capacitor+ löst dieses Problem auf folgende Weise:
- Merging von PRs aus Forks - Wichtige PRs, die im Hauptstromstamm stecken, werden aktiv integriert
- Kontinuierliche Synchronisation - Jeder Änderung aus dem Hauptstromstamm Capacitor wird automatisch gezogen, getestet und überprüft
- Schnelle Veröffentlichungen - Wenn Änderungen CI bestehen, werden sie automatisch unter dem npm-Scope veröffentlicht
@capacitor-plusscope - Community-orientiert - Ihre Beiträge haben Priorität und werden berücksichtigt
- Sicherheitsüberprüft - Jeder Änderungsvorschlag wird von AI für Sicherheitslücken, Änderungen und Stabilitätsrisiken analysiert
Verfügbare Pakete
| Paket | Beschreibung |
|---|---|
@capacitor-plus/core |
Kernlaufzeitbibliothek |
@capacitor-plus/cli |
Befehlszeileninterface |
@capacitor-plus/android |
Android-Laufzeitumgebung |
@capacitor-plus/ios |
iOS-Laufzeitumgebung |
Installation
Neues 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
Initialisieren Sie dann Ihr Projekt:
npx cap init
npx cap add android
npx cap add ios
Migrieren von offiziellen Capacitor
Um ein bestehendes Projekt von offiziellen 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 Ersatz für 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 │
└─────────────────────┘ └──────────────────┘ └──────────────────┘ └─────────────────┘
- Tägliche Synchronisierung: Ein GitHub-Action holt die neuesten Änderungen von
ionic-team/capacitor - Erstellung von PR: Änderungen werden als Pull Requests an den
plusZweig - CI-Validierung: Vollständige Test-Suite läuft (Lint, Einheitstests, iOS-Build, Android-Build)
- Claude Code-Überprüfung: KI-gestützte umfassende Sicherheitsanalyse überprüft:
- Sicherheitslücken (Einschübe, XSS usw.)
- Zerstörung API-Änderungen
- Risiken für Abstürze und Stabilitätsprobleme
- Datensicherheit und Datenschutzbedenken
- Bösartige code-Muster
- Auto-Merge: Nur wenn CI erfolgreich ist UND Claude genehmigt (keine Probleme gefunden)
- Auto-Publish: Eine neue Version wird unter npm veröffentlicht.
@capacitor-plus/*
Security Review
Jeder Upstream-Sync wird auf folgende Sicherheitsrisiken analysiert:
| Check | Beschreibung |
|---|---|
| Sicherheit | Kommando-Inject, XSS, Pfad-Traversal, festgelegte Geheimnisse usw. |
| Breaking Changes | Entfernte/umbenannte APIs, geänderte Signatur, Änderungen der Konfigurationsformat |
| Stabilität | Null-Verweise, unbehaltene Exceptions, Rassenbedingungen, Speicherverluste |
| Datensicherheit | Datenverlustszenarien, Verletzungen der Privatsphäre, unsichere Speicherung |
| Code Integrität | Verschlüsselte code, verdächtige Netzwerkaufrufe, Hintertüren |
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 akzeptiert wird?
Hast du einen Pull-Request, der im offiziellen Capacitor-Repository steckt? Hier ist, wie du ihn in Capacitor+ einbringen kannst:
- Öffne ein Issue im Capacitor+-Repository mit Verweis auf deinen upstream-Pull-Request
- Oder stelle den Pull-Request direkt an
plusZweig - Das Team wird es überprüfen, CI ausführen und es mergen, wenn es besteht
Somit können Sie und andere sofort von Ihrem Werk profitieren, ohne auf das Release-Zyklus der Oberfläche warten zu müssen
Vorteile
- Kontext: Seite/Bereich: Capgo-Lösungen-Marketingseite. Rolle: UI-Label. Anzeige in: Seite solutions/cordova-to-capacitor.astro. Nachrichtenschlüssel `solutions_cordova_to_capacitor_benefits_label` (Lösungen Cordova To Capacitor Vorteile Label)Jetzt PRs, die stecken bleiben
- : Gemeinschafts-Fixes und -Features, die im Oberflächen-Release warten, werden gemergedAktuell bleiben
- : Oberflächen-Fixes erhalten, sobald sie CI bestehenSicherheit zuerst
- : Jeder Änderung wird auf Sicherheitslücken und Stabilitätsrisiken überprüftVerifizierte Releases
- Ersatz für die Standardversion: Gleiches API wie Capacitor, nur ein anderer Paketbereich
- Ihre Stimme zählt: Senden Sie Ihre eigenen Pull Requests oder fordern Sie spezifische Pull Requests von oben an, um sie zu melden
Beispiel: Verwendung von 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 Verwendung von Capacitor+ (@capacitor-plus) Packages
Wenn Sie __CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) Packages verwenden Verwendung von Capacitor+ (@capacitor-plus) Packages um native Plugin-Arbeit zu planen, verbinden Sie es mit Capacitor+ zur Implementierungsdetail in Capacitor+ Capgo Plugin-Verzeichnis zur Produktworkflow in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo zur Implementierungsdetail in Capacitor Plugins von Capgo Hinzufügen oder Aktualisieren von Plugins zur Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins, und Ionische Enterprise-Plugin-Alternativen zur Produktworkflow in Ionische Enterprise-Plugin-Alternativen.