Getting Started

Neuer Projektinstallation

You can use our AI-Assisted Setup to install Capacitor+. Add the Capgo skills to your AI tool using the following command:

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

Zur Zwischenablage kopieren

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 Sie eine manuelle Einrichtung bevorzugen, installieren Sie die Pakete, indem Sie die folgenden Befehle ausführen und folgen Sie den unten angegebenen Plattform-spezifischen Anweisungen:

1. Kernpaket installieren

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

2. Plattformpaket 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

Von der offiziellen Capacitor-Version migrieren

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

1. Entfernen Sie offizielle Pakete

   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

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

Verwendung

Da Capacitor+ API-kompatibel ist, funktioniert Ihr bestehendes 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 laden die neuesten Änderungen von ionic-team/capacitor
2. Pull-Request-Erstellung: Änderungen werden als Pull-Requests an den plus Zweig
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 nach Sicherheitslücken und Bruchstellen
5. Automatische Meldung: Nur wenn CI erfolgreich ist UND Sicherheitsüberprüfung genehmigt
6. Auto-Publish: Neue Version veröffentlicht unter npm @capacitor-plus/*

Sicherheitsprüfungsdetails

Jeder Upstream-Sync wird auf folgende Sicherheitsrisiken analysiert:

Überprüfen	Was es findet
Sicherheit	Befehlsinjektion, XSS, Pfadüberprüfung, festgelegte Geheimnisse
Änderungen, die die Funktionalität beeinträchtigen	Entfernte/umbenannte APIs, geänderte Signatur, Konfigurationsänderungen
Stabilität	Nullpointerfehler, 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 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. Erstellen Sie ein Issue in der Capacitor+ Repository auf Ihre upstream PR verweisen

2. Oder direkt als PR einreichen als PR in die 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 sofort von Ihrem Werk profitieren, ohne auf das upstream Release-Zyklus zu warten.

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 meine offizielle 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 flaggt breakende Änderungen zur manuellen Überprüfung. Du siehst die Änderungen dokumentiert, bevor sie integriert werden.

Wie melde ich Probleme?

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

Kann ich beitragen?

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

Weiter geht’s von Getting Started

Wenn Sie native Plugin-Arbeit planen, verbinden Sie es mit Getting Started um native Fähigkeiten in Using __CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) Packages zu nutzen für die native Fähigkeit in Using Capacitor+ (@capacitor-plus) Packages for the native capability in Using Capacitor+ (@capacitor-plus) Packages, Using Capgo+ (@__CAPGO_KEEP_1__-plus) Packages für den Produktworkflow in Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren, und Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen.