更新记录

1.0.0（2026-09-15）

• 首发 App 原生 SQLite UTS API：打开 / 关闭 / 执行 / 查询 / 事务。
• Android SQLiteDatabase，iOS SQLite3 混编，鸿蒙 relationalStore。

平台兼容性

uni-app(4.83)

uni-app x(4.83)

umi-sqlite

uni-app x App 原生 SQLite 插件（Android / iOS / HarmonyOS）。

• Android：android.database.sqlite.SQLiteDatabase（openOrCreateDatabase / compileStatement / rawQuery）
• iOS：系统 SQLite3 C API（Swift 混编 UmiSqliteKit，sqlite3_open_v2 + sqlite3_bind_* + sqlite3_step）
• 鸿蒙：@kit.ArkData relationalStore（getRdbStore / executeSql / querySql / beginTransaction）

仅 App。Android、iOS 真机运行必须打 自定义基座。鸿蒙走原生编译，无需自定义基座。

加密后的普通授权版只能从 @/uni_modules/umi-sqlite 导入，不要写 utssdk/ 内部路径。

API

页面里用工厂函数构造参数，不要给插件 class 的 boolean 字段赋值：

import {
    sqliteOpenOptions,
    sqliteNameOptions,
    sqliteSqlOptions,
    sqliteSqlOptionsWithArgs,
    sqliteTxOptions,
    openDatabase,
    isOpenDatabase,
    closeDatabase,
    executeSql,
    selectSql,
    transaction,
    readAnyErrMsg,
    UmiSqliteExecResult
} from '@/uni_modules/umi-sqlite'

const DB = 'umi_demo'

openDatabase(sqliteOpenOptions(DB)).then(() => {
    executeSql(sqliteSqlOptions(DB, 'CREATE TABLE IF NOT EXISTS todo (id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT, done INTEGER)')).then((_ddl : UmiSqliteExecResult) => {
        executeSql(sqliteSqlOptionsWithArgs(DB, 'INSERT INTO todo(title, done) VALUES (?, ?)', ['hello', 0])).then((ins : UmiSqliteExecResult) => {
            selectSql(sqliteSqlOptions(DB, 'SELECT id, title, done FROM todo ORDER BY id DESC')).then((rows : UTSJSONObject[]) => {
                console.log(rows, ins.lastInsertRowId)
            })
        })
    })
}, (err : any | null) => {
    console.log(readAnyErrMsg(err, '打开失败'))
})

事务：

transaction(sqliteTxOptions(DB, 'begin')).then(() => {
    executeSql(sqliteSqlOptionsWithArgs(DB, 'INSERT INTO todo(title, done) VALUES (?, ?)', ['a', 0])).then(() => {
        transaction(sqliteTxOptions(DB, 'commit'))
    }, (err : any | null) => {
        transaction(sqliteTxOptions(DB, 'rollback'))
    })
})

自定义路径（Android / iOS 为真实 sqlite 文件；鸿蒙写入应用沙箱 databaseDir/rdb/，path 只解析文件名和相对 customDir）：

openDatabase(sqliteOpenOptionsAt(DB, '/storage/emulated/0/Android/data/包名/files/demo.db'))

注意

• executeSql 不要跑 SELECT；查询用 selectSql。
• Android rawQuery 的绑定参数只能是字符串，数字/布尔会转成文本再绑定。写操作走 SQLiteStatement，可按 null / 整数 / 浮点 / 文本绑定。
• 鸿蒙库文件由 StoreConfig.name 管理，不要指望任意绝对路径可写。
• 跨插件不要事后写 boolean 字段；本插件 options 只用 string / number / any[]。
• 页面 import 的函数必须出现在各端 utssdk/app-*/index.uts 的 export function / export class 中。