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
- Security-Review inklusive - Jede Änderung wird per KI auf Sicherheitslücken, Breaking Changes und Stabilitätsrisiken geprüft
Verfügbare Packages
| Paket | 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 einen manuellen Review 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 mit Link 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 gemerged
- 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: Es werden nur Änderungen veröffentlicht, die sowohl die CI-Tests als auch den AI-Security-Review bestehen
- Direkter Ersatz: Das gleiche API wie Capacitor, nur mit einem anderen 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 nun eine schneller aktualisierte Version von Capacitor, bei der Community-Improvements 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.