uniapp 鸿蒙 sqlite 如何集成和使用

在uniapp开发鸿蒙应用时，如何集成和使用SQLite数据库？需要具体步骤说明，包括环境配置、数据库创建、增删改查操作示例以及注意事项。官方文档对此是否有明确支持？

2 回复

在uniapp中集成鸿蒙SQLite，需使用uniCloud数据库或第三方插件。推荐使用uniCloud的clientDB，直接操作云端数据库，简单高效。本地SQLite可使用cordova插件，但鸿蒙兼容性需测试。

更多关于uniapp 鸿蒙 sqlite 如何集成和使用的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在 UniApp 中集成和使用 SQLite 数据库（包括适配鸿蒙系统）可通过以下步骤实现。由于鸿蒙系统对部分 API 的支持可能有限，建议优先使用 UniApp 官方支持的 SQLite 插件或通用方案。

1. 集成 SQLite 插件

UniApp 官方推荐使用 uni-app 自带的 uni-db 或第三方 SQLite 插件（如 uni-sqlite）。以下是通用方法：

步骤 1：安装 SQLite 插件

  • 在 HBuilderX 中创建 UniApp 项目，通过「插件市场」搜索 SQLite 相关插件（例如 uni-sqlite）。
  • 或通过 npm 安装（若插件支持）：
    npm install [@ionic](/user/ionic)/sqlite  # 示例插件，需确认兼容性

步骤 2：配置原生支持

  • 鸿蒙系统：需在 manifest.json 中声明数据库权限，并确保插件支持鸿蒙内核（部分插件可能需额外适配）。
    {
  "app-plus": {
    "plugins": {
      "sqlite": {
        "version": "1.0.0",
        "provider": "your-plugin-id"
      }
    }
  }
}

2. 使用 SQLite 数据库

以下以通用 SQLite API 为例（具体语法可能因插件而异）：

（1）打开/创建数据库

// 引入插件（根据实际插件调整）
const sqlite = uni.requireNativePlugin('uni-sqlite');

// 打开数据库
sqlite.openDatabase({
  name: 'test.db',
  success: (res) => {
    console.log('数据库打开成功');
  },
  fail: (err) => {
    console.error('数据库打开失败:', err);
  }
});

（2）执行 SQL 语句（建表、插入数据）

// 创建表
sqlite.executeSql({
  sql: 'CREATE TABLE IF NOT EXISTS user(id INTEGER PRIMARY KEY, name TEXT)',
  success: () => console.log('表创建成功'),
  fail: (err) => console.error('执行失败:', err)
});

// 插入数据
sqlite.executeSql({
  sql: 'INSERT INTO user (name) VALUES (?)',
  data: ['张三'],
  success: () => console.log('数据插入成功'),
  fail: (err) => console.error('插入失败:', err)
});

（3）查询数据

sqlite.executeSql({
  sql: 'SELECT * FROM user',
  success: (res) => {
    console.log('查询结果:', res.result);
  },
  fail: (err) => console.error('查询失败:', err)
});

（4）关闭数据库

sqlite.closeDatabase({
  name: 'test.db',
  success: () => console.log('数据库关闭成功')
});

3. 鸿蒙适配注意事项

  1. 权限配置：在鸿蒙系统中，需在 config.json（鸿蒙原生配置）或 UniApp 编译配置中声明存储权限。
  2. 路径问题：鸿蒙的文件系统路径可能与 Android/iOS 不同，建议使用插件提供的绝对路径方法。
  3. 兼容性测试：由于鸿蒙仍处于发展阶段，务必在真机上进行完整测试。

4. 替代方案

如果 SQLite 插件在鸿蒙上不稳定，可考虑以下方案：

  • 使用 UniApp 本地存储（uni.setStorageSync）处理简单数据。
  • 通过 云数据库（如 UniCloud）规避客户端兼容性问题。

通过以上步骤，你可以在 UniApp 中集成 SQLite 并在鸿蒙系统上使用。建议优先选择官方验证过的插件，并关注鸿蒙生态的更新。

回到顶部