Anleitung
So nutzt du Capacitor+ Core in Capacitor
Nutzung von Capacitor+ (@capacitor-plus) Packages
Capacitor+ ist ein automatisierter, stets synchronisierter Fork von Capacitor gepflegt von Capgo. Es bietet einen direkten Ersatz für die offiziellen Capacitor Pakete mit einem entscheidenden Vorteil: Community-PRs und Fixes werden schneller gemergt.
Warum es Capacitor+ gibt
Das Ionic-Team pflegt Capacitor nach eigenen Prioritäten und Release-Plänen. Das bedeutet, dass Community-Beiträge – Bugfixes, Verbesserungen und Features – Monate oder sogar Jahre auf das Mergen warten können. Manche schaffen es nie.
Capacitor+ löst dieses Problem durch:
- Merging von PRs aus Forks - Wertvolle PRs, die in der Upstream-Queue feststecken, werden aktiv gemergt
- Kontinuierlicher Sync - Jede Änderung aus dem offiziellen Capacitor wird automatisch gepullt, getestet und verifiziert
- Schnelle Releases - Sobald Änderungen die CI bestehen, werden sie automatisch für npm veröffentlicht unter
@capacitor-plusScope - Community-First - Deine Beiträge zählen und werden priorisiert
- Sicherheitsgeprüft - Jede Änderung wird per KI auf Sicherheitslücken, Breaking Changes und Stabilitätsrisiken geprüft
Verfügbare Packages
| Package | Beschreibung |
|---|---|
@capacitor-plus/core |
Core Runtime Library |
@capacitor-plus/cli |
Command-line Interface |
@capacitor-plus/android |
Android Runtime |
@capacitor-plus/ios |
iOS Runtime |
Installation
Neues Projekt
Für ein neues Projekt verwende 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
Initialisiere dann dein Projekt:
npx cap init
npx cap add android
npx cap add ios
Migration 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 Drop-in-Replacement mit demselben API ist, sind keine code Änderungen nötig. Deine Imports bleiben gleich:
// These imports work the same with Capacitor+
import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';
So funktioniert es
┌─────────────────────┐ ┌──────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ ionic-team/ │ │ CI/CD │ │ Claude Code │ │ npm publish │
│ capacitor │────▶│ Pipeline │────▶│ Security Review │────▶│ @capacitor-plus│
│ (upstream) │ │ (daily sync) │ │ (AI analysis) │ │ packages │
└─────────────────────┘ └──────────────────┘ └──────────────────┘ └─────────────────┘
- Täglicher Sync: Eine GitHub Action holt die neuesten Änderungen von
ionic-team/capacitor - PR-Erstellung: Änderungen werden als Pull Requests an den
plusBranch - CI-Validierung: Vollständige Testsuite wird ausgeführt (lint, Unit-Tests, iOS-Build, Android-Build)
- Claude Code Review: Umfassende KI-gestützte Sicherheitsanalyse prüft auf:
- Sicherheitslücken (Injection, XSS, etc.)
- Breaking API Changes
- Crash-Risiken und Stabilitätsprobleme
- Datenintegrität und Datenschutzbedenken
- Schädliche code Patterns
- Auto-Merge: Nur wenn CI besteht UND Claude zustimmt (keine Probleme gefunden)
- Auto-Publish: Eine neue Version wird unter npm veröffentlicht
@capacitor-plus/*
Sicherheitsprüfung
Bei jedem Upstream-Sync wird geprüft:
| Prüfen | Beschreibung |
|---|---|
| Sicherheit | Command Injection, XSS, Path Traversal, hardcodierte Secrets usw. |
| Breaking Changes | Entfernte/umbenannte APIs, geänderte Signaturen, Config-Formatänderungen |
| Stabilität | Null Dereferences, unbehandelte Exceptions, Race Conditions, Memory Leaks |
| Datensicherheit | Datenverlust-Szenarien, Datenschutzverletzungen, unsichere Speicherung |
| Code Integrität | Obfuskierter code, verdächtige Netzwerkaufrufe, Backdoors |
Werden Probleme erkannt, wird der PR für eine manuelle Prüfung markiert und NICHT automatisch gemerged.
Willst du, dass dein PR gemergt wird?
Ein PR steckt im offiziellen Capacitor Repo fest? So bringst du ihn in Capacitor+:
- Issue eröffnen im Capacitor+ Repo Verlinkung zu deinem Upstream-PR
- Oder den PR direkt einreichen zum
plusBranch - Das Team prüft den PR, lässt die CI laufen und merget ihn bei Erfolg.
So profitieren du und andere sofort von deiner Arbeit, ohne auf den Upstream-Release-Zyklus zu warten.
Vorteile
- Stuck PRs jetzt nutzen: Community-Fixes und Features, die upstream warten, werden gemergt
- Immer aktuell bleiben: Erhalte Upstream-Fixes, sobald sie die CI bestehen
- Sicherheit an erster Stelle: Jede Änderung wird auf Schwachstellen und Stabilitätsrisiken geprüft
- Verifizierte Releases: Nur Änderungen, die sowohl die CI-Tests ALS AUCH das AI-Security-Review bestehen, werden veröffentlicht
- Direkter Ersatz: Gleiches API wie Capacitor, nur mit anderem Package-Scope
- Deine Meinung zählt: Reiche eigene PRs ein oder fordere das Mergen spezifischer Upstream-PRs an
Beispiel: Capacitor+ mit Plugins nutzen
Alle offiziellen Capacitor Plugins funktionieren nahtlos 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! Du hast jetzt eine schneller aktualisierte Version von Capacitor, bei der Community-Verbesserungen schneller gemergt werden. Deine Apps profitieren von Bugfixes und Features, ohne auf den offiziellen Release-Zyklus warten zu müssen.
Weiterlesen: Nutzung von Capacitor+ (@capacitor-plus) Packages
Wenn du es nutzt Nutzung von Capacitor+ (@capacitor-plus) Packages Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Capacitor+ für die Implementierungsdetails in Capacitor+ Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.