@capgo/capacitor-data-storage-sqlite

中文文档
8.0.60发布于 2026/11/09MPL-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 4.4万

SQLite 密钥/ 值字符串对的存储

中文使用文档
文档目录47 节
  1. *免费开始*
  2. 主要特点
  3. 数据存储集
  4. 为什么数据存储 SQLite?
  5. 维护者
  6. 浏览器支持
  7. 文档
  8. 兼容性
  9. 安装
  10. 配置
  11. 支持的方法
  12. 文档
  13. 显示插件用途的应用程序
  14. 离子/角
  15. 音效/反应
  16. 反应
  17. 音响/声调
  18. 阴道
  19. 使用量
  20. 依赖关系
  21. 数据库加密密码句
  22. 贡献者
  23. 打开Store(...)
  24. 关闭Store(...)
  25. 是 Store 打开(...)
  26. 属于 StoreExists (...)
  27. 删除Store(...)
  28. 设置表格(...)
  29. 设置(...)
  30. 获取(...)
  31. 删除(...)
  32. 清除( c)
  33. 异键(...)
  34. 键( )
  35. 数值()
  36. 过滤值(...)
  37. 键值( )
  38. istable (...) (中文(简体) )
  39. 表格( )
  40. 删除表格(...)
  41. 从 Json (...) 导入
  42. 是 JsonValid (...) 语句
  43. 导出 ToJson ()
  44. 真空( )
  45. 获取 PluginVersion ()
  46. 接口
  47. 类型异名

从您的 Capacitor app 存储 SQLite 中的密钥和值字符串, 其中有多个商店和表格, 以及 iOS 和 Android 的可选加密 。 一个简单的,持久的替代 本地Storage.

Capgo - Build Capacitor apps with AI, ship updates instantly

队长:在几分钟内将修正推给您的 Capacitor 用户,在没有Mac的情况下构建已签名的iOS和Android apps,并在一击中回滚.

*免费开始*

14天无限自由审判. 不需要信用卡

🤖 建筑与AI编码代理? 安装 Capgo 技能 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 @capgo/capacitor-data-storage-sqlite 在您的电容应用程序中: npx skills add Cap-go/capgo-skills。然后问你的经纪人: 加上@capgo/capor-data-storage-sqlite到我的Capacitor应用上并把它接上 代理设置指南 • 妇女 主机磁共振

@capgo/capacitor-data-storage-sqlite for Capacitor apps

主要特点

  • 密钥值 API数字 : set(), (中文(简体) ), get(), (中文(简体) ), remove(), (中文(简体) ), clear(), (中文(简体) ), iskey(), (中文(简体) ), keys(), (中文(简体) ), values() 财务报告和审定财务报表 keysvalues()。 。 。 .
  • 库存和表格数字 : openStore(), (中文(简体) ), setTable(), (中文(简体) ), tables(), (中文(简体) ), deleteTable() 财务报告和审定财务报表 deleteStore()。 。 。 .
  • 加密:通过SQLCipher在iOS和Android上的可选加密商店.
  • JSON 进出口数字 : importFromJson(), (中文(简体) ), isJsonValid() 财务报告和审定财务报表 exportToJson()。 。 。 .
  • 过滤数字 : filtervalues() 返回匹配过滤器的密钥的值.
  • 平台: iOS,Android和Web. 互联网档案馆的存檔,存档日期2013-12-02. Web在浏览器中存储数据,其密钥值与API相同.


数据存储集

@capgo/capacitor-data-storage-sqlite


第6条



业主的说明


此插件已转移至 Capgo 或 @ jepiqueau (英语) 决定退休.
我们将永远感谢他所做的工作.


Capacitor 数据存储 SQlite 插件是一个自定义的本地 Capacitor 插件,为简单数据提供密钥值永久存储 仅类型字符串 至IOS,Android和Electron平台上的SQLite并至Web平台的IndexDB.

