ArkTS 应用多线程开发实践案例
介绍
使用TaskPool进行频繁数据库操作
对于需要频繁数据库操作的场景，由于读写数据库存在耗时，因此推荐在子线程中操作，避免阻塞UI线程。
通过ArkTS提供的TaskPool能力，可以将数据库操作任务移到子线程中。
使用Sendable进行大容量数据库操作
由于数据库数据跨线程传递存在耗时，数据量较大时会占用UI主线程。推荐使用Sendable封装数据库数据，以降低跨线程开销。
复杂类实例对象使用Sendable进行大容量数据库操作
普通类实例对象的属性可持有Sendable类实例对象。
对于复杂的普通类实例对象，可以先将相应数据库数据字段封装为Sendable类实例对象，再由普通类实例对象持有，从而降低跨线程开销。
业务模块并发加载场景
在应用启动过程中，会有多个业务模块需要加载，例如应用的定位、打车、导航等不同的模块，如果全部在UI主线程初始化，则会严重影响冷启动耗时。此时需要在不同子线程并行化加载这些模块功能，降低启动耗时。
通过使用ArkTS提供的TaskPool能力，可以将不同业务初始化任务移到子线程中，业务模块通过下沉C++实现成NativeBinding对象、或者在ArkTS层定义Sendable对象，就可以将初始化的模块返回UI主线程调用，实现如下。
全局配置项功能场景
对于需要使用进程单例的场景，例如不同并发实例间需要数据保持一致的全局配置项业务，可以采用共享模块来实现。
ArkUI数据更新场景
当需要网络下载或者本地生成的数据需要发送到UI线程进行展示时，因为ArkUI的标注和@Sendable装饰器不能同时修饰变量和对象，所以对于此类场景，需要使用makeObserved在ArkUI中导入可观察的Sendable共享数据。
ArkUI瀑布流渲染场景
此处提供使用任务池TaskPool提升WaterFlow瀑布流渲染性能的开发指导。UI线程查询数据库数据，并将数据渲染到瀑布流组件，数据过大时会导致UI线程长时间等待，影响用户体验。因此，可以将数据查询操作放到子线程中，并通过TaskPool的接口返回数据给UI线程。
该工程中展示的代码详细描述可查如下链接：
效果预览
| 首页 | 执行及结果 |
|---|---|
 |
 |
使用说明
- 在主界面中，点击任意功能按钮可跳转至相应页面，随后点击界面显示的文本字符串即可触发程序执行或滑动页面（WaterFlow）。
- 执行结果会即时反馈在屏幕中央,并在控制台打印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 ArkTS/ArkTsConcurrent/ApplicationMultithreadingDevelopment/PracticalCases > .git/info/sparse-checkout
git remote add origin https://gitcode.com/HarmonyOS_Samples/guide-snippets.git
git pull origin master