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

Archiviazione dati plugin Capacitor

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

Installazione

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

Test sul dispositivo

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

Anteprima plugin Data Storage QR code

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

Storage SQLite per coppie chiave/valore di stringhe.

Installazione

bun add @capgo/capacitor-data-storage-sqlite
bunx cap sync

bunx cap sync copia il code nativo 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 Controlla se lo store è aperto.
isStoreExists Controlla se lo store esiste.
deleteStore Elimina uno store.
setTable Imposta o aggiungi una tabella a uno store esistente.
set Memorizza un dato con una chiave e un valore specifici.
get Recupera il valore di un dato tramite la sua chiave.
remove Rimuovi un dato tramite la sua chiave.
clear Svuota il Data Store (elimina tutte le chiavi).
iskey Verifica se una chiave esiste.
keys Ottieni l'elenco delle chiavi.
values Ottieni l'elenco dei valori.
filtervalues Ottieni i valori per le chiavi filtrate.
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 in un oggetto JSON.
vacuum Ricostruisci lo store SQLite per recuperare spazio su disco.

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

Controlla se lo store è aperto.

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

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

isStoreExists()

Controlla 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 versioni, 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 storage e gestione dei file, collegalo con @capgo/capacitor-data-storage-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Guida rapida per i dettagli di implementazione in Getting Started, @capgo/capacitor-file per i dettagli di implementazione in @capgo/capacitor-file, Uso di @capgo/capacitor-file per la funzionalità nativa con @capgo/capacitor-file, e @capgo/capacitor-uploader per i dettagli di implementazione 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" per aggiornare i progetti iOS e Android con il code nativo. Importalo da "@capgo/capacitor-data-storage-sqlite" nel code della tua app.

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

Sì. Data Storage è un pacchetto Capacitor, quindi funziona con qualsiasi web framework 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 è free 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 è gratuito su npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Data Storage 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 i live update di Capgo.

Distribuisci modifiche al Data Storage senza attendere la revisione dell'app

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

Inizia con Capgo