Einstieg

Neuer Projektinstallation

1. Installieren Sie die Kernpakete

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

2. Hinzufügen von Plattformpaketen

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

3. Initialisieren Sie Capacitor

   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

Von offiziellen Capacitor migrieren

Wenn Sie ein bestehendes Capacitor-Projekt haben, ist die Migration zu Capacitor+ einfach:

1. Offizielle Pakete entfernen

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

2. Installieren Sie Capacitor+ Pakete

   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. Synchronisieren Sie Ihr Projekt

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Hinweis

Keine code Änderungen erforderlich! Capacitor+ hat das gleiche API wie offizielle Capacitor. Ihre Importe und code bleiben genau gleich.

Verwendung

Da Capacitor+ API-kompatibel ist, funktionieren Ihre bestehenden 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 reibungslos:

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();

Wie die Synchronisierung funktioniert

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

1. Tägliche Synchronisierung: GitHub Aktionen holen die neuesten Änderungen von ionic-team/capacitor
2. Pull-Request-Erstellung: Änderungen werden als Pull-Requests zur plus Branch
3. CI-Validierung: Vollständige Test-Suite läuft (Linter, Einheitstests, iOS-Build, Android-Build)
4. Sicherheitsüberprüfung: KI-gestützte Analyse überprüft auf Sicherheitslücken und Änderungen, die das System brechen
5. Auto-Merge: Nur wenn CI erfolgreich ist UND die Sicherheitsüberprüfung genehmigt hat
6. Auto-Publish: Neuere Version veröffentlicht unter npm @capacitor-plus/*

Sicherheitsüberprüfungs-Detail

Überprüfen

Was es Fängt	Sicherheit
Befehlsinjektion, XSS, Pfadüberprüfung, festgelegte Geheimnisse	Sicherheitsüberprüfungs-Detail
Wichtige Änderungen	Entfernte/umbenannte APIs, geänderte Signatur, Konfigurationsänderungen
Stabilität	Null-Verweise, unbehaltene Exceptions, Rassenbedingungen, Speicherverluste
Daten-Sicherheit	Datenverlustszenarien, Verletzungen der Privatsphäre, unsichere Speicherung
Code Integrität	Verschlüsselte code , verdächtige Netzwerkaufrufe, Hintertüren

Vorsicht

Wenn bei der Überprüfung Probleme festgestellt werden, wird der PR manuell überprüft und wird NICHT automatisch zusammengeführt. So stellen Sie sicher, dass Sie immer stabile und sichere Releases erhalten.

Übermitteln Sie Ihren PR

Hat Ihr Pull-Request sich im offiziellen Capacitor-Repository festgesetzt? Lassen Sie ihn in Capacitor+: einreichen.

1. Ein Issue öffnen in dem Capacitor+-Repository mit Verweis auf Ihren upstream-Pull-Request

2. Oder einreichen Sie direkt als Pull-Request zu dem plus Zweig

3. Das Team wird ihn überprüfen, CI ausführen und einreichen, wenn er erfolgreich ist.

Auf diese Weise können Sie und andere sofort von Ihrem Werk profitieren, ohne auf das upstream-Release-Zyklus warten zu müssen.

Häufig gestellte Fragen

Ist dies für die Produktion bereit?

Ja. Capacitor+ wird in Produktionsanwendungen verwendet. Jedes Release besteht denselben Test-Suite wie die offizielle Capacitor, plus zusätzliche Sicherheitsanalyse.

Wird mein offizielles Plugin noch funktionieren?

Ja. Alle @capacitor/* Plugins funktionieren mit Capacitor+ ohne weitere Konfiguration.

Was passiert, wenn ein upstream-Release einen Bruchteil enthält?

Die AI-Sicherheitsprüfung markiert Bruchteile für eine manuelle Überprüfung. Sie werden dokumentiert, bevor sie eingefügt werden.

Wie melde ich Fehler?

Melden Sie Probleme auf dem Capacitor + GitHub-Repository. Für Probleme, die auch das offizielle Capacitor betreffen, helfen wir bei der Koordination von Änderungen.

Kann ich beitragen?

Absolut! Pull Requests sind willkommen. Sie können Fixes direkt einreichen oder bitten, dass bestimmte Pull Requests von oben aufgenommen werden.