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

Fast SQL Capacitor Plugin

Hochperformantes natives SQLite mit eigenem Protokoll für effiziente Sync-Vorgänge und als 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

Fast SQL in Capacitor nutzen

Verwendung von @capgo/capacitor-fast-sql

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 Initialisiert die Datenbankverbindung und startet den HTTP-Server.
disconnect Schließt die Datenbankverbindung und stoppt den HTTP-Server.
getServerInfo Ruft den HTTP-Server-Port und das Token für die direkte Kommunikation ab.
execute Führt 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 via SQLConnection-Klasse.
beginTransaction Startet eine Datenbank-Transaktion.
commitTransaction Commitet die aktuelle Transaktion.
rollbackTransaction Rollback der aktuellen Transaktion.
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()

Rufe 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). Nutze für bessere Performance bei großen Datensätzen direkt das HTTP-Protokoll via 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 Datenbank-Transaktion.

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

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

commitTransaction()

Committe die aktuelle Transaktion.

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

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

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

Vollständige Referenz

Weiterlesen unter Verwendung von @capgo/capacitor-fast-sql

Wenn du es nutzt Verwendung von @capgo/capacitor-fast-sql um Speicher und Dateihandling 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 Details zur Implementierung in @capgo/capacitor-data-storage-sqlite, Mit @capgo/capacitor-data-storage-sqlite für die native Funktion mit @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 den 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