Erste Schritte

Quickstart

bun add @capgo/capacitor-plus
npx cap sync

Häufige Stolperfallen

• Alle @capacitor/* Abhängigkeiten ersetzen.
• Native Projekte nach der Migration neu generieren.
• Lies die Release Notes vor dem Update.

Installation in neuen Projekten

Du kannst unser AI-Assisted Setup nutzen, um Capacitor+ zu installieren. Füge deinem AI-Tool die Capgo Skills mit folgendem Befehl hinzu:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Nutze dann diesen Prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capacitor-plus/core`, `@capacitor-plus/cli`, `@capacitor-plus/android`, and `@capacitor-plus/ios` packages in my project.

Wenn du ein Manual Setup bevorzugst, installiere die Packages mit den folgenden Befehlen und folge den plattformspezifischen Anweisungen unten:

1. Core-Packages installieren

   npm install @capacitor-plus/core @capacitor-plus/cli

2. Plattform-Packages hinzufügen

   npm install @capacitor-plus/android  # for Android
   npm install @capacitor-plus/ios      # for iOS

3. Capacitor initialisieren

   npm

   npx cap init

   pnpm

   pnpm cap init

   yarn

   yarn cap init

   bun

   bunx cap init

4. Plattformen hinzufügen

   npm

   npx cap add android

   pnpm

   pnpm cap add android

   yarn

   yarn cap add android

   bun

   bunx cap add android

   npm

   npx cap add ios

   pnpm

   pnpm cap add ios

   yarn

   yarn cap add ios

   bun

   bunx cap add ios

Migration vom offiziellen Capacitor

Wenn du bereits ein Capacitor Projekt hast, ist die Migration auf Capacitor+ ganz einfach:

1. Offizielle Packages entfernen

   npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

2. Capacitor+ Pakete installieren

   npm install @capacitor-plus/core @capacitor-plus/cli
   npm install @capacitor-plus/android  # if using Android
   npm install @capacitor-plus/ios      # if using iOS

3. Projekt synchronisieren

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Hinweis

Keine code Änderungen nötig! Capacitor+ nutzt dieselbe API wie das offizielle Capacitor. Deine Imports und code bleiben exakt gleich.

Nutzung

Da Capacitor+ API-kompatibel ist, funktioniert deine bestehende code ohne Änderungen:

import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

// Check platform
const platform = Capacitor.getPlatform();
console.log('Running on:', platform);

// Check if native
if (Capacitor.isNativePlatform()) {
  console.log('Running on native platform');
}

// Register a custom plugin
const MyPlugin = registerPlugin('MyPlugin');

Mit offiziellen Capacitor Plugins

Alle offiziellen Capacitor Plugins funktionieren nahtlos:

import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';
import { Storage } from '@capacitor/preferences';

// Camera
const photo = await Camera.getPhoto({
  quality: 90,
  resultType: CameraResultType.Uri
});

// Geolocation
const position = await Geolocation.getCurrentPosition();

// Storage
await Storage.set({ key: 'name', value: 'John' });

Mit Capgo Plugins

Capgo Plugins funktionieren perfekt mit Capacitor+:

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';
import { CapacitorFlash } from '@capgo/capacitor-flash';

// Live updates
await CapacitorUpdater.notifyAppReady();

// Screen orientation
await ScreenOrientation.lock({ orientation: 'portrait' });

// Flashlight
await CapacitorFlash.toggle();

So funktioniert der Sync

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  ionic-team/        │     │  CI/CD           │     │  Claude Code     │     │  npm publish    │
│  capacitor          │────▶│  Pipeline        │────▶│  Security Review │────▶│  @capacitor-plus│
│  (upstream)         │     │  (daily sync)    │     │  (AI analysis)   │     │  packages       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘

1. Täglicher Sync: GitHub Actions laden 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. Sicherheitsprüfung: KI-gestützte Analyse prüft auf Sicherheitslücken und Breaking Changes
5. Auto-Merge: Nur wenn CI durchläuft UND das Security-Review zustimmt
6. Auto-Publish: Neue Version wird bei npm veröffentlicht unter @capacitor-plus/*

Security-Review-Details

Bei jedem Upstream-Sync wird geprüft:

Prüfen	Was erkannt wird
Sicherheit	Command Injection, XSS, Path Traversal, Hardcoded Secrets
Breaking Changes	Entfernte/umbenannte APIs, geänderte Signaturen, Config-Ä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

Achtung

Falls Probleme erkannt werden, wird der PR für eine manuelle Prüfung markiert und NICHT automatisch gemerged. So stellst du immer stabile und sichere Releases sicher.

Deinen PR einreichen

Steckt dein PR im offiziellen Capacitor Repo fest? Merge ihn in Capacitor+:

1. Issue eröffnen im Capacitor+ Repo mit Link zu deinem Upstream-PR

2. Oder direkt einreichen als PR an den plus Branch

3. Das Team prüft, lässt die CI laufen und merged, wenn alles passt.

So profitieren du und andere sofort von deiner Arbeit, ohne auf den Upstream-Release-Zyklus warten zu müssen.

FAQ

Ist das produktionsreif?

Ja. Capacitor+ wird in Produktions-Apps eingesetzt. Jedes Release durchläuft dieselbe Testsuite wie offizielle Capacitor, ergänzt um zusätzliche Sicherheitsanalysen.

Funktionieren meine offiziellen Plugins weiterhin?

Ja. Alle @capacitor/* Plugins funktionieren sofort mit Capacitor+.

Was passiert bei Breaking Changes im Upstream?

Der AI-Security-Review markiert Breaking Changes zur manuellen Prüfung. Du siehst die Änderungen dokumentiert, bevor sie gemerged werden.

Wie melde ich Issues?

Erstelle Issues im Capacitor+ GitHub RepoBei Problemen, die auch offizielle Capacitor betreffen, unterstützen wir bei der Koordination upstream.

Kann ich mitwirken?

Absolut! PRs sind jederzeit willkommen. Du kannst Fixes direkt einreichen oder darum bitten, dass bestimmte Upstream-PRs gemerged werden.

Weiter geht's nach Getting Started

Wenn du es nutzt Erste Schritte Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Nutzung von Capacitor+ (@capacitor-plus) Packages für die native Funktionalität in Using Capacitor+ (@capacitor-plus) Packages, 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.