Zum Hauptinhalt springen
@capgo/capacitor-fast-sql Dateien & Speicher Open Source

Schnelles SQL Capacitor Plugin

Hochperformantes natives SQLite mit eigenem Protokoll für effiziente Sync-Operationen und IndexedDB-Ersatz.

Installieren

bun add @capgo/capacitor-fast-sql bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-fast-sql
  • pnpm add @capgo/capacitor-fast-sql
  • yarn add @capgo/capacitor-fast-sql

Anleitung

So nutzt du Fast SQL in Capacitor

@capgo/capacitor-fast-sql verwenden

Fast SQL Plugin für performanten SQLite-Datenbankzugriff.

Installieren

bun add @capgo/capacitor-fast-sql
bunx cap sync

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

API auf einen Blick

Methode Beschreibung
connect Initialisiere die Datenbankverbindung und starte den HTTP-Server.
disconnect Schließe die Datenbankverbindung und stoppe den HTTP-Server.
getServerInfo Ruft den HTTP-Server-Port und das Token für die direkte Kommunikation ab.
execute Führe eine SQL-Abfrage über die Capacitor Bridge aus (für einfache Queries). Für bessere Performance bei großen Datensätzen nutze das HTTP-Protokoll direkt über die SQLConnection-Klasse.
beginTransaction Starte eine Datenbanktransaktion.
commitTransaction Aktuelle Transaktion committen.
rollbackTransaction Aktuelle Transaktion zurückrollen.
configureWeb Konfiguriere web-spezifische Optionen für das offizielle SQLite-Wasm-Modul.

Beispiele

connect()

Initialisiere die Datenbankverbindung und starte den HTTP-Server.

import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

const conn = await CapgoCapacitorFastSql.connect({ database: 'myapp' });
console.log('Connected on port:', conn.port);

disconnect()

Schließe die Datenbankverbindung und stoppe den HTTP-Server.

import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

await CapgoCapacitorFastSql.disconnect({ database: 'myapp' });

getServerInfo()

Ruft den HTTP-Server-Port und das Token für die direkte Kommunikation ab.

import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

const info = await CapgoCapacitorFastSql.getServerInfo({ database: 'myapp' });
console.log('Server port:', info.port);

execute()

Führe eine SQL-Abfrage über die Capacitor Bridge aus (für einfache Queries). Für bessere Performance bei großen Datensätzen nutze das HTTP-Protokoll direkt über die SQLConnection-Klasse.

import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

const result = await CapgoCapacitorFastSql.execute({
  database: 'myapp',
  statement: 'SELECT * FROM users WHERE age > ?',
  params: [18]
});
console.log('Rows:', result.rows);

beginTransaction()

Starte eine Datenbanktransaktion.

import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

await CapgoCapacitorFastSql.beginTransaction({ database: 'myapp' });
// Execute multiple operations
await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });

commitTransaction()

Aktuelle Transaktion committen.

import { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

await CapgoCapacitorFastSql.commitTransaction({ database: 'myapp' });

Die obige Tabelle listet die 8 Kernmethoden auf. Listener- und Version-Helper sowie der vollständige Contract jeder Methode sind in der GitHub Repository.

Vollständige Referenz

Weiter mit @capgo/capacitor-fast-sql verwenden

Wenn du es nutzt @capgo/capacitor-fast-sql verwenden um Speicher- und Dateiverwaltung zu planen, verbinde es mit @capgo/capacitor-fast-sql für Details zur Implementierung in @capgo/capacitor-fast-sql, Erste Schritte für die Implementierungsdetails in Erste Schritte, @capgo/capacitor-data-storage-sqlite für die Implementierungsdetails in @capgo/capacitor-data-storage-sqlite, Mit @capgo/capacitor-data-storage-sqlite für die native Funktion bei der Nutzung von @capgo/capacitor-data-storage-sqlite und @capgo/capacitor-file für die Implementierungsdetails in @capgo/capacitor-file.

FAQ

Fast SQL Plugin FAQ

Wie installiere ich das Fast SQL Plugin in einer Capacitor App?

Führe "bun add @capgo/capacitor-fast-sql" (oder "npm install @capgo/capacitor-fast-sql") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-fast-sql".

Funktioniert @capgo/capacitor-fast-sql mit React, Vue und Angular?

Ja. Fast SQL ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor Version unterstützt @capgo/capacitor-fast-sql?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-fast-sql kostenlos und Open Source?

Ja. Der code Code ist auf GitHub unter https://github.com/Cap-go/capacitor-fast-sql/ öffentlich einsehbar und das Package lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Fast SQL ohne App Store Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

SQL-Änderungen schnell deployen, ohne auf das App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo