Aller au contenu principal
@capgo/capacitor-fast-sql Fichiers et stockage Open source

SQL rapide Plugin Capacitor

SQLite natif haute performance avec protocole personnalisé pour des opérations de sync efficaces et un remplacement d'IndexedDB

Installer

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

Guide

Comment utiliser Fast SQL dans Capacitor

Utiliser @capgo/capacitor-fast-sql

Le plugin Fast SQL pour un accès haute performance à la base SQLite.

Installer

bun add @capgo/capacitor-fast-sql
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 { CapgoCapacitorFastSql } from '@capgo/capacitor-fast-sql';

Aperçu de API

Méthode Description
connect Initialise la connexion à la base de données et démarre le serveur HTTP.
disconnect Ferme la connexion à la base de données et arrête le serveur HTTP.
getServerInfo Récupère le port du serveur HTTP et le token pour une communication directe.
execute Exécute une requête SQL via le bridge Capacitor (pour les requêtes simples). Pour de meilleures performances avec des jeux de données volumineux, utilisez directement le protocole HTTP via la classe SQLConnection.
beginTransaction Démarre une transaction de base de données.
commitTransaction Valide la transaction en cours.
rollbackTransaction Annulez la transaction en cours.
configureWeb Configurez les options spécifiques au web pour le module officiel SQLite Wasm.

Exemples

connect()

Initialisez la connexion à la base de données et démarrez le serveur HTTP.

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

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

disconnect()

Fermez la connexion à la base de données et arrêtez le serveur HTTP.

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

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

getServerInfo()

Récupérez le port du serveur HTTP et le token pour une communication directe.

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

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

execute()

Exécutez une requête SQL via le bridge Capacitor (pour les requêtes simples). Pour de meilleures performances avec de gros jeux de données, utilisez directement le protocole HTTP via 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()

Démarrez une transaction de base de données.

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

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

commitTransaction()

Validez la transaction en cours.

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

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

Le tableau ci-dessus liste les 8 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans le dépôt GitHub.

Référence complète

Continuer après l'utilisation de @capgo/capacitor-fast-sql

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

FAQ

FAQ du plugin Fast SQL

Comment installer le plugin Fast SQL dans une application Capacitor ?

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

@capgo/capacitor-fast-sql fonctionne-t-il avec React, Vue et Angular ?

Oui. Fast SQL est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant sous Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-fast-sql ?

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.

@capgo/capacitor-fast-sql est-il gratuit et open source ?

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

Puis-je mettre à jour code utilisant Fast SQL 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 vos changements Fast SQL sans attendre la validation de l'app

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