目录
[1 -> 工作原理](#1 -> 工作原理)
[2 -> 约束与限制](#2 -> 约束与限制)
[2.1 -> 支持的设备](#2.1 -> 支持的设备)
[2.2 -> 支持的国家/地区](#2.2 -> 支持的国家/地区)
[2.3 -> 支持的签名方式](#2.3 -> 支持的签名方式)
[3 -> 总结](#3 -> 总结)
[3.1 -> 关键功能与工具](#3.1 -> 关键功能与工具)
[3.2 -> 开发流程](#3.2 -> 开发流程)
[3.3 -> 典型场景与优化](#3.3 -> 典型场景与优化)
[3.4 -> 常见问题与解决](#3.4 -> 常见问题与解决)
[3.5 -> 总结](#3.5 -> 总结)

1 -> 工作原理
DevEco Studio支持开发者在本地完成云侧服务资源的开发与部署,并可在端侧工程中调用您开发的云侧代码,真正实现端云一体化开发。
1. 选择合适的云开发模板,根据工程向导创建端云一体化开发工程。
2. 分别进行云侧工程与端侧工程的代码开发与调试。
说明
云侧与端侧工程的代码可并行开发,一般无先后顺序。但若需在端侧代码中调用云侧代码,云侧代码必须先部署到AGC云端,因此建议您先完成云侧代码的开发、调试与部署,再进行端侧代码开发与调试。
1. 开发云侧工程:在云侧工程开发Cloud Foundation Kit提供的云端服务,目前包括云函数、云对象和云数据库资源开发。
- 开发云数据库:在DevEco Studio中创建对象类型、在对象类型中添加数据条目、部署云数据库到AGC云端。
- 开发云对象:在DevEco Studio中创建云对象、开发云对象代码、调试云对象、部署云对象到AGC云端。
- 开发云函数:在DevEco Studio中创建并配置函数、开发函数代码、调试函数、部署函数到AGC云端。
2. 部署云侧工程:云侧工程代码全部开发调试完毕后,一键部署云侧工程到AGC云端。
3. 开发端侧工程:在端侧工程下开发您应用的业务代码。本文档仅描述如何在端侧调用您开发的云侧代码,包括调用云函数、调用云对象、访问云数据库、调用云存储。
4. 端云两侧工程代码全部开发完成后,将端云一体化工程打包成APP,提交至AGC申请上架。

2 -> 约束与限制
2.1 -> 支持的设备
仅支持手机,且不支持使用模拟器运行调试。
2.2 -> 支持的国家/地区
当前仅在中国境内(不包含中国香港、中国澳门、中国台湾)提供服务。
2.3 -> 支持的签名方式
当前仅支持手动签名。
3 -> 总结
3.1 -> 关键功能与工具
-
华为云服务集成
-
云数据库(Cloud DB):直接在DevEco Studio中配置云数据库模型,支持本地与云端数据实时同步。
// 示例:初始化Cloud DB CloudDBZoneConfig config = new CloudDBZoneConfig("MyDBZone"); AGConnectCloudDB.initialize(context).createCloudDBZone(config);
-
云函数(Cloud Function) :通过
@CloudFunction
注解快速部署后端逻辑,支持事件驱动。 -
认证服务(Auth Service):集成华为帐号、手机号、第三方登录,一键配置用户体系。
-
-
前后端协同开发
-
API Mock:本地模拟云端接口响应,支持前后端并行开发。
-
分布式调试:实时查看设备端与云端的日志和网络请求。
-
-
数据安全与同步
-
端云数据加密:默认启用HTTPS传输,支持字段级加密。
-
冲突解决策略:基于时间戳或自定义规则解决多端数据冲突。
-
3.2 -> 开发流程
1. 环境配置
-
步骤1:安装DevEco Studio 3.0+,登录华为开发者帐号。
-
步骤2:在AGC(AppGallery Connect)控制台创建项目并启用云服务。
-
步骤3 :通过
agconnect-services.json
将云端配置同步至本地工程。
2. 云端资源定义
-
定义云数据库模型:
// CloudDB模型示例
{
"objects": [{
"name": "User",
"fields": [
{"name": "userId", "type": "String", "isPrimaryKey": true},
{"name": "name", "type": "String"}
]
}]
} -
配置云函数触发器:如用户注册后自动发送邮件。
3. 设备端开发
-
数据操作:
// 插入数据到Cloud DB
CloudDBZone zone = AGConnectCloudDB.getInstance().openCloudDBZone(config);
User user = new User("001", "Alice");
zone.executeUpsert(user); -
调用云函数:
CloudFunction.call("sendNotification", params)
.addOnSuccessListener(result -> { /* 处理成功 / })
.addOnFailureListener(e -> { / 处理失败 */ });
4. 调试与发布
-
本地模拟器测试:使用DevEco Studio内置模拟器验证端云交互。
-
真机联调:通过HiLog输出云端请求详情。
-
一键发布:同步打包设备端应用与云端资源配置。
3.3 -> 典型场景与优化
1. 场景案例:实时协作笔记
-
设备端:用户通过HarmonyOS平板编辑笔记,实时同步至云端。
-
云端:触发云函数生成协作链接,并推送通知至其他设备。
-
数据流:设备端 → Cloud DB → 云函数 → 推送服务 → 其他设备。
2. 性能优化策略
-
缓存机制:本地SQLite缓存高频查询数据。
-
分页加载 :使用
LazyColumn
实现云端数据分页加载。 -
带宽优化:启用数据压缩(如Protocol Buffers)。
3.4 -> 常见问题与解决
1. 数据同步延迟
-
排查:检查网络状态与Cloud DB分区配置。
-
方案:启用离线优先模式,网络恢复后自动同步。
2. 云函数超时
- 优化:拆分复杂逻辑为多个云函数,设置超时阈值(默认3秒)。
3. 权限不足
- 配置:在AGC控制台为云数据库设置精细化的读写权限。
3.5 -> 总结
通过DevEco Studio的端云一体化开发能力,开发者可快速构建具备分布式特性的智能应用。其核心优势在于:
-
高效协同:统一环境管理前后端代码,减少工具切换。
-
安全可靠:内置华为云服务保障数据安全。
-
灵活扩展:支持自定义云函数与第三方服务集成。
感谢各位大佬支持!!!
互三啦!!!