Lompat ke konten utama
@capgo/capacitor-fast-sql File & Penyimpanan Open source

SQL Cepat plugin Capacitor

SQLite native berperforma tinggi dengan protokol kustom untuk sinkronisasi efisien dan pengganti IndexedDB

Instal

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

Panduan

Cara menggunakan Fast SQL di Capacitor

Menggunakan @capgo/capacitor-fast-sql

Plugin Fast SQL untuk akses database SQLite berperforma tinggi.

Instal

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

bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan lagi setelah setiap upgrade plugin.

Impor

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

Sekilas tentang API

Metode Deskripsi
connect Inisialisasi koneksi database dan jalankan HTTP server.
disconnect Tutup koneksi database dan hentikan HTTP server.
getServerInfo Dapatkan port HTTP server dan token untuk komunikasi langsung.
execute Jalankan query SQL lewat bridge Capacitor (untuk query sederhana). Untuk performa yang lebih baik dengan dataset besar, gunakan protokol HTTP secara langsung melalui class SQLConnection.
beginTransaction Mulai transaksi database.
commitTransaction Commit transaksi saat ini.
rollbackTransaction Rollback transaksi saat ini.
configureWeb Konfigurasi opsi khusus web untuk modul resmi SQLite Wasm.

Contoh

connect()

Inisialisasi koneksi database dan jalankan HTTP server.

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

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

disconnect()

Tutup koneksi database dan hentikan HTTP server.

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

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

getServerInfo()

Dapatkan port HTTP server dan token untuk komunikasi langsung.

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

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

execute()

Jalankan query SQL lewat bridge Capacitor (untuk query sederhana). Untuk performa yang lebih baik dengan dataset besar, gunakan protokol HTTP secara langsung melalui class 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()

Mulai transaksi database.

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

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

commitTransaction()

Commit transaksi saat ini.

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

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

Tabel di atas mencantumkan 8 metode inti. Dokumentasi untuk Listener, helper versi, serta kontrak lengkap dari setiap metode tersedia di repositori GitHub.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-fast-sql

Jika Anda menggunakan Menggunakan @capgo/capacitor-fast-sql untuk merencanakan penyimpanan dan penanganan file, hubungkan dengan @capgo/capacitor-fast-sql untuk detail implementasi di @capgo/capacitor-fast-sql, Panduan Memulai untuk detail implementasi di Getting Started, @capgo/capacitor-data-storage-sqlite untuk detail implementasi di @capgo/capacitor-data-storage-sqlite, Menggunakan @capgo/capacitor-data-storage-sqlite untuk kapabilitas native di bagian Menggunakan @capgo/capacitor-data-storage-sqlite, dan @capgo/capacitor-file untuk detail implementasi di @capgo/capacitor-file.

FAQ

FAQ plugin Fast SQL

Bagaimana cara install plugin Fast SQL di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-fast-sql" (atau "npm install @capgo/capacitor-fast-sql"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mengenali code native. Import dari "@capgo/capacitor-fast-sql" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-fast-sql bisa dipakai dengan React, Vue, dan Angular?

Ya. Fast SQL adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung @capgo/capacitor-fast-sql?

Plugin Capgo mengikuti versi major Capacitor: gunakan versi major plugin yang cocok dengan versi major Capacitor Anda (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang di-maintain.

Apakah @capgo/capacitor-fast-sql gratis dan open source?

Ya. Source code tersedia secara publik di GitHub pada https://github.com/Cap-go/capacitor-fast-sql/ dan package ini gratis untuk diinstall dari npm. Kami menerima laporan bug dan pull request.

Bisakah saya update code yang menggunakan Fast SQL tanpa review App Store?

Install atau upgrade plugin akan mengubah code native, sehingga butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin tersebut bisa langsung dikirim via Capgo live updates.

Rilis perubahan SQL dengan cepat tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, Capgo live updates mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo