# rdb_demo

**Repository Path**: scenario-samples/rdb_demo

## Basic Information

- **Project Name**: rdb_demo
- **Description**: 【鸿蒙 Harmony Next 示例 代码】本示例提供了uniapp接入HarmonyOS关系型数据库的插件，可以使用@ohos.data.relationalStore的api。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-27
- **Last Updated**: 2025-05-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# uniapp框架使用关系型数据库
 
### 简介
本示例提供了uniapp接入HarmonyOS关系型数据库的插件，可以使用@ohos.data.relationalStore的api。

1）支持数据库表的创建和删除。

2）支持数据库增、删、改、查。

3）支持执行自定义sql。
 

### 效果预览
![](uni_modules/test-relationalStore/readme_files/rdb_demo_机框.gif)



### 使用说明
1）打开HBuilderX，点击上方菜单 - 工具 - 设置，再点击 运行配置，在鸿蒙运行配置中设置 DevEco Studio 的安装路径。

2）HBuilderX 新建一个空白的 uni-app 项目，选vue3。

3）编译 uni-app 到鸿蒙，点击 HBuilderX 上方【运行】菜单 - 运行到手机或模拟器 - 运行到鸿蒙。

4）第一次运行本项目时会在项目根目录下生成 harmony-configs 目录用于存放鸿蒙配置文件。在项目的 unpackage 目录下找到临时生成的鸿蒙工程目录，完成证书的申请。

5）配置签名证书，将鸿蒙工程的build-profile.json5复制到harmony-configs。

6）选择运行设备，点击运行到鸿蒙。


### 工程目录
```
│  
├─harmony-configs				// 存放鸿蒙项目配置文件，包括build-profile.json5，app.json5，证书等。由uniapp框架自动生成。
│      build-profile.json5      // uniapp项目首次运行到鸿蒙后，生成的鸿蒙工程的配置文件，完成证书申请后手动复制到harmony-configs文件夹下
│      
├─pages/index
│      index.vue            	// uniapp项目页面文件
│      
├─static
│      logo.png          		// 静态资源
│      
├─manifest.json      			// uniapp项目配置文件
│      
├─pages.json      				// uniapp项目页面配置
│      
├─uni_modules					// uni_modules插件目录
│	├─test-relationalStore      /
│   	package.json			// uni插件的配置文件
│ 		├─utssdk				
│			interface.uts		// 定义uni插件对外保留的接口文件
│			├─app-harmony		
│				index.uts		// uni插件接口的内部实现，包含数据库的创建和增删改查等操作
│			
│ 
│      
``` 
 
### 约束与限制
uniapp项目的路径不要太深，如果项目路径过长会导致编译失败，建议将项目放在盘符根目录下。也不要包含中文、空格和其它特殊字符。

### 参考文档
+ [relationalStore关系型数据库开发指南](https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V13/js-apis-data-relationalstore-V13)
+ [uniapp鸿蒙项目运行](https://uniapp.dcloud.net.cn/tutorial/harmony/runbuild.html)
+ [调用鸿蒙原生API](https://uniapp.dcloud.net.cn/tutorial/harmony/native-api.html)

## 一份简单的问卷反馈

亲爱的Harmony Next开发者，您好！<br>
为了协助您高效开发，提高鸿蒙场景化示例的质量，希望您在浏览或使用后抽空填写一份简单的问卷，我们将会收集您的宝贵意见进行优化:heart:

[:arrow_right: **点击此处填写问卷** ](https://wj.qq.com/s2/19042938/95ab/)

<div style="text-align: left;">