# ArkTS 应用多线程开发实践案例
### 介绍
#### 使用TaskPool进行频繁数据库操作
对于需要频繁数据库操作的场景，由于读写数据库存在耗时，因此推荐在子线程中操作，避免阻塞UI线程。
通过ArkTS提供的TaskPool能力，可以将数据库操作任务移到子线程中。
#### 使用Sendable进行大容量数据库操作
由于数据库数据跨线程传递存在耗时，数据量较大时会占用UI主线程。推荐使用Sendable封装数据库数据，以降低跨线程开销。
#### 复杂类实例对象使用Sendable进行大容量数据库操作
普通类实例对象的属性可持有Sendable类实例对象。
对于复杂的普通类实例对象，可以先将相应数据库数据字段封装为Sendable类实例对象，再由普通类实例对象持有，从而降低跨线程开销。
#### 业务模块并发加载场景
在应用启动过程中，会有多个业务模块需要加载，例如应用的定位、打车、导航等不同的模块，如果全部在UI主线程初始化，则会严重影响冷启动耗时。此时需要在不同子线程并行化加载这些模块功能，降低启动耗时。
通过使用ArkTS提供的TaskPool能力，可以将不同业务初始化任务移到子线程中，业务模块通过下沉C++实现成[NativeBinding对象](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/arkts-utils/transferabled-object.md)、或者在ArkTS层定义[Sendable对象](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/arkts-utils/arkts-sendable.md)，就可以将初始化的模块返回UI主线程调用，实现如下。
#### 全局配置项功能场景
对于需要使用进程单例的场景，例如不同并发实例间需要数据保持一致的全局配置项业务，可以采用共享模块来实现。
#### ArkUI数据更新场景
当需要网络下载或者本地生成的数据需要发送到UI线程进行展示时，因为ArkUI的标注和[@Sendable装饰器](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/arkts-utils/arkts-sendable.md#sendable装饰器)不能同时修饰变量和对象，所以对于此类场景，需要使用[makeObserved](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/state-management/arkts-new-makeObserved.md)在ArkUI中导入可观察的Sendable共享数据。
#### ArkUI瀑布流渲染场景
此处提供使用任务池[TaskPool](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-arkts/js-apis-taskpool.md)提升[WaterFlow瀑布流](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-waterflow.md)渲染性能的开发指导。UI线程查询数据库数据，并将数据渲染到瀑布流组件，数据过大时会导致UI线程长时间等待，影响用户体验。因此，可以将数据查询操作放到子线程中，并通过TaskPool的接口返回数据给UI线程。
该工程中展示的代码详细描述可查如下链接：
- [批量数据写数据库场景](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/arkts-utils/batch-database-operations-guide.md)
- [业务模块并发加载场景](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/arkts-utils/concurrent-loading-modules-guide.md)
- [全局配置项功能场景](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/arkts-utils/global-configuration-guide.md)
- [ArkUI数据更新场景](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/arkts-utils/makeobserved-sendable.md)
- [ArkUI瀑布流渲染场景](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/arkts-utils/taskpool-waterflow.md)
### 效果预览
| 首页 | 执行及结果 |
| :----------------------------------------------------------------: | :----------------------------------------------------------------: |
| 
| 
|
### 使用说明
1. 在主界面中，点击任意功能按钮可跳转至相应页面，随后点击界面显示的文本字符串即可触发程序执行或滑动页面（WaterFlow）。
2. 执行结果会即时反馈在屏幕中央,并在控制台打印log。
### 工程目录
```
entry/src/
├── main
│ ├── ets
│ │ ├── entryability
│ │ ├── entrybackupability
│ │ ├── managers
│ │ ├── ComplexClassInstanceObjectUsingSendable.ets // 复杂类实例对象使用Sendable进行大容量数据库操作
│ │ ├── ConcurrentLoadingModulesGuide.ets // 业务模块并发加载场景示例代码
│ │ ├── Config.ets // 全局配置项功能场景资源代码
│ │ ├── GlobalConfigurationGuide.ets // 全局配置项功能场景示例代码
│ │ ├── MakeobservedSendable.ets // ArkUI数据更新场景示例代码
│ │ ├── Mock.ets // ArkUI瀑布流渲染场景资源代码
│ │ ├── SendableData.ets // ArkUI数据更新场景资源代码
│ │ ├── SharedValuesBucket.ets // 使用Sendable进行大容量数据库操作
│ │ ├── UsingSendable.ets // 使用Sendable进行大容量数据库操作示例代码
│ │ ├── UsingTaskPool.ets // 使用TaskPool进行频繁数据库操作示例代码
│ │ ├── WaterfallRendering.ets // ArkUI瀑布流渲染场景示例代码资源代码
│ │ ├── WaterFlowDataSource.ets // ArkUI瀑布流渲染场景资源代码
│ │ ├── pages
│ │ ├── Index.ets // 首页
│ │ ├── sdk
│ │ ├── Calculator.ets // 业务模块并发加载场景资源代码
│ │ ├── TimerSdk.ets // 业务模块并发加载场景资源代码
│ │ ├── util
│ │ ├── CommonButton.ets // 首页跳转UI
│ │ ├── resource.ets // 资源引用转换
│ ├── module.json5
│ └── resources
├── ohosTest
│ ├── ets
│ │ ├── test
│ │ ├── Ability.test.ets // 自动化测试代码
```
### 相关权限
不涉及。
### 依赖
不涉及。
### 约束与限制
1.本示例仅支持标准系统上运行, 支持设备：RK3568。
2.本示例为Stage模型，支持API20版本SDK，版本号：6.0.0.40，镜像版本号：OpenHarmony_6.0.0.40。
3.本示例需要使用DevEco Studio 5.1.1 Release (Build Version: 5.1.1.820, built on June 28, 2025)及以上版本才可编译运行。
### 下载
如需单独下载本工程，执行如下命令：
```
git init
git config core.sparsecheckout true
echo code/DocsSample/ArkTS/ArkTsConcurrent/ApplicationMultithreadingDevelopment/PracticalCases > .git/info/sparse-checkout
git remote add origin https://gitcode.com/openharmony/applications_app_samples.git
git pull origin master
```