Sauter au contenu principal
@capgo/capacitor-sql rapide Dossiers et stockage Source

SQL rapide plugin Capacitor

Base de données SQLite haute performance avec un protocole personnalisé pour des opérations de synchronisation efficaces et remplacement de IndexedDB

Installer

bun add @capgo/capacitor-fast-sql bunx cap sync
npm, pnpm or 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

Tester sur appareil

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

Lien QR de prévisualisation du plugin Fast SQL code

Utilisation de @capgo/capacitor-fast-sql

Plugin SQL rapide pour l'accès à la base de données SQLite haute performance.

Installer

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

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

Importer

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

Vue d'ensemble de API

Méthode Description
connect Initialisez la connexion à la base de données et démarrez le serveur HTTP.
disconnect Closez la connexion à la base de données et arrêtez le serveur HTTP.
getServerInfo Obtenez le port et le jeton du serveur HTTP pour une communication directe.
execute Exécutez une requête SQL via Capacitor pont (pour des requêtes simples). Pour une meilleure performance avec de grands ensembles de données, utilisez le protocole HTTP directement via la classe SQLConnection.
beginTransaction Démarrez une transaction de base de données.
commitTransaction Validez la transaction en cours.
rollbackTransaction Annulez la transaction en cours.
configureWeb Configurez les options spécifiques au Web pour le module SQLite Wasm officiel.

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

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

Obtenez le port du serveur HTTP et le jeton 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 pont Capacitor (pour des requêtes simples). Pour une meilleure performance avec de grands ensembles de données, utilisez le protocole HTTP directement 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émarrer 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()

Valider la transaction en cours.

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

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

La table ci-dessus liste les 8 méthodes de base. Les aides aux écouteurs et aux versions, ainsi que la pleine convention de chaque méthode, sont documentés dans le référentiel GitHub.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-fast-sql

Continuez à partir de l'utilisation de @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-fast-sql :  Utilisez @capgo/capacitor-fast-sql pour planifier le stockage et la gestion des fichiers, connectez-l’avec à @capgo/capacitor-fast-sql pour les détails d'implémentation dans @capgo/capacitor-fast-sql, Getting Started pour les détails d'implémentation dans Démarrage, à @capgo/capacitor-data-storage-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite, Utilisez @capgo/capacitor-data-storage-sqlite pour la capacité native dans Utilisez @capgo/capacitor-data-storage-sqlite, et à @capgo/capacitor-file pour les détails d'implémentation dans @capgo/capacitor-file.

FAQ

FAQ du plugin SQL rapide

Comment installer le plugin SQL rapide dans une application Capacitor?

Exécutez la commande « bun add @capgo/capacitor-fast-sql » (ou « npm install @capgo/capacitor-fast-sql »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte les natives code. Importez-l’à partir de « @capgo/capacitor-fast-sql » dans votre application code.

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

Oui. Fast SQL est un paquet Capacitor, donc il fonctionne avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est prise en charge 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, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Est-ce que @capgo/capacitor-fast-sql est 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 paquet est gratuit pour l'installer depuis npm. Les rapports de bugs et les demandes de pull sont les bienvenus.

Puis-je mettre à jour code qui utilise Fast SQL sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin change les natives code, il faut donc une nouvelle build de l'application. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo.

Expédiez les modifications de SQL Fast sans attendre la revue de l'application

Une fois le plugin dans votre magasin de build, Capgo les mises à jour en temps réel déclenchent vos modifications JavaScript, HTML et CSS chez les utilisateurs en quelques minutes.

Commencez par Capgo