更新记录

1.0.2(2026-11-19)

首次发布:完成 Android / HarmonyOS 双端实现与真机验证。

1.0.1(2026-11-19)

首次发布:完成 Android / HarmonyOS 双端实现与真机验证。

1.0.0(2026-11-19)

首次发布:完成 Android / HarmonyOS 双端实现与真机验证。

查看更多

平台兼容性

uni-app x(4.25)

Chrome Safari Android iOS 鸿蒙 微信小程序
× × √ × √ ×

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× × × √

uni-sqlite-pro

开箱即用的原生本地数据库 UTS 插件。纯系统 API,无三方 SDK 依赖,一行 import 即可使用。

效果预览

MuMu 模拟器(Android 12)真机运行截图,图片托管在插件市场 CDN。

SQLite 插件运行效果:打开数据库、插入数据、查询列表、诊断信息

真机验证结果:数据库打开成功(路径 /data/user/0/io.dcloud.uniappx/files/demo.db)、插入返回 rowId 与影响行数、查询返回 4 条记录、诊断信息(opened=true, size=20480)均正常。

平台支持

平台 支持 说明
Android ✅ minSdk 21,Kotlin 原生混编,标准基座可运行
鸿蒙 HarmonyOS ✅ ArkTS 原生混编(relationalStore),HBuilderX 4.61+
iOS 🚧 后期版本支持
Web / 小程序 ❌ 请使用前端存储方案

快速开始(3 行代码)

import { openDB, execute, query } from '@/uni_modules/uni-sqlite-pro'

openDB({ name: 'demo', version: 1, success: () => console.log('打开成功') })
execute({ sql: "INSERT INTO user(name, age) VALUES(?, ?)", params: ['张三', 28] })
query({ sql: 'SELECT * FROM user', success: (res) => console.log(res.rows) })

打开数据库时会自动创建示例表:user(id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER)。

API 清单

方法 参数 说明
openDB(options) {name, version, success?, fail?, complete?} 打开/创建数据库,自动建表示例表
closeDB(options?) {success?, fail?, complete?} 关闭数据库
execute(options) {sql, params?, ...} 执行增删改,返回 rowId 与受影响行数
query(options) {sql, params?, ...} 查询,返回 rows 与 columnCount
transaction(options) {sqls, ...} 事务,全部成功提交返回 1
backup(options) {path, ...} 备份数据库文件到指定路径
getInfo(options) {success?, ...} 诊断:opened/name/version/path/size
isOpen() 无 同步返回是否已打开

返回结构

成功回调统一返回:

{ errCode: 0, errMsg: 'ok', affected: number, rowId: number }   // execute/transaction
{ errCode: 0, errMsg: 'ok', rows: any[], columnCount: number }   // query
{ errCode: 0, errMsg: 'ok', opened, name, version, path, size }  // getInfo

失败回调返回 uni 标准错误对象:errCode、errMsg、errSubject。

错误码

码 含义
9010001 数据库未打开,请先调用 openDB()
9010002 打开数据库失败
9010003 SQL 执行失败
9010004 参数错误
9010005 数据库文件不可写
9010006 备份失败
9010007 当前平台不支持

权限与隐私

  • 数据库文件保存在应用私有目录(Android: filesDir;鸿蒙: databaseDir),无需申请存储权限。
  • 插件不采集任何数据,不访问网络。

常见问题

Q:修改原生代码后需要打自定义基座吗? A:Kotlin 混编代码标准基座真机运行即可生效;鸿蒙 ets 可直接真机运行。若引入三方 SDK 或新增资源才需自定义基座。

Q:params 占位符怎么用? A:SQL 中用 ? 占位,params 按顺序传入,如 execute({ sql: '... VALUES(?,?)', params: ['a', 1] })。

Q:如何拿自增主键 id? A:execute 成功返回的 rowId 即最后插入行的 id。

Q:事务失败会怎样? A:任一 SQL 失败自动回滚,fail 回调返回 9010003。

更新记录

见 changelog.md。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无(数据库文件保存在应用私有目录,无需申请存储权限)

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据,所有数据仅存储在用户设备本地的应用私有目录

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。