基于 Simple (支持中文和拼音的 SQLite FTS5 全文搜索扩展) 和 sqlite3.dart 的 Flutter 库，用于 SQLite 中文和拼音全文搜索。
Tip
sqlite3 在 3.0.0 即 v3 版本引入了 Dart Hooks 管理 SQLite 原生库（Native Library），与 v2 版本不再兼容。本库基于 v3 版本，v2 请查看 v1 分支，使用 sqlite3_simple: ^2.0.0 以下的版本。
| 支持平台 | 示例 |
|---|---|
| Android (example.apk) |  |
| iOS |  |
| Windows |  |
| MacOS |  |
| Linux |  |
| Web |  |
SQLite 通过 SQLite FTS5 Extension 提供全文搜索 (Full-Text Search) 功能；
Dart 提供 FFI 以调用 SQLite、Simple 等 C/C++ 库；
本库通过 Simple 实现中文和拼音全文搜索，通过 sqlite3 操作数据库和加载自定义扩展。
请参阅相关文档，或 example 的具体示例，以构建和操作数据库。
Tip
本库通过 Github Actions 维护 Simple 原生库以提供不同平台的实现，具体请参阅 simple-native 分支 。
本库通过 sqlite3 管理数据库，因此理论上任何依赖于 sqlite3 的 Flutter 库，均可通过本库实现中文和拼音全文搜索，例如 drift、sqflite_common_ffi，可在 example/lib/data/impl 查看具体示例。
执行如下命令行：
flutter pub add sqlite3sqlite3 包含了 SQLite 原生库的 Dart FFI 绑定，以及通过 Dart Hooks 管理原生库的流程。如需自定义 SQLite 原生库，可参考其文档说明进行配置。
flutter pub add sqlite3_simpleimport'package:sqlite3/sqlite3.dart';
import'package:sqlite3_simple/sqlite3_simple.dart';sqlite3.loadSimpleExtension();如需启用 结巴分词 (Jieba) ，请调用 sqlite3.saveJiebaDict() 将字典保存到可访问的路径，例如：
import'package:path_provider/path_provider.dart';
import'package:path/path.dart';
final docDir =awaitgetApplicationDocumentsDirectory();
final jiebaDictPath =join(docDir.path, "cpp_jieba");
final jiebaDictSql =await sqlite3.saveJiebaDict(jiebaDictPath);返回值 jiebaDictSql 是 "SELECT jieba_dict('$jiebaDictPath')" 。
参阅 sqlite3 的说明，通过 sqlite3.open() 或 sqlite3.openInMemory() 打开数据库。
final db = sqlite3.open('$filename');如需启用结巴分词，请让数据库执行上一步的 jiebaDictSql 语句，以修改 Simple 扩展读取结巴分词字典的路径：
db.execute(jiebaDictSql);推荐在正式查询前执行一次查询，提前加载，例如：
db.select("SELECT jieba_query('Jieba分词初始化（提前加载避免后续等待）')");上述初始化逻辑可以参考 example/lib/data/impl/sqlite3/sqlite3_impl.dart。
根据 SQLite FTS5 Extension 的说明和实际项目需求，创建主表、FTS5 虚表和触发器，例如 Sqlite3Fts5Creator.createMainAndFts5()：
const fts5Tokenizer ="simple";
const mainTable ="custom";
const id ="id",
title ="title",
content ="content",
insertDate ="insert_date";
const fts5Table ="t1";
Future<void> createMainAndFts5(CommonDatabase db) async {
/// 主表 db.execute(''' CREATE TABLE $mainTable ( $id INTEGER PRIMARY KEY AUTOINCREMENT, $title TEXT, $content TEXT, $insertDate INTEGER ); ''');
/// FTS5虚表 db.execute(''' CREATE VIRTUAL TABLE $fts5Table USING fts5( $title, $content, $insertDate UNINDEXED, tokenize = '$fts5Tokenizer', content = '$mainTable', content_rowid = '$id' ); ''');
/// 触发器const newInsert =''' INSERT INTO $fts5Table(rowid, $title, $content, $insertDate) VALUES (new.$id, new.$title, new.$content, new.$insertDate); ''';
const deleteInsert =''' INSERT INTO $fts5Table($fts5Table, rowid, $title, $content, $insertDate) VALUES ('delete', old.$id, old.$title, old.$content, old.$insertDate); ''';
db.execute(''' CREATE TRIGGER ${mainTable}_insert AFTER INSERT ON $mainTable BEGIN $newInsert END; ''');
db.execute(''' CREATE TRIGGER ${mainTable}_delete AFTER DELETE ON $mainTable BEGIN $deleteInsert END; ''');
db.execute(''' CREATE TRIGGER ${mainTable}_update AFTER UPDATE ON $mainTable BEGIN $deleteInsert $newInsert END; ''');
}参阅 Simple 的说明，根据需要调用 jieba_query、simple_query、highlight、simple_highlight 进行查询，例如 Sqlite3Dao.search()：
/// 通过指定分词器 [tokenizer] 搜索， [tokenizer] 取值：jieba, simpleFuture<List<MainTableRow>> search(String value, Tokenizer tokenizer) async {
const wrapperSql ="'${ZeroWidth.start}', '${ZeroWidth.end}'";
final resultSet = db.select(''' SELECT rowid AS $id, simple_highlight($fts5Table, 0, $wrapperSql) AS $title, simple_highlight($fts5Table, 1, $wrapperSql) AS $content, $insertDate FROM $fts5Table WHERE $fts5Table MATCH ${tokenizer.name}_query(?); ''', [value]);
return_toMainTableRows(resultSet);
}Simple：支持中文和拼音的 SQLite FTS5 全文搜索扩展。
sqlite3.dart：SQLite3 的 Dart FFI 绑定。
extended_text：Flutter Text 的扩展组件，支持特殊文本效果。
wasd：面向 Dart 和 Flutter 生态系统的纯 Dart WebAssembly 运行时。
Riverpod：响应式缓存与数据绑定框架，用于应用的状态管理。
Squadron：Dart 多线程管理框架。