Salta al contenuto principale
@capgo/capacitor-data-storage-sqlite File & Storage Open source

Archiviazione dati Plugin Capacitor

Memorizza i dati localmente usando un database SQLite con semplici API key-value e supporto alla crittografia

Installa

bun add @capgo/capacitor-data-storage-sqlite bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-data-storage-sqlite
  • pnpm add @capgo/capacitor-data-storage-sqlite
  • yarn add @capgo/capacitor-data-storage-sqlite

Guida

Come usare Data Storage in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansiona il QR code.

QR code per l'anteprima del plugin Data Storage

Utilizzo di @capgo/capacitor-data-storage-sqlite

Storage SQLite per coppie di stringhe chiave/valore.

Installa

bun add @capgo/capacitor-data-storage-sqlite
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 { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

API in breve

Metodo Descrizione
openStore Apri uno store.
closeStore Chiudi lo Store.
isStoreOpen Verifica se lo Store è aperto.
isStoreExists Verifica se lo Store esiste.
deleteStore Elimina uno store.
setTable Imposta o aggiungi una tabella a uno store esistente.
set Memorizza un dato con la chiave e il valore indicati.
get Recupera il valore di un dato per una chiave specificata.
remove Rimuovi un dato con la chiave indicata.
clear Svuota il Data Store (elimina tutte le chiavi).
iskey Verifica se una chiave esiste.
keys Ottieni l'elenco delle chiavi dei dati.
values Ottieni l'elenco dei valori dei dati.
filtervalues Ottieni l'elenco dei valori per le chiavi di filtro.
keysvalues Ottieni l'elenco delle coppie chiave/valore.
isTable Verifica se una tabella esiste.
tables Ottieni l'elenco delle tabelle dello store attuale.
deleteTable Elimina una tabella.
importFromJson Importa un database da un JSON.
isJsonValid Verifica la validità di un oggetto JSON.
exportToJson Esporta il database indicato in un oggetto JSON.
vacuum Ricostruisci l'attuale store SQLite per recuperare lo spazio disco inutilizzato.

Esempi

openStore()

Apri uno store.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

await CapgoCapacitorDataStorageSqlite.openStore({
  database: 'database',
  table: 'table',
  encrypted: false,
  mode: 'encryption',
  autoVacuum: 'none',
});

closeStore()

Chiudi lo Store.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

await CapgoCapacitorDataStorageSqlite.closeStore({ database: 'database' });

isStoreOpen()

Verifica se lo Store è aperto.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

const result = await CapgoCapacitorDataStorageSqlite.isStoreOpen({ database: 'database' });
console.log(result);

isStoreExists()

Verifica se lo Store esiste.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

const result = await CapgoCapacitorDataStorageSqlite.isStoreExists({ database: 'database' });
console.log(result);

deleteStore()

Elimina uno store.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

await CapgoCapacitorDataStorageSqlite.deleteStore({
  database: 'database',
  table: 'table',
  encrypted: false,
  mode: 'encryption',
  autoVacuum: 'none',
});

setTable()

Imposta o aggiungi una tabella a uno store esistente.

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

await CapgoCapacitorDataStorageSqlite.setTable({ table: 'table' });

La tabella sopra elenca i 22 metodi core. Gli helper per listener e versione e il contratto completo di ogni metodo sono documentati nella repository GitHub.

Riferimento completo

Continua da Utilizzo di @capgo/capacitor-data-storage-sqlite

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

FAQ

FAQ sul plugin Data Storage

Come installo il plugin Data Storage in un'app Capacitor?

Esegui "bun add @capgo/capacitor-data-storage-sqlite" (o "npm install @capgo/capacitor-data-storage-sqlite"), poi lancia "bunx cap sync" così i progetti iOS e Android rilevano il code nativo. Importalo da "@capgo/capacitor-data-storage-sqlite" nella tua app code.

@capgo/capacitor-data-storage-sqlite funziona con React, Vue e Angular?

Sì. Data Storage è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira in Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-data-storage-sqlite?

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-data-storage-sqlite è gratuito e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-data-storage-sqlite/ e il pacchetto si installa gratuitamente da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Data Storage senza passare dalla 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.

Rilascia le modifiche a Data Storage senza aspettare la review 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