鸿蒙端云一体化开发通过DevEco Studio和Cloud Foundation Kit实现端云协同开发,大幅降低开发门槛和运维成本,为开发者提供开箱即用的云服务能力,是HarmonyOS生态的重要技术支柱。
一、端云一体化开发概述
端云一体化开发是HarmonyOS基于DevEco Studio,以Cloud Foundation Kit(云开发服务)为底座,实现端侧(应用/元服务)与云侧(云端服务)在同一工具内协同开发的创新模式。开发者通过云开发工程模板快速创建工程,同步完成两端代码开发、调试,并一键部署云侧工程至AGC云端,最终实现端云联动,聚焦业务逻辑、降本增效。
1.1 传统开发模式与端云一体化开发的对比
为了更清晰地理解端云一体化开发的优势,我们从以下几个关键维度进行对比分析:
| 区别点 | 传统开发模式 | 端云一体化开发模式 |
|---|---|---|
| 开发工具 | 端侧与云侧需各自工具,需自建服务器,成本高 | 仅需DevEco Studio,无需搭建服务器,成本低 |
| 开发人员 | 需不同语言技能,多人协作,沟通成本高、效率低 | 端侧开发者可开发云侧代码,门槛低,人力少 |
| 运维 | 需自建运维能力,成本高、负担重 | 接入Cloud Foundation Kit,免运维 |
从对比可以看出,端云一体化开发在工具统一性、人员协作效率和运维成本方面具有显著优势。
1.2 端云一体化开发核心原理
DevEco Studio目前提供通用云开发模板([CloudDev]Empty Ability),基于Cloud Foundation Kit搭建基础演示项目(无业务属性),可用于学习基础开发流程,后续可删除预置代码。端云一体化开发提供的场景化模板,包含预置代码和资源文件,通过工程向导即可快速创建开发工程。
核心原理包含两个关键部分:
-
端云一体化开发流程:在DevEco Studio内同步开发端侧业务代码与云侧服务代码,支持云侧工程一键部署至AGC云端。
-
Cloud Foundation Kit支撑:云侧工程接入该工具,可按需使用云函数、云数据库、云存储等服务,具备开箱即用、一键部署、自动弹性伸缩、免运维等特点。
二、端云一体化开发项目创建步骤

2.1 在AGC平台创建端云一体化开发应用
这是整个开发流程的第一步,也是最关键的一步,因为后续IDE创建项目需要和AGC平台创建好的应用进行绑定。
操作步骤:
1. 访问AGC平台:https://developer.huawei.com/consumer/cn/service/josp/agc/index.html
2. 登录华为账号后,点击进入AGC控制台
3. 按照界面指引新建项目
注意:此步骤非常重要,后续IDE创建项目,需要和AGC平台创建好的应用进行绑定。所以要先在AGC平台进行端云一体化开发应用的创建!
2.2 在IDE创建端云一体化开发模板项目
完成AGC平台的项目创建后,需要在DevEco Studio中创建对应的模板项目:
操作步骤:
1. 打开工程创建向导(欢迎页”Create Project”或菜单栏”File > New > Create Project”)
2. 在”Application”页签选择通用云开发模板([CloudDev]Empty Ability)
3. 点击”Next”
说明:这里以应用开发举例,元服务操作是类似的。
2.3 设置模板项目相关配置
在创建向导中设置项目配置,需要注意以下关键点:
配置要点:
– 模板项目只能选择手机设备类型
– 是否开启云开发,默认开启,不可修改
– 包名必须与AGC平台上创建的应用包名保持一致
– 其他常规配置按照实际需求设置
2.4 绑定本地项目和AGC项目
这是连接本地开发环境和云端服务的核心步骤:
操作流程:
1. 在向导界面会显示登录在IDE上的账号信息
2. 系统根据项目包名,自动匹配显示AGC平台上对应的项目应用信息
3. 确认绑定关系,完成本地项目与AGC项目的关联
提示:此步骤非常关键,是将本地开发与云端服务连接起来的桥梁。
2.5 数据处理位置配置
根据合规性要求,需要配置数据处理的地理位置:
配置要求:
– 项目必须启用中国站点(云服务资源默认部署至此)
– 可在AGC平台修改配置
– 端云一体化开发目前仅支持国内部署
操作方法:
1. 在IDE中点击配置提示的蓝字,跳转到AGC控制台
2. 在AGC控制台中针对数据处理位置进行勾选后保存
如果包名没有在AGC平台上进行配置,系统会显示相应的错误提示。
2.6 项目初始化完成
完成以上所有步骤后,项目创建成功,系统会自动执行以下初始化操作:
- 端侧依赖安装:执行”ohpm install”下载端侧依赖
- 云侧依赖安装:执行”npm install”下载云侧依赖
- DevEco Studio自动同步工程,确保端云两端环境配置完整
三、开发工具功能详解
DevEco Studio为端云一体化开发提供了便捷的管理工具,通过”Tools”菜单中的”CloudDev”选项,可以在IDE中非常方便地管理AGC平台上云开发项目的信息。
主要功能:
– 云开发项目管理
– 云服务配置管理
– 部署状态监控
– 日志查看与分析
四、DEMO运行效果与代码解析
鸿蒙端云一体化应用的主入口页面实现了一个导航菜单,用于展示和访问Cloud Foundation Kit提供的三大核心云服务:云函数、云数据库和云存储。
4.1 主入口页面代码结构
import { CloudDb } from './CloudDb/CloudDb'; // 导入云数据库功能组件
import { DbInsert } from './CloudDb/DbInsert'; // 导入数据库插入操作组件
import { CloudFunction } from './CloudFunction'; // 导入云函数功能组件
import { CloudStorage } from './CloudStorage'; // 导入云存储功能组件
4.2 核心组件设计
主入口组件采用以下架构设计:
- 导航管理:使用
@Provide('pathStack')提供路径栈管理,实现页面间的导航切换 - 路由映射:通过
@Builder pathMap()方法构建路由映射,根据路由名称渲染对应的云服务组件 - 按钮组件:
@Builder homeButton()方法创建统一样式的导航按钮,提供良好的用户体验
4.3 功能模块划分
应用包含以下四个主要功能模块:
- CloudFunction:云函数演示页面
- CloudDb:云数据库演示页面
- CloudStorage:云存储演示页面
- DbInsert:数据库插入操作页面
每个模块都通过独立的组件实现,便于后续的功能扩展和维护。


五、总结与展望
HarmonyOS端云一体化开发模式通过统一的开发工具、简化的部署流程和免运维的云服务,为开发者提供了全新的开发体验。本文详细介绍了端云一体化开发的基本概念、项目创建步骤和DEMO实现,为开发者入门提供了完整的指导。
在后续的文章中,我们将深入探讨各个云服务模块的具体实现、最佳实践以及性能优化策略,帮助开发者更好地掌握端云一体化开发技术,构建高质量的HarmonyOS应用。
关键字:HarmonyOS,端云一体化,Cloud Foundation Kit,DevEco Studio,云函数,云数据库,云存储,AGC,鸿蒙开发,移动开发
