关于作者
白晓明
宁夏图尔科技有限公司董事长兼CEO、坚果派联合创始人
华为HDE、润和软件HiHope社区专家、鸿蒙KOL、仓颉KOL
华为开发者学堂/51CTO学堂/CSDN学堂认证讲师
开放原子开源基金会2023开源贡献之星
「目录」
「一」HarmonyOS端云一体化概要
「二」体验HarmonyOS端云一体化开发模板——创建端云一体化工程
「三」体验HarmonyOS端云一体化开发模板——使用DevEco Studio直接创建端云一体化工程
「四」体验HarmonyOS端云一体化开发模板——工程目录结构与云侧工程一键部署AGC云端
「五」体验HarmonyOS端云一体化开发模板——配置手动签名
「六」体验HarmonyOS端云一体化开发模板——本地真机运行应用
1 前置条件
-
实名认证的华为开发者账号
-
安装DevEco Studio 5.0.0 Release及以上版本
2 创建端云一体化开发工程
端云一体化开发工程创建方式有两种,一种是先在AGC平台创建HarmonyOS应用/元服务,然后使用DevEco Studio的通用云开发模板创建HarmonyOS应用/元服务并关联云开发资源;另一种是使用DevEco Studio的通用云开发模板创建HarmonyOS应用/元服务工程,在关联云资源时根据提示在AGC平台创建HarmonyOS应用/元服务,然后再关联云开发资源。
2.1 AGC平台创建HarmonyOS应用/元服务
1)步骤一:登录AGC平台,点击“证书、APP ID和Profile”。
2)步骤二:在左侧导航栏选择“证书、APP ID和Profile > APP ID”,进入“APP ID”页面,点击右上角“新建”。
3)步骤三:进入“设置应用开发基础信息”页面,填写应用基础信息,完成后点击“下一步”。
参数 | 说明 |
---|---|
应用类型 | 确定需要创建的应用形态:HarmonyOS应用或元服务。 |
应用名称 | 应用/元服务在应用应用市场展示的名称。 |
应用包名 | 仅当应用类型为HarmonyOS应用时,才需要在此处手动填写包名;元服务包名会在元服务创建成功后自动生成。 |
应用分类 | 普通应用或游戏类应用,设置后不支持修改,请慎重选择。 |
4)步骤四:在“开放能力接入”页面,为应用/元服务选择所属的项目,若将应用/元服务添加到已有项目,点击下拉框进行选择。若为新项目,则直接在输入框中填写新项目名称即可。完成后点击“确定”,应用/元服务即成功创建。
5)步骤五:(可选)若应用/元服务需要使用华为账号、导航服务等开放能力,则必须在AGC平台打开对应能力的开关。在“开放能力”栏搜索需要接入的开放能力,打开该能力所在行的开关,点击“确认”即可。
6)步骤六:返回“APP ID”页面,可查看已创建的APP ID、应用名称与包名信息。
2.2 DevEco Studio创建端云一体化开发工程
1)步骤一:选择一种方式,打开工程创建向导界面。
- 如果当前未打开任何工程,点击DevEco Studio欢迎页中的“Create Project”打开工程创建向导界面。
- 如果已经打开了工程,可以在菜单栏选择“File > New > Create Project”打开工程创建向导界面。
2)步骤二:在选择模板界面,在“Application/Atomic Service”页签,选择通用云开发模板([CloudDev]Empty Ability),然后点击“Next”。
3)步骤三:在工程配置界面,配置工程的基本信息。配置完成后,点击“Next”,开始关联云开发资源。
参数 | 说明 |
---|---|
Project name | 工程的名称,由大小写字母、数字和下划线组成。 |
Bundle name | 软件包名称,需保证唯一,且需与AGC创建HarmonyOS应用的“应用包名”一致。 |
Save location | 工程文件本地存储路径,由大小写字母、数字和下划线等组成,不能包含中文字符。 |
Compatible SDK | 兼容的最低API Version。 |
Module name | 模块名称。 |
Device type | 该工程模板支持的设备类型,目前仅支持手机设备。 |
Enable CloudDev | 是否启用云开发。通用云开发模板默认启用且无法修改。 |
4)步骤四:为工程关联云开发所需的资源,通俗来说就是将DevEco Studio创建的HarmonyOS应用/元服务与AGC平台创建的应用关联起来。
- 若当前在DevEco Studio未登录账号,点击关联云开发资源界面的“Sign in”。
在浏览器弹出的账号登录页面,使用已实名认证的华为开发者账号完成登录。
在“DevEco Studio想要访问您的华为账号”授权界面点击“允许”按钮同意DevEco Studio使用当前账号登录,当然,你也可以点击页面中的“切换账号”按钮切换其他账号。
- 账号登录成功后,DevEco Studio创建工程向导中关联云开发资源界面将展示账号昵称,同时会显示当前账号下的组织信息,以及系统根据工程Bundle name在该团队中自动查询AGC平台的同包名应用。
- 如果查询到的应用所属项目尚未启用数据处理位置,需要点击界面提示内的“AppGallery Connect”设置数据处理位置。
在浏览器弹出的数据处理位置页签中,点击“管理”按钮,为应用所属项目设置数据处理位置。
云开发目前仅支持中国站点,因此,必须启用中国站点的数据处理位置,同时设置默认数据处理位置。然后点击“保存”按钮,保存数据处理位置设置。
返回DevEco Studio创建工程向导关联云开发资源界面,此时,界面中的提示信息消失。点击“Finish”按钮,等待工程初始化完成。