为什么数据存储 SQLite?

一个维护的由社区驱动的插件,提供由SQLite支持的简单的密钥值存储. 最初由@jepiqueau创建,现由Capgo维护:

  • 简单 API - 用于字符串数据的简单密钥值存储接口
  • 跨平台 - iOS、Android、Electron和Web(IndexedDB)方面的工作
  • SQL 备份 - 在本地平台上可靠、加密地存储
  • 进出口 - JSON数据传输进出口
  • 多表支助 - 组织多个表格的数据

对于需要简单,可靠的本地存储而不需要复杂的SQL查询的应用程序来说,是完美的.


维护者

维护者GitHub 图像社会
马丁·多纳迪厄骑师x
让·皮埃尔耶稣会

浏览器支持

插件遵循来自 Capacitor Team, (中文(简体) ),

意思是,如果没有额外的 JavaScript 转换, 它将无法在 IE11 中工作, 例如: 宝贝。 。 。 .

文档

这里有最完整的医生: https://capgo.app/docs/plugins/data-storage-sqlite/ 页面存档备份,存于互联网档案馆

兼容性

插件版本电容兼容性维护
联合国联合国✅
页:1页:1应要求
页:1页:1❌
页:1页:1❌

说明: 此插件的主要版本沿用了Capacitor的主要版本. 使用匹配您的 Capacitor 安装的版本( 如 Capacitor 8 的插件 v8) 。 只有最新的主要版本得到积极维护.

安装

您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :

npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins

