Zu Hauptinhalt springen
Zurück zu Plugins
@capacitor-plus/core
Anleitung
@capacitor-plus/core

Capacitor+ Core

Capacitor+ ist ein automatisiertes, immer synchronisiertes Fork von Capacitor mit integrierten Community-PRs und schnellen Releases

Leitfaden

Anleitung zu Capacitor+ Core

Verwendung von Capacitor+ (@capacitor-plus) Paketen

Capacitor+ ist ein automatisiertes, immer synchronisiertes Fork von Capacitor unterhalten von Capgo. Es bietet eine einfache Ersatzlösung für die offiziellen Capacitor-Pakete mit einem wichtigen Vorteil: Community-PRs und -Fehler werden schneller integriert.

Warum Capacitor+ existiert

Die Ionic-Team pflegt Capacitor mit ihren eigenen Prioritäten und Veröffentlichungszeiträumen. Dies bedeutet, dass Community-Beiträge - Fehlerbehebungen, Verbesserungen und Funktionen - Monate oder sogar Jahre auf sich warten lassen, um integriert zu werden. Einige werden nie überhaupt integriert.

Capacitor+ löst dieses Problem auf folgende Weise:

  1. Merging von PRs aus Forks - Wichtige PRs, die im Hauptstromstamm stecken, werden aktiv integriert
  2. Kontinuierliche Synchronisation - Jeder Änderung aus dem Hauptstromstamm Capacitor wird automatisch gezogen, getestet und überprüft
  3. Schnelle Veröffentlichungen - Wenn Änderungen CI bestehen, werden sie automatisch unter dem npm-Scope veröffentlicht @capacitor-plus scope
  4. Community-orientiert - Ihre Beiträge haben Priorität und werden berücksichtigt
  5. Sicherheitsüberprüft - Jeder Änderungsvorschlag wird von AI für Sicherheitslücken, Änderungen und Stabilitätsrisiken analysiert

Verfügbare Pakete

Paket Beschreibung
@capacitor-plus/core Kernlaufzeitbibliothek
@capacitor-plus/cli Befehlszeileninterface
@capacitor-plus/android Android-Laufzeitumgebung
@capacitor-plus/ios iOS-Laufzeitumgebung

Installation

Neues Projekt

Für ein neues Projekt verwenden Sie einfach die Capacitor+-Pakete anstelle der offiziellen:

npm install @capacitor-plus/core @capacitor-plus/cli
npm install @capacitor-plus/android  # for Android
npm install @capacitor-plus/ios      # for iOS

Initialisieren Sie dann Ihr Projekt:

npx cap init
npx cap add android
npx cap add ios

Migrieren von offiziellen Capacitor

Um ein bestehendes Projekt von offiziellen Capacitor auf Capacitor+- zu migrieren:

# Remove official packages
npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

# 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

Da Capacitor+ ein Ersatz für API ist, sind keine code Änderungen erforderlich. Ihre Imports bleiben gleich:

// These imports work the same with Capacitor+
import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

Wie es 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: Ein GitHub-Action holt die neuesten Änderungen von ionic-team/capacitor
  2. Erstellung von PR: Änderungen werden als Pull Requests an den plus Zweig
  3. CI-Validierung: Vollständige Test-Suite läuft (Lint, Einheitstests, iOS-Build, Android-Build)
  4. Claude Code-Überprüfung: KI-gestützte umfassende Sicherheitsanalyse überprüft:
    • Sicherheitslücken (Einschübe, XSS usw.)
    • Zerstörung API-Änderungen
    • Risiken für Abstürze und Stabilitätsprobleme
    • Datensicherheit und Datenschutzbedenken
    • Bösartige code-Muster
  5. Auto-Merge: Nur wenn CI erfolgreich ist UND Claude genehmigt (keine Probleme gefunden)
  6. Auto-Publish: Eine neue Version wird unter npm veröffentlicht. @capacitor-plus/*

Security Review

Jeder Upstream-Sync wird auf folgende Sicherheitsrisiken analysiert:

Check Beschreibung
Sicherheit Kommando-Inject, XSS, Pfad-Traversal, festgelegte Geheimnisse usw.
Breaking Changes Entfernte/umbenannte APIs, geänderte Signatur, Änderungen der Konfigurationsformat
Stabilität Null-Verweise, unbehaltene Exceptions, Rassenbedingungen, Speicherverluste
Datensicherheit Datenverlustszenarien, Verletzungen der Privatsphäre, unsichere Speicherung
Code Integrität Verschlüsselte code, verdächtige Netzwerkaufrufe, Hintertüren

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.

Willst du, dass dein Pull-Request akzeptiert wird?

Hast du einen Pull-Request, der im offiziellen Capacitor-Repository steckt? Hier ist, wie du ihn in Capacitor+ einbringen kannst:

  1. Öffne ein Issue im Capacitor+-Repository mit Verweis auf deinen upstream-Pull-Request
  2. Oder stelle den Pull-Request direkt an 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 das Release-Zyklus der Oberfläche warten zu müssen

Vorteile

  • Kontext: Seite/Bereich: Capgo-Lösungen-Marketingseite. Rolle: UI-Label. Anzeige in: Seite solutions/cordova-to-capacitor.astro. Nachrichtenschlüssel `solutions_cordova_to_capacitor_benefits_label` (Lösungen Cordova To Capacitor Vorteile Label)Jetzt PRs, die stecken bleiben
  • : Gemeinschafts-Fixes und -Features, die im Oberflächen-Release warten, werden gemergedAktuell bleiben
  • : Oberflächen-Fixes erhalten, sobald sie CI bestehenSicherheit zuerst
  • : Jeder Änderung wird auf Sicherheitslücken und Stabilitätsrisiken überprüftVerifizierte Releases
  • Ersatz für die Standardversion: Gleiches API wie Capacitor, nur ein anderer Paketbereich
  • Ihre Stimme zählt: Senden Sie Ihre eigenen Pull Requests oder fordern Sie spezifische Pull Requests von oben an, um sie zu melden

Beispiel: Verwendung von Capacitor+ mit Plugins

Alle offiziellen Capacitor-Plugins funktionieren reibungslos mit Capacitor+:

import { Capacitor } from '@capacitor/core';
import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';

// Everything works exactly the same
const platform = Capacitor.getPlatform();

const photo = await Camera.getPhoto({
  resultType: CameraResultType.Uri
});

const position = await Geolocation.getCurrentPosition();

Capgo-Plugins funktionieren auch perfekt mit Capacitor+:

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';

// Use Capgo plugins with Capacitor+
await CapacitorUpdater.notifyAppReady();
await ScreenOrientation.lock({ orientation: 'portrait' });

Das ist alles! Sie haben jetzt eine schneller aktualisierte Version von Capacitor mit Community-Verbesserungen, die schneller integriert werden. Ihre Apps werden von Bug-Fixes und Funktionen profitieren, ohne auf das offizielle Release-Zyklus warten zu müssen.

Weitermachen von Verwendung von Capacitor+ (@capacitor-plus) Packages

Wenn Sie __CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) Packages verwenden Verwendung von Capacitor+ (@capacitor-plus) Packages um native Plugin-Arbeit zu planen, verbinden Sie es mit Capacitor+ zur Implementierungsdetail in Capacitor+ Capgo Plugin-Verzeichnis zur Produktworkflow in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo zur Implementierungsdetail in Capacitor Plugins von Capgo Hinzufügen oder Aktualisieren von Plugins zur Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins, und Ionische Enterprise-Plugin-Alternativen zur Produktworkflow in Ionische Enterprise-Plugin-Alternativen.