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.