然后使用下列提示:

Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-data-storage-sqlite` plugin in my project.

如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:

npm install --save @capgo/capacitor-data-storage-sqlite
npx cap sync
  • 在iOS方面,无需采取进一步措施.

  • 在Android上,不需要进一步的步骤.

  • 网上,

npm install --save localforage
  • 在电上
npm install --save @capacitor-community/electron
npx cap add @capacitor-community/electron

转到您的应用程序的电子文件夹

cd electron
npm install --save sqlite3
npm install --save-dev @types/sqlite3
npm run build
cd ..
npx cap sync @capacitor-community/electron

然后构建您的属性( A)

npm run build
npx cap copy
npx cap copy @capacitor-community/electron
npx cap open ios
npx cap open android
npx cap open @capacitor-community/electron
ionic serve

配置

此插件不需要配置

支持的方法

名称机器人iOS系统电子网页
打开Store( 非加密 DB)✅✅✅✅
打开 Store (加密 DB)✅✅❌❌
关闭 Store✅✅✅❌
是 Store 打开✅✅✅❌
已存在✅✅✅❌
删除Store✅✅✅❌
设置表格✅✅✅✅
设定✅✅✅✅
起来✅✅✅✅
键✅✅✅✅
密钥✅✅✅✅
数值✅✅✅✅
过滤值✅✅✅✅
键值✅✅✅✅
删除✅✅✅✅
清除✅✅✅✅
列表✅✅✅✅
图表✅✅✅✅
删除表格✅✅✅❌
这是杰森瓦利德✅✅✅✅
从 Json 导入✅✅✅✅
导出 ToJson✅✅✅✅

文档

显示插件用途的应用程序

离子/角

音效/反应

反应

音响/声调

阴道

使用量

依赖关系

IOS & Android代码使用SQLCipher允许数据库加密. 安卓代码现在基于 androidx.sqlite。每次交易后,为了改进业绩,数据库不再关闭. 你必须管理 close 在打开新数据库之前先输入数据库. 网络代码使用 localforage 在浏览器中存储数据存储的软件包. 电码使用 sqlite3软件包

数据库加密密码句

打开 iOS系统 财务报告和审定财务报表 机器人,加密仓库使用插件中的 SQLCipher 密码句 Global 缺省数(test secret 编号 : test new secret) 除非你自己配置.

建议 (CLI APs): 设置密码句 capacitor.config.ts 以免内出血 node_modules数字 :

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    CapgoCapacitorDataStorageSqlite: {
      encryptionSecret: 'my-production-passphrase',
      encryptionNewSecret: 'my-next-passphrase',
    },
  },
};

export default config;

然后使用 openStore 与 encrypted: true 财务报告和审定财务报表 mode 设置为 secret, (中文(简体) ), encryption,或 newsecret 如API文件所描述.

高级 : 内置默认值存在于插件包中(不是在您的 android/ 应用树 :

  • 机器人: node_modules/@capgo/capacitor-data-storage-sqlite/android/src/main/java/com/jeep/plugin/capacitor/capgocapacitordatastoragesqlite/cdssUtils/Global.java
  • iOS: (英语) node_modules/@capgo/capacitor-data-storage-sqlite/ios/Sources/CapgoCapacitorDataStorageSqlitePlugin/Global.swift

避免直接编辑这些文件;它们安装时被覆盖。 偏爱 capacitor.config 或插件的分叉.

要打开加密的 .db 在桌面 SQLCipher 工具中,使用您配置的相同的密码句 encryptionSecret (或现后的秘密) newsecret (原始内容存档于2013-10-12). rekey.

贡献者

感谢这些伟大的人emoji 密钥:


让·皮埃尔·克约

💻

马修·伯克

📖

凯文·范沙伊克

💻

安迪・加贝特

📖

打开Store(...)

openStore(options: capOpenStorageOptions) => Promise<void>

打开商店

参数类型说明
optionscapOpenStorageOptions数字 : 封顶

自: 0.0.1 资源


关闭Store(...)

closeStore(options: capStorageOptions) => Promise<void>

关闭存储

参数类型说明
optionscapStorageOptions数字 : 笼盖

自: 3.0.0 (单位:千美元)


是 Store 打开(...)

isStoreOpen(options: capStorageOptions) => Promise<capDataStorageResult>

检查仓库是否打开

参数类型说明
optionscapStorageOptions数字 : 笼盖

回返情况: Promise<capDataStorageResult>

自: 3.0.0 (单位:千美元)


属于 StoreExists (...)

isStoreExists(options: capStorageOptions) => Promise<capDataStorageResult>

检查仓库是否存在

参数类型说明
optionscapStorageOptions数字 : 笼盖

回返情况: Promise<capDataStorageResult>

自: 3.0.0 (单位:千美元)


删除Store(...)

deleteStore(options: capOpenStorageOptions) => Promise<void>

删除存储

参数类型说明
optionscapOpenStorageOptions数字 : 封顶

自: 0.0.1 资源


设置表格(...)

setTable(options: capTableStorageOptions) => Promise<void>

设置或添加表格到已有的存储中

参数类型说明
optionscapTableStorageOptions数字 : 封面表组合选项

自: 0.0.1 资源


设置(...)

set(options: capDataStorageOptions) => Promise<void>

用给定的密钥和值存储数据

参数类型说明
optionscapDataStorageOptions数字 : capDataStorage 选项

自: 0.0.1 资源


获取(...)

get(options: capDataStorageOptions) => Promise<capValueResult>

获取给定数据密钥的数据值

参数类型说明
optionscapDataStorageOptions数字 : capDataStorage 选项

回返情况: Promise<capValueResult>

自: 0.0.1 资源


删除(...)

remove(options: capDataStorageOptions) => Promise<void>

用给定的密钥删除数据

参数类型说明
optionscapDataStorageOptions数字 : capDataStorage 选项

自: 0.0.1 资源


清除( c)

clear() => Promise<void>

清除数据存储( 删除全部密钥)

自: 0.0.1 资源


异键(...)

iskey(options: capDataStorageOptions) => Promise<capDataStorageResult>

检查数据密钥是否存在

参数类型说明
optionscapDataStorageOptions数字 : capDataStorage 选项

回返情况: Promise<capDataStorageResult>

自: 0.0.1 资源


键( )

keys() => Promise<capKeysResult>

获取数据密钥列表

回返情况: Promise<capKeysResult>

自: 0.0.1 资源


数值()

values() => Promise<capValuesResult>

获取数据值列表

回返情况: Promise<capValuesResult>

自: 0.0.1 资源


过滤值(...)

filtervalues(options: capFilterStorageOptions) => Promise<capValuesResult>

获取过滤密钥的数据值列表

参数类型说明
optionscapFilterStorageOptions数字 : 笼盖

回返情况: Promise<capValuesResult>

自: 2.4.2


键值( )

keysvalues() => Promise<capKeysValuesResult>

获取数据密钥/ 值对列表

回返情况: Promise<capKeysValuesResult>

自: 0.0.1 资源


istable (...) (中文(简体) )

isTable(options: capTableStorageOptions) => Promise<capDataStorageResult>

检查是否有表格

参数类型说明
optionscapTableStorageOptions数字 : 封面表组合选项

回返情况: Promise<capDataStorageResult>

自: 3.0.0 (单位:千美元)


表格( )

tables() => Promise<capTablesResult>

获取当前存储的表格列表

回返情况: Promise<capTablesResult>

自: 3.0.0 (单位:千美元)


删除表格(...)

deleteTable(options: capTableStorageOptions) => Promise<void>

删除表格

参数类型说明
optionscapTableStorageOptions数字 : 封面表组合选项

自: 3.0.0 (单位:千美元)


从 Json (...) 导入

importFromJson(options: capStoreImportOptions) => Promise<capDataStorageChanges>

从 JSON 从数据库导入

参数类型
optionscapStoreImportOptions

回返情况: Promise<capDataStorageChanges>

自: 3.2.0 (中文(简体) )


是 JsonValid (...) 语句

isJsonValid(options: capStoreImportOptions) => Promise<capDataStorageResult>

检查 JSON 对象的有效性

参数类型
optionscapStoreImportOptions

回返情况: Promise<capDataStorageResult>

自: 3.2.0 (中文(简体) )


导出 ToJson ()

exportToJson() => Promise<capStoreJson>

导出给定的数据库到 JSON 对象

回返情况: Promise<capStoreJson>

自: 3.2.0 (中文(简体) )


真空( )

vacuum() => Promise<void>

重建目前的 SQLite 商店以回收未使用的磁盘空间 .

自: 8.032 电话


获取 PluginVersion ()

getPluginVersion() => Promise<{ version: string; }>

获取本地 Capacitor 插件版本

回返情况: Promise<{ version: string; }>


接口

封顶

Prop类型说明
databasestring存储数据库名称
tablestring存储表名称
encryptedboolean数据库加密设置为正
modestring在iOS和Android上设置数据库加密模式。 - encryption - 用已配置的密码句加密一个已存在的纯文本数据库 - secret ——打开或创建带有所配置的密码句的加密数据库 - newsecret ——重接加密数据库 encryptionSecret 改为 encryptionNewSecret 密码句设置在 capacitor.config 下级 plugins.CapgoCapacitorDataStorageSqlite (见QQLink Capgo CapacitorDataStorageSqlite Config}). 默认在插件中定义 Global 源,如果您不配置它们.
autoVacuumcapSQLiteAutoVacuum为商店设置 SQLite 自动 vacuum 模式 。 使用 none编号 :0, (中文(简体) ), full编号 :1,或 incremental编号 :2iOS,Android,以及只有电能. Web 忽略此选项 .

笼盖

Prop类型说明
databasestring存储名称

capDataStorage 结果

Prop类型说明
resultboolean当成功时结果被设定为真实
messagestring返回的消息

封面表组合选项

Prop类型说明
tablestring存储表名称

capDataStorage 选项

Prop类型说明
keystring数据名称
valuestring所需数据值

上限

Prop类型说明
valuestring给定数据密钥的数据值

capeKeys 结果

Prop类型说明
keysstring[]作为矩阵的数据密钥列表

上限

Prop类型说明
valuesstring[]作为矩阵的数据值列表

笼盖

Prop类型说明
filterstring用于过滤密钥的过滤数据 ['% filter',"filter","filter%"],用于[从过滤器开始,包含过滤器,以过滤器结束]

capeKeysValues 结果

Prop类型说明
keysvaluesany[]数据密钥/ 值列表为 { key: string, value: string} 的矩阵

封顶表

Prop类型说明
tablesstring[]表格列表为矩阵

capDataStorage 变化

Prop类型说明
changesnumber导入的 FromJson 命令的更改数

封口导入选项

Prop类型说明
jsonstringstring设定要导入的 JSON 对象

盖斯多尔杰森

Prop类型说明
exportJsonStore导出 JSON 对象

杰森斯托尔

Prop类型说明
databasestring数据库名称
encryptedboolean设定为真( 数据库加密) / 假的 iOS & Android
tablesJsonTable[]* 表数组(Json表单(中文(简体) )

Json表单

Prop类型说明
namestring数据库名称
valuescapDataStorageOptions[]* 数值矩阵(capDataStorage 选项(中文(简体) )

类型异名

capSQLite 奥托沃库姆

'none' | 'full' | 'incremental' | 0 | 1 | 2

本项目遵循 全部贡献者 规格。 任何捐款都欢迎!

@jepiqueau的退休信息 -- >


自从Ionic Capacitor创立以来,我多年来一直致力于开发和维护这个插件. 现在,73+岁, 随着我的MacBook Pro因运行iOS的Capacitor 6而变得过时, 我决定停止对插件的维护。 如果有人希望拥有这个插件,欢迎他们这样做.


与开发者社区一道参与这一发展旅程,是一个极大的荣誉。 我很高兴看到你们中许多人跟随我走这条路,并将插件纳入你们的应用程序。 你的意见和建议促使我不断加以改进.


我之所以作出这一决定,是因为与家庭有关的一些问题需要我充分注意和时间。 因此,我不会退缩。 感谢大家的支持.


结束 < -


版本与发布记录

@capgo/capacitor-data-storage-sqlite 共发布 138 个版本,首次发布于 2024/08/15;过去 12 个月发布了 65 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.0.60latest2026/11/09今天
8.0.592026/11/027 天前
8.0.582026/10/2613 天前
8.0.572026/10/1920 天前
8.0.562026/10/1525 天前
8.0.552026/10/1327 天前

关于 @capgo/capacitor-data-storage-sqlite 的常见问题

@capgo/capacitor-data-storage-sqlite 是什么?

SQLite 密钥/ 值字符串对的存储

如何安装 @capgo/capacitor-data-storage-sqlite?

在项目目录运行 npm install @capgo/capacitor-data-storage-sqlite,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:localforage(^1.10.0)、@capacitor/core(>=8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capgo/capacitor-data-storage-sqlite 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capgo/capacitor-data-storage-sqlite 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capgo/capacitor-data-storage-sqlite 可以商用吗?

@capgo/capacitor-data-storage-sqlite 使用 MPL-2.0 许可。弱 Copyleft:可以商用,也可以和闭源代码一起使用;但如果分发时修改了 MPL 授权的文件,这些文件的修改需以 MPL 开源。以上为概括,不构成法律意见,请以许可原文为准。

@capgo/capacitor-data-storage-sqlite 的下载量有多少?

根据 npm 官方下载统计,@capgo/capacitor-data-storage-sqlite 在 2026/10/09 – 2026/11/07 这 30 天内被下载 43,798 次,日均约 1,460 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capgo/capacitor-data-storage-sqlite 还在维护吗?

最新版本 8.0.60 发布于 2026/11/09(今天);至今共发布 138 个版本,其中过去 12 个月发布了 65 个;首次发布于 2024/08/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。