メインコンテンツへスキップ
@capgo/capacitor-fast-sql ファイルとストレージ オープンソース

高速なSQL Capacitor プラグイン

効率的な同期操作のためのカスタムプロトコルを備えた高性能ネイティブSQLite。IndexedDBの代替。

インストール

bun add @capgo/capacitor-fast-sql bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-fast-sql
  • pnpm add @capgo/capacitor-fast-sql
  • yarn add @capgo/capacitor-fast-sql

ガイド

Capacitor で Fast SQL を使う方法

@capgo/capacitor-fast-sql の使用

高速な SQLite データベースアクセスを実現する Fast SQL プラグイン。

インストール

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

bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

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

API の概要

メソッド 説明
connect データベース接続を初期化し、HTTPサーバーを起動します。
disconnect データベース接続を閉じ、HTTPサーバーを停止します。
getServerInfo 直接通信に使うHTTPサーバーのポートとトークンを取得します。
execute Capacitor bridge経由でSQLクエリを実行します(シンプルなクエリ向け)。大規模なデータセットでパフォーマンスを上げたい場合は、SQLConnectionクラスでHTTPプロトコルを直接使ってください。
beginTransaction データベーストランザクションを開始します。
commitTransaction 現在のトランザクションをコミットします。
rollbackTransaction 現在のトランザクションをロールバックします。
configureWeb 公式のSQLite WasmモジュールのWeb固有オプションを設定します。

例

connect()

データベース接続を初期化し、HTTPサーバーを起動します。

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

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

disconnect()

データベース接続を閉じ、HTTPサーバーを停止します。

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

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

getServerInfo()

直接通信に使うHTTPサーバーのポートとトークンを取得します。

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

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

execute()

Capacitor bridge経由でSQLクエリを実行します(シンプルなクエリ向け)。大規模なデータセットでパフォーマンスを上げたい場合は、SQLConnectionクラスでHTTPプロトコルを直接使ってください。

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

データベーストランザクションを開始します。

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

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

commitTransaction()

現在のトランザクションをコミットします。

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

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

上記の表は 8 つのコアメソッドの一覧です。リスナーやバージョンのヘルパー、各メソッドの完全なコントラクトについては、 GitHub リポジトリ.

完全なリファレンス

「@capgo/capacitor-fast-sql の使用」から続ける

使用している場合 @capgo/capacitor-fast-sql の使用 ストレージとファイル処理を計画するには、以下と連携してください: @capgo/capacitor-fast-sql @capgo/capacitor-fast-sql の実装の詳細については、 スタートガイド スタートガイドの実装詳細については、 @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite の実装の詳細については、 @capgo/capacitor-data-storage-sqlite の使い方 @capgo/capacitor-data-storage-sqlite を使う際のネイティブ機能については、また @capgo/capacitor-file @capgo/capacitor-file. の実装詳細については

よくある質問

Fast SQL プラグイン FAQ

Capacitor アプリに Fast SQL プラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-fast-sql"(または "npm install @capgo/capacitor-fast-sql")を実行した後、"bunx cap sync" を実行して、iOS および Android プロジェクトにネイティブの code を反映させてください。その後、アプリの code から "@capgo/capacitor-fast-sql" をインポートします。

@capgo/capacitor-fast-sql は React、Vue、Angular で動作しますか?

はい。Fast SQL は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、およびプレーンな JavaScript を含む、Capacitor 内で動作するあらゆる Web フレームワークで使用できます。

@capgo/capacitor-fast-sql はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-fast-sql は無料でオープンソースですか?

はい。code のソースコードは GitHub の https://github.com/Cap-go/capacitor-fast-sql/ で公開されており、パッケージは npm から無料でインストールできます。バグ報告やプルリクエストも歓迎です。

App Store の審査なしで、Fast SQL を使用している code をアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずにFast SQLの変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める