常见问题汇总（提 issue 前请先看这个）

[wangfenjin]

1. XX 语言的 ORM 加载报错？

这个库是一个标准的 SQLite FTS5 拓展，理论上与具体的语言无关。如果你依赖的 ORM 或者其他语言的封装有问题，请自行 debug。如果要问问题，请贴上完整的错误日志或者 SQL 语句。 examples 目录下有几种常见语言的例子，欢迎提 PR 加更多例子。

2. 为什么不能指定主键？这个 SQL 为什么报错？

这个库是一个标准的 SQLite FTS5 拓展，语法需要满足 SQLite 标准的语法。加载这个扩展只是给 SQLite 加了几个函数，对 SQL 语法没有影响。 FTS5 的使用参考 https://www.sqlite.org/fts5.html

3. XX 系统加载 Release 包失败？

我测试了 macOS 和 Linux 的输出，理论上都是没问题的。如果失败，请附上错误日志，一般自行 Google 也能找到原因，大部分情况都是系统版本太旧导致的。 Windows 的输出我没测试过，不保证能用，我也没有 Windows 电脑，所以对于 Windows 更好的支持欢迎各位提 PR。

4. 匹配的好像不太对？

匹配的原理参考我在 Readme 里面放的两个博客链接。大部分都是因为 pinyin.txt 里面包含了太多的生僻字或者生僻读音引起的，如果不满足需求可以自行编辑 pinyin.txt 然后重新编译。

5. 移动端怎么使用？

iOS 已知有人在使用了，Readme 里面也有例子。Android 理论上也可以，但是我这边还没有例子，欢迎 PR。

6. 编译问题？

编译是 C++ 本身的老大难问题，几乎所有的 C++ 项目都会碰到各种各样的编译问题。但是这个库逻辑简单，依赖也不多，请大家自行解决，可以参考 GitHub Action 的例子。每个 PR 都要求跑过 CI，所以理论上不存在编译不过的情况。最简单的编译流程：

# 这会 Release 一个不包含 jieba 分词功能的扩展，支持拼音搜索。
mkdir build
cd build
cmake ..  -DCMAKE_BUILD_TYPE=Release -DCODE_COVERAGE=OFF -DBUILD_SHELL=OFF -DBUILD_TEST_EXAMPLE=OFF -DSIMPLE_WITH_JIEBA=OFF
make

[wangfenjin]

Windows 系统下是可以用的，具体参考 #92 #93

[wangfenjin]

在 GDPR 中使用的例子参见 #91

[wangfenjin]

打开/关闭拼音参见 #94 #90

[wangfenjin]

Rust 使用例子 #89

[wangfenjin]

macOS "cannot be opened because the developer cannot be verified"

https://github.com/wangfenjin/simple/issues/100