Getting Started

Neuer Projektinstallation

Sie können unsere KI-gestützte Einrichtung verwenden, um Capacitor+ zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer KI-Tool mithilfe der folgenden Befehl hinzu:

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

Verwenden Sie dann die folgende Anfrage:

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

1. Install 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 von 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

Migrating from Official Capacitor

If you have an existing Capacitor project, migrating to Capacitor+ is simple:

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. Synchronisiere dein 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 offizielles Capacitor. Ihre Importe und code bleiben genau gleich.

Benutzung

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-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-Review: KI-gestützte Analyse überprüft nach Sicherheitslücken und Bruchstellen
5. Automatische Meldung: Nur wenn CI erfolgreich ist UND Sicherheits-Review genehmigt
6. Automatisches Veröffentlichen: Neue Version veröffentlicht unter npm @capacitor-plus/*

Security Review Details

Jeder Upstream-Sync wird auf folgende Sicherheitsrisiken analysiert:

Überprüfen	Was es findet
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, Speicherverluste
Daten-Sicherheit	Datenverlustszenarien, Datenschutzverletzungen, ungesicherte Speicherung
Code Integrität	Verschlüsselte code-, verdächtige Netzwerkaufrufe, Backdoors

Vorsicht

Wenn bei der Überprüfung Probleme festgestellt werden, wird der Pull-Request für eine manuelle Überprüfung markiert und wird NICHT automatisch zusammengeführt. Dies sichert Ihnen immer stabile und sichere Releases.

Pull-Request einreichen

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

1. Ein Issue öffnen in dem Capacitor+ Repository Link auf Ihr upstream-PR

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

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

So 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 geeignet?

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 weiterhin 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 eingereicht 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! Pull Requests sind willkommen. Sie können Fixes direkt einreichen oder bitten, dass bestimmte upstream Pull Requests eingebunden werden.

Weiter geht es von Getting Started

Wenn Sie " Getting Started " zum Planen von native Plugin-Arbeiten verwenden, verbinden Sie es mit Using Capacitor+ (@capacitor-plus) Packages Using Capacitor+ (@capacitor-plus) Packages Capgo Plugin Directory Using Capgo+ (@__CAPGO_KEEP_1__-plus) Packages", " Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren, und Alternativen zu Ionic Enterprise Plugins für den Produktworkflow in Alternativen zu Ionic Enterprise Plugins.