Zum Hauptinhalt springen
@capacitor-plus/core Entwicklertools Open Source

Capacitor+ Core Capacitor Plugin

Capacitor+ ist ein automatisierter, stets synchronisierter Fork von Capacitor mit integrierten Community-PRs und schnellen Releases

Installieren

bun add @capacitor-plus/core bunx cap sync
npm, pnpm oder yarn
  • npm install @capacitor-plus/core
  • pnpm add @capacitor-plus/core
  • yarn add @capacitor-plus/core

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:

  1. Merging von PRs aus Forks - Wertvolle PRs, die in der Upstream-Queue feststecken, werden aktiv gemergt
  2. Kontinuierlicher Sync - Jede Änderung aus dem offiziellen Capacitor wird automatisch gepullt, getestet und verifiziert
  3. Schnelle Releases - Sobald Änderungen die CI bestehen, werden sie automatisch für npm veröffentlicht unter @capacitor-plus Scope
  4. Community-First - Deine Beiträge zählen und werden priorisiert
  5. 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       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘
  1. Täglicher Sync: Eine GitHub Action holt die neuesten Änderungen von ionic-team/capacitor
  2. PR-Erstellung: Änderungen werden als Pull Requests an den plus Branch
  3. CI-Validierung: Vollständige Testsuite wird ausgeführt (lint, Unit-Tests, iOS-Build, Android-Build)
  4. 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
  5. Auto-Merge: Nur wenn CI besteht UND Claude zustimmt (keine Probleme gefunden)
  6. 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+:

  1. Issue eröffnen im Capacitor+ Repo Verlinkung zu deinem Upstream-PR
  2. Oder den PR direkt einreichen zum plus Branch
  3. 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.

FAQ

Capacitor+ Core Plugin FAQ

Wie installiere ich das Capacitor+ Core Plugin in einer Capacitor App?

Führe "bun add @capacitor-plus/core" (oder "npm install @capacitor-plus/core") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capacitor-plus/core".

Funktioniert @capacitor-plus/core mit React, Vue und Angular?

Ja. Capacitor+ Core ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor Version wird von @capacitor-plus/core unterstützt?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capacitor-plus/core kostenlos und Open Source?

Ja. Der code Source Code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-plus/ einsehbar und das Package kann kostenlos via npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Capacitor+ Core aktualisieren, ohne ein App Store Review abzuwarten?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Veröffentliche Capacitor+ Core-Änderungen, ohne auf den App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo