如何确认Android支持的SQLite FTS版本？需用FTS5专属自定义词干函数

嘿，我来帮你解决这个关于Android SQLite FTS版本检测和自定义词干函数的问题！

一、检测FTS4/FTS5的支持情况 #

1. 基于SQLite版本的大致判断 #

先给你个快速参考的对应关系：

• FTS4 是在 SQLite 3.7.4 中引入的
• FTS5 是在 SQLite 3.9.0 中引入的

对应到Android系统版本：

• Android 4.1（API 16）及以上自带的SQLite版本≥3.7.11，基本支持FTS4
• Android 8.0（API 26）及以上自带的SQLite版本≥3.22.0，原生支持FTS5

不过要注意，部分厂商可能会在低版本Android上更新SQLite，或者在高版本上禁用某些FTS特性，所以更可靠的方式是直接查询SQLite的编译选项。

2. 通过SQL查询直接检测支持性 #

这是最准确的检测方式，你可以通过执行SQL查询确认设备是否开启了对应FTS特性的编译选项：

检测FTS4支持

boolean supportsFTS4 = false;
try (Cursor cursor = yourSQLiteDatabase.rawQuery("SELECT sqlite_compileoption_used('ENABLE_FTS4')", null)) {
    if (cursor.moveToFirst()) {
        supportsFTS4 = cursor.getInt(0) == 1;
    }
} catch (Exception e) {
    // 抛出异常说明SQLite版本过低，不支持该函数，即不支持FTS4
    supportsFTS4 = false;
}

检测FTS5支持

boolean supportsFTS5 = false;
try (Cursor cursor = yourSQLiteDatabase.rawQuery("SELECT sqlite_compileoption_used('ENABLE_FTS5')", null)) {
    if (cursor.moveToFirst()) {
        supportsFTS5 = cursor.getInt(0) == 1;
    }
} catch (Exception e) {
    supportsFTS5 = false;
}

二、FTS5自定义词干函数的适配 #

自定义词干函数是FTS5独有的特性，所以首先要确保设备支持FTS5，再进行以下操作：

1. 注册自定义词干函数 #

首先创建一个继承自SQLiteFunction的自定义词干类，实现你的词干处理逻辑：

public class CustomStemmer extends SQLiteFunction {
    @Override
    protected void xFunc() {
        // 处理输入参数，这里假设输入是第一个参数
        if (args.length == 0) {
            return;
        }
        String inputText = value_text(0);
        // 这里替换成你的自定义词干处理逻辑
        String stemmedText = yourStemmingAlgorithm(inputText);
        
        // 返回处理后的结果
        result(stemmedText);
    }
}

然后在你的SQLite数据库实例中注册这个函数：

yourSQLiteDatabase.createFunction("my_custom_stem", 1, new CustomStemmer());

2. 创建使用自定义词干的FTS5表 #

注册完成后，创建FTS5表时可以指定使用你的自定义词干器：

CREATE VIRTUAL TABLE fts5_content USING fts5(
    title,
    content,
    tokenize = 'unicode61 remove_diacritics stemmer=my_custom_stem'
);

3. 适配低版本设备 #

如果设备不支持FTS5，你可以考虑以下降级方案：

• 手动在插入数据前处理词干，然后使用FTS4进行搜索（FTS4不支持自定义词干器，只能提前处理）
• 引入预编译的高版本SQLite绑定库，让低版本Android设备也能支持FTS5特性

内容的提问来源于stack exchange，提问作者AVEbrahimi