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.