Getting Started

Neues Projektinstallation

Sie können unsere AI-gestützte Einrichtung verwenden, um Capacitor+ zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer AI-Anwendung mit der folgenden Befehlszeile 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 aufgeführten Plattform-spezifischen Anweisungen:

1. Installieren Sie die Kernpakete

   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 der 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. Install Capacitor+ packages

   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+ verfügt über die gleichen API wie die offiziellen Capacitor. Ihre Importe und code bleiben genau gleich.

Verwendung

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 amtlichen 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. Daily Sync: GitHub-Aktionen holen die neuesten Änderungen von ionic-team/capacitor
2. PR-Erstellung: Änderungen werden als Pull-Anforderungen an das plus Zweig
3. CI-Validierung: KI-gestützte Analyse überprüft auf Sicherheitslücken und Bruchstellen
4. Sicherheitsüberprüfung: KI-gestützte Analyse überprüft Sicherheitslücken und Änderungen, die den Code brechen können
5. Auto-MergeNur wenn CI erfolgreich ist UND die Sicherheitsprüfung genehmigt
6. CI-ValidierungEine neue Version wurde unter npm veröffentlicht. @capacitor-plus/*

Sicherheitsüberprüfungs Details

Every upstream sync is analyzed for:

Überprüfen	Was es Fängt
Sicherheit	Command Injection, XSS, Pfadverwaltung, festgehaltene Geheimnisse
Command-Injektion, XSS, Pfadüberprüfung, festgelegte Geheimnisse	Änderungen an APIs, geänderte Signatur, Konfigurationsänderungen
Stability	Nulleinträge, unbehandelte Exceptions, Rassenbedingungen, Speicherverluste
Daten-Sicherheit	Null-Verweise, unbehaltene Exceptions, Rassenbedingungen, Speicherverluste
Code Integrität	Verschlüsselter 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 zusammengeführt. Dies sichert Ihnen immer stabile und sichere Releases.

Pull-Request einreichen

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

1. Ein Problem melden in dem Capacitor+-Repository mit Verweis auf Ihren upstream-Pull-Request

2. Oder senden Sie direkt als ein PR an das plus Zweig

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

Somit können Sie und andere sofort von Ihrem Werk profitieren, ohne auf den upstream-Release-Zyklus zu warten.

FAQ

Ist dies für die Produktion bereit?

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

Wird mein offizielles Plugin weiterhin funktionieren?

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

What if upstream releases a breaking change?

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

Wie melde ich Fehler?

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

Kann ich beitragen?

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

Fortsetzung von Getting Started

Wenn Sie Capgo verwenden Getting Started zur Planung von native Plugin-Arbeiten, 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-Verzeichnis Capgo Plugin-Verzeichnis für den Produktworkflow in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo 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-Unternehmens-Plugin-Alternativen für das Produktworkflow in Ionic Enterprise Plugin Alternativen.