Getting Started

Neue Projektinstallation

Sie können unser AI-gestütztes Setup verwenden, um Capacitor+ zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrem AI-Tool mit der folgenden Befehl hinzu:

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

Verwenden Sie dann die folgende Anweisung:

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. 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 Official 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 Änderungen an code erforderlich! Capacitor+ hat das gleiche API wie das offizielle Capacitor. Ihre Imports und code bleiben genau gleich.

Benutzung

Da Capacitor+ mit 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();

How die Synchronisierung funktioniert

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

1. Tagliche Synchronisierung: GitHub Aktionen holen die neuesten Änderungen von ionic-team/capacitor
2. Pull-Request-Erstellung: Änderungen werden als Pull-Requests an das 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 Merge: Nur wenn CI erfolgreich ist UND Sicherheitsüberprüfung genehmigt hat
6. Automatische Veröffentlichung: Neuere Version veröffentlicht unter npm @capacitor-plus/*

Sicherheitsüberprüfungsdetails

Jeder Upstream-Sync wird auf folgende analysiert:

Überprüfung	Was es Fängt
Sicherheit	: Befindet sich auf der Unternehmensprodukt/Preisliste-Seite. Rolle: UI-Label. Gesehen in: Seite enterprise.astro. Nachrichtenschlüssel `enterprise_hero_security_label` (Unternehmens-Helden-Sicherheitsbezeichnung).
Command Injection, XSS, Pfadüberprüfung, festgelegte Geheimnisse	Entfernte/umbenannte APIs, geänderte Signatur, Konfigurationsänderungen
Stabilität	Null-Verweise, unbehandelte Exceptions, Rassenbedingungen, Speicherlecks
Daten-Sicherheit	Datenverlustszenarien, Verletzungen der Privatsphäre, unsichere Speicherung
Code Integrität	Verschlüsselte code, verdächtige Netzwerkaufrufe, Hintertüren

Achtung

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

Pull-Request-Übermittlung

Haben Sie ein PR im offiziellen Capacitor-Repo stecken? Lassen Sie es in Capacitor+ einfügen:

1. Ein Issue öffnen im Capacitor+-Repo mit Verweis auf Ihr upstream-PR

2. Oder submit direkt als ein PR zum plus Branch

3. Das Team wird es überprüfen, CI ausführen und einfügen, wenn es besteht

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

FAQ

Is this production-ready?

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

Werden meine offiziellen Plugins noch funktionieren?

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

Wenn ein upstream-Release einen Bruchteil bringt?

Die AI-Sicherheitsprüfung meldet Bruchteile für eine manuelle Überprüfung. Sie sehen die Änderungen dokumentiert, bevor sie eingefügt werden.

Wie melde ich Fehler?

Dateien im Capacitor + GitHub-Repositoryerstellen. Für Probleme, die auch das offizielle Capacitor betreffen, helfen wir bei der Koordination der upstream-Änderungen.

Kann ich beitragen?

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

Fortsetzen Sie mit dem ‘Getting Started’

Wenn Sie Getting Started zur Planung von native Plugin-Arbeiten verwenden, verbinden Sie es mit Verwendung von Capacitor+ (@capacitor-plus)-Paketen für die native Fähigkeit in Verwendung von Capacitor+ (@capacitor-plus) Paketen Capgo Plugin-Ordner für den Produktworkflow in Capgo Plugin-Ordner 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