Aller au contenu principal
@capgo/capacitor-data-storage-sqlite Fichiers et stockage Open source

Stockage des données Plugin Capacitor

Stockez vos données localement via SQLite, avec un API clé-valeur simple et le chiffrement.

Installer

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

Guide

Comment utiliser Data Storage dans Capacitor

Tester sur l'appareil

Téléchargez l'application Capgo, puis scannez le QR code.

Lien QR pour l'aperçu du plugin Data Storage code

Utiliser @capgo/capacitor-data-storage-sqlite

Stockage SQLite de paires clé/valeur sous forme de chaînes.

Installer

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

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

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

Aperçu de API

Méthode Description
openStore Ouvrir un store.
closeStore Fermer le store.
isStoreOpen Vérifier si le store est ouvert.
isStoreExists Vérifier si le store existe.
deleteStore Supprimer un store.
setTable Définir ou ajouter une table à un store existant.
set Stocker une donnée avec la clé et la valeur fournies.
get Récupérer la valeur d'une donnée pour une clé donnée.
remove Supprimer une donnée à partir de sa clé.
clear Vider le store de données (supprimer toutes les clés).
iskey Vérifier si une clé de donnée existe.
keys Récupérer la liste des clés de données.
values Récupérer la liste des valeurs de données.
filtervalues Get the data value list for filter keys.
keysvalues Get the data key/value pair list.
isTable Vérifier si une table existe.
tables Récupérer la liste des tables du store actuel.
deleteTable Supprimer une table.
importFromJson Importer une base de données depuis un JSON.
isJsonValid Vérifier la validité d'un objet JSON.
exportToJson Exporter la base de données spécifiée vers un objet JSON.
vacuum Reconstruire le store SQLite actuel pour récupérer l'espace disque inutilisé.

Exemples

openStore()

Ouvrir un store.

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

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

closeStore()

Fermer le store.

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

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

isStoreOpen()

Vérifier si le store est ouvert.

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

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

isStoreExists()

Vérifier si le store existe.

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

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

deleteStore()

Supprimer un store.

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

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

setTable()

Définir ou ajouter une table à un store existant.

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

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

Le tableau ci-dessus répertorie les 22 méthodes principales. Les listeners, les helpers de version et le contrat complet de chaque méthode sont documentés dans dépôt GitHub.

Référence complète

Continuer à partir de « Using @capgo/capacitor-data-storage-sqlite »

Si vous utilisez Utiliser @capgo/capacitor-data-storage-sqlite pour planifier le stockage et la gestion des fichiers, connectez-l’à @capgo/capacitor-data-storage-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite, Prise en main pour les détails d'implémentation dans Getting Started @capgo/capacitor-file pour les détails d'implémentation dans @capgo/capacitor-file, Utiliser @capgo/capacitor-file pour la capacité native dans Utiliser @capgo/capacitor-file, et @capgo/capacitor-uploader pour les détails d'implémentation dans @capgo/capacitor-uploader.

FAQ

FAQ du plugin Data Storage

Comment installer le plugin Data Storage dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-data-storage-sqlite" (ou "npm install @capgo/capacitor-data-storage-sqlite"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-data-storage-sqlite" dans votre code.

Est-ce que @capgo/capacitor-data-storage-sqlite fonctionne avec React, Vue et Angular ?

Oui. Data Storage est un package Capacitor, il fonctionne donc avec n'importe quel framework web exécuté dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et du JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-data-storage-sqlite ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-data-storage-sqlite est gratuit et open source ?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-data-storage-sqlite/ et le package est gratuit à installer depuis npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Data Storage sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les modifications de Data Storage sans attendre la revue de l’application

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo