Getting Started

Neuer Projekt-Installation

1. Installieren von Kern-Paketen

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

2. Hinzufügen von Plattform-Paketen

   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. 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. Ihre Projekt synchronisieren

   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-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-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 holen die neuesten Änderungen von ionic-team/capacitor
2. Pull-Request-Erstellung: Änderungen werden als Pull-Requests zur plus Zweig
3. CI-Validierung: Vollständige Test-Suite läuft (Lint, Einheitstests, iOS-Build, Android-Build)
4. Sicherheitsüberprüfung: KI-gestützte Analyse überprüft auf Sicherheitslücken und veränderte Funktionalitäten
5. Automatische Merging: Nur wenn CI erfolgreich ist UND Sicherheitsüberprüfung genehmigt hat
6. Automatisches Veröffentlichen: Neuere Version wird unter npm veröffentlicht @capacitor-plus/*

Sicherheitsüberprüfung Details

Jeder Upstream-Sync wird auf folgende Aspekte analysiert:

Überprüfung	Was es fängt
Sicherheit	Befehlsinjektion, XSS, Pfadüberprüfung, festgelegte Geheimnisse
Änderungen mit Sicherheitsrisiken	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

If any issues are detected, the PR is flagged for manual review and will NOT be auto-merged. This ensures you always get stable, secure releases.

Dein Pull-Request einreichen

Hast du einen Pull-Request im offiziellen Capacitor-Repository stecken? Lass ihn in Capacitor+:

1. Eine Issue öffnen im Capacitor+-Repository mit Verweis auf deinen upstream-Pull-Request

2. Oder submit direkt als Pull-Request zu der plus Branch

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

So können Sie und andere direkt von Ihrem Werk profitieren, ohne auf das Release-Zyklus der Oberfläche warten zu müssen.

FAQ

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 meine offizielle Plugin noch funktionieren?

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

Was passiert, wenn die Oberfläche ein breakender Change veröffentlicht?

Die AI-Sicherheitsprüfung kennzeichnet Änderungen, die eine manuelle Überprüfung erfordern. Sie sehen die Änderungen dokumentiert, bevor sie integriert werden.

Wie melde ich Probleme?

Dateien im Capacitor + GitHubRepo melden. Für Probleme, die auch 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 upstream-PRs integriert werden.

Weiter geht es von Getting Started

Wenn Sie Einstieg um native Plugin-Arbeit zu planen, verbinden Sie es mit Mit Capacitor+ (@capacitor-plus) Paketen für die native Fähigkeit in Mit Capacitor+ (@capacitor-plus) Paketen, Capgo Plugin-Verzeichnis für den Produktworkflow in Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetails in Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen.