Anfangen

Neue Projektinstallation

1. Installieren von Kernpaket

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

2. Plattformspakete hinzufügen

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

3. Initialisieren 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. Synchronisiere dein Projekt

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Hinweis

No code changes required! Capacitor+ has the same API as official Capacitor. Your imports and code remain exactly the same.

Verwendung

Da Capacitor+ API-kompatibel ist, funktioniert Ihre 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-Erweiterungen

Alle offiziellen Capacitor-Erweiterungen 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-Erweiterungen

Capgo-Erweiterungen 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 laden die neuesten Änderungen von ionic-team/capacitor
2. Pull-Request-Erstellung: Änderungen werden als Pull-Requests zum plus Zweig
3. CI-Validierung: Die vollständige Test-Suite läuft (Linter, Einheitstests, iOS-Build, Android-Build)
4. Sicherheits-Überprüfung: Eine künstliche-Intelligenz-basierte Analyse überprüft nach Schwachstellen und bruchstellenfähigen Änderungen
5. Automatische-Merge: Nur wenn CI erfolgreich ist UND die Sicherheits-Überprüfung genehmigt
6. Automatische-Veröffentlichung: Die neue Version wird unter npm veröffentlicht @capacitor-plus/*

Sicherheitsprüfungsdetails

Jeder Upstream-Sync wird auf folgende Sicherheitsrisiken analysiert:

Überprüfen	Was es Fängt
Sicherheit	Befehlsinjektion, XSS, Pfadüberprüfung, festgelegte Geheimnisse
Änderungen mit Auswirkungen auf die Kompatibilität	Entfernte/umbenannte APIs, geänderte Signatur, Konfigurationsänderungen
Stabilität	Null-Verweise, unbehaltene Exceptions, Rassenbedingungen, Speicherlecks
Daten-Sicherheit	Szenarien für Datenverlust, 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 Pull-Request für eine manuelle Überprüfung markiert und wird NICHT automatisch in die Releases aufgenommen. So stellen Sie sicher, dass Sie immer stabile und sichere Releases erhalten.

Pull-Request einreichen

Haben Sie einen Pull-Request im offiziellen Capacitor-Repository stecken? Lassen Sie ihn in Capacitor+:

1. Ein Problem melden in dem Capacitor+-Repository linking zu Ihrem upstream PR

2. Oder submit direkt als ein PR zu dem plus Zweig

3. Das Team wird die Überprüfung, CI-Ausführung und das Merge, wenn es erfolgreich ist, durchführen

So können Sie und andere von Ihrem Werk sofort ohne Wartezeit auf den upstream Release-Zyklus profitieren

FAQ

Ist dies production-ready?

Ja. Capacitor+ wird in Produktionsanwendungen verwendet. Jedes Release besteht aus dem gleichen Test-Suite wie die offizielle Capacitor, plus zusätzlicher Sicherheitsanalyse

Wird mein offizielles Plugin noch funktionieren?

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

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

Die AI-Sicherheitsprüfung meldet breakende Änderungen zur manuellen Überprüfung. Sie sehen die Änderungen dokumentiert, bevor sie eingefügt werden.

Wie melde ich Probleme?

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

Kann ich beitragen?

Absolut! PRs sind willkommen. Sie können direkt Korrekturen einreichen oder bitten, dass bestimmte upstream-PRs eingearbeitet werden.

Weiter geht es von Getting Started

Wenn Sie Getting Started mit der Planung von native Plugin-Arbeit verwenden, verbinden Sie es mit Using Capacitor+ (@capacitor-plus) Packages for the native capability in Using Capacitor+ (@capacitor-plus) Packages, Capgo-Plugin-Verzeichnis für den Produktworkflow in Capgo-Plugin-Verzeichnis Capgo Plugins von Capacitor für die Implementierungsdetails in Capacitor Plugins durch Capgo, Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetails in Hinzufügen oder Aktualisieren von Plugins und Alternativen zu Ionic Enterprise Plugins für den Produktworkflow in Alternativen zu Ionic Enterprise Plugins.