Langsung 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 kembali setiap kali melakukan 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 melalui 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 yang sedang berjalan.
rollbackTransaction Rollback transaksi yang sedang berjalan.
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 melalui 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 yang sedang berjalan.

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

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

Tabel di atas mencantumkan 8 metode inti. Helper listener, versi, dan kontrak lengkap setiap metode didokumentasikan 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 kemampuan 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 menginstal 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. Impor dari "@capgo/capacitor-fast-sql" di code aplikasi Anda.

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

Ya. Fast SQL adalah paket Capacitor, jadi bekerja 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 mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

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

Ya. Kode sumber (code) tersedia untuk publik di GitHub pada https://github.com/Cap-go/capacitor-fast-sql/ dan paketnya gratis diinstal dari npm. Laporan bug dan pull request sangat diterima.

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

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

Rilis perubahan Fast SQL tanpa menunggu review aplikasi

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

Mulai dengan Capgo