Salta al contenuto principale
@capgo/capacitor-fast-sql File & Storage Open source

SQL veloce Plugin Capacitor

SQLite nativo ad alte prestazioni con protocollo custom per sync efficienti e sostituzione di IndexedDB

Installa

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

Guida

Come usare Fast SQL in Capacitor

Utilizzo di @capgo/capacitor-fast-sql

Plugin Fast SQL per l'accesso ad alta velocità a database SQLite.

Installa

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

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

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

API in breve

Metodo Descrizione
connect Inizializza la connessione al database e avvia il server HTTP.
disconnect Chiudi la connessione al database e arresta il server HTTP.
getServerInfo Ottieni la porta del server HTTP e il token per la comunicazione diretta.
execute Esegui una query SQL tramite il bridge Capacitor (per query semplici). Per performance migliori con dataset ampi, usa direttamente il protocollo HTTP tramite la classe SQLConnection.
beginTransaction Avvia una transazione sul database.
commitTransaction Esegui il commit della transazione corrente.
rollbackTransaction Esegui il rollback della transazione corrente.
configureWeb Configura le opzioni web per il modulo ufficiale SQLite Wasm.

Esempi

connect()

Inizializza la connessione al database e avvia il server HTTP.

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

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

disconnect()

Chiudi la connessione al database e arresta il server HTTP.

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

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

getServerInfo()

Ottieni la porta del server HTTP e il token per la comunicazione diretta.

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

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

execute()

Esegui una query SQL tramite il bridge Capacitor (per query semplici). Per performance migliori con dataset ampi, usa direttamente il protocollo HTTP tramite la classe SQLConnection.

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()

Avvia una transazione sul database.

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

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

commitTransaction()

Esegui il commit della transazione corrente.

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

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

La tabella sopra elenca gli 8 metodi core. Listener, helper di versione e il contratto completo di ogni metodo sono documentati in repository GitHub.

Riferimento completo

Continua da Usare @capgo/capacitor-fast-sql

Se stai usando Usare @capgo/capacitor-fast-sql per pianificare lo storage e la gestione dei file, collegalo a @capgo/capacitor-fast-sql per i dettagli di implementazione in @capgo/capacitor-fast-sql, Per iniziare per i dettagli di implementazione nella guida introduttiva, @capgo/capacitor-data-storage-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Utilizzo di @capgo/capacitor-data-storage-sqlite per la funzionalità nativa in Utilizzo di @capgo/capacitor-data-storage-sqlite, e @capgo/capacitor-file per i dettagli di implementazione in @capgo/capacitor-file.

FAQ

FAQ sul plugin Fast SQL

Come installo il plugin Fast SQL in un'app Capacitor?

Esegui "bun add @capgo/capacitor-fast-sql" (o "npm install @capgo/capacitor-fast-sql"), poi lancia "bunx cap sync" in modo che i progetti iOS e Android integrino il code nativo. Importalo da "@capgo/capacitor-fast-sql" nel tuo code.

@capgo/capacitor-fast-sql funziona con React, Vue e Angular?

Sì. Fast SQL è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che giri dentro Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-fast-sql?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-fast-sql è free e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-fast-sql/ e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che usa Fast SQL senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Distribuisci modifiche SQL velocemente senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo