云开发工程模板
DevEco Studio目前提供了两种云开发工程模板:通用云开发模板和商城模板。您可根据工程向导轻松创建端云一体化开发工程,并自动生成对应的代码和资源模板。在创建端云一体化开发工程前,请提前了解云开发工程模板的相关信息。
需要注意的是,在您体验使用云开发模板创建的应用前,需前往AGC控制台启用手机号码认证并使用手机号码登录应用。
新建HarmonyOS应用工程
前提条件
- 您已使用已实名认证的华为开发者帐号登录DevEco Studio。
- 请确保您的华为开发者帐号余额充足,账户欠费将导致云存储服务开通失败。
选择云开发模板
1.选择以下任一种方式,打开工程创建向导界面。如果当前未打开任何工程,可以在DevEco Studio的欢迎页点击"Create Project"开始创建一个新工程。如果已经打开了工程,可以在菜单栏选择"File > New > Create Project"来创建一个新工程。
2.在"Application"页签,选择需要的云开发模板(下文以商城模板为例),然后点击"Next"。
NOTE
使用商城模板,请先点击"Template Market"进入模板市场进行下载,下载成功后即可在"Application"页签选择到该模板。
配置工程信息
1.在工程配置界面,配置工程的基本信息。
2.点击"Next",开始关联云开发资源。
关联云开发资源
为工程关联云开发所需的资源,即在DevEco Studio中选择您的华为开发者帐号加入的开发者团队,将该团队在AGC的同包名应用关联到当前工程。具体操作如下:
1.(可选)如您尚未登录DevEco Studio,点击"Sign in",在弹出的帐号登录页面,使用已实名认证的华为开发者帐号完成登录。
登录成功后,界面将展示帐号昵称。
2.点击"Team"下拉框,选择开发团队。
NOTICE
团队帐号持有者需为团队完成实名认证。
3.关联应用。
选中团队后,系统根据工程包名在该团队中自动查询AGC上的同包名应用。
- 如查询到应用,选中该应用,点击"Finish"即可。
- 如查询到的应用尚未关联任何项目,则无法选中。请先将应用添加到您的项目下。
- 如果查询到的应用所属项目尚未启用数据处理位置,请点击界面提示内的"AppGallery Connect"设置数据处理位置。
NOTICE
由于云开发目前仅支持中国站点,请确保项目启用的数据处理位置包含中国站点。
无论项目启用的默认数据处理位置为哪个站点,后续开发的云服务资源都将部署在中国站点。
- 如在当前团队中未查询到同包名应用,请先确认填写的包名是否有误。
- 如包名有误,点击界面提示中的"go back"返回工程信息配置界面进行修改。
- 如包名无误,则表明当前团队尚未在AGC控制台创建与当前工程包名相同的应用。您可点击界面提示中的"AppGallery
Connect",前往AGC控制台创建同包名应用。
完成以上操作后,DevEco Studio即可获取到同包名应用信息。选中应用后,点击"Finish"。
4.如您所属的团队尚未签署云开发相关协议,点击协议链接仔细阅读协议内容后,勾选同意协议,点击"Finish",进入主开发界面。
NOTE
只有帐号持有者和法务角色才有权限签署协议。
5.在主开发界面,可查看刚刚新建的工程。关于工程的详细目录结构介绍,请参见端云一体化开发工程介绍。
新建元服务工程
前提条件
- 您已使用已实名认证的华为开发者帐号登录DevEco Studio。
- 请确保您的华为开发者帐号余额充足,账户欠费将导致云存储服务开通失败。
选择云开发模板
1.选择以下任一种方式,打开工程创建向导界面。
- 如果当前未打开任何工程,可以在DevEco Studio的欢迎页点击"Create Project"开始创建一个新工程。
- 如果已经打开了工程,可以在菜单栏选择"File > New > Create Project"来创建一个新工程。
2.点击"Atomic Service"页签,选择预置的通用云开发模板,然后点击"Next"。
NOTE
元服务工程暂不支持选择商城模板。
元服务调试、运行时,在设备桌面上没有应用图标,请使用DevEco Studio的调试和运行功能,来启动元服务。
元服务是免安装的,Stage模型中在module.json5文件自动添加"installationFree"字段,取值为"true";在app.json5文件自动添加"bundleType"字段,取值为 "atomicService"。
编译构建APP时,每个HAP大小不能超过10MB。
配置工程信息
1.在工程配置界面,配置工程的基本信息。
2.点击"Next",开始关联云开发资源。
关联云开发资源
为工程关联云开发所需的资源,即在DevEco Studio中选择您的华为开发者帐号加入的开发者团队,将该团队在AGC的同包名应用关联到当前工程。具体操作如下:
1.(可选)如您尚未登录DevEco Studio,点击"Sign in",在弹出的帐号登录页面,使用已实名认证的华为开发者帐号完成登录。
登录成功后,界面将展示帐号昵称。
2.点击"Team"下拉框,选择开发团队。
NOTICE
团队帐号持有者需为团队完成实名认证。
3.关联应用。
选中团队后,系统根据工程包名在该团队中自动查询AGC上的同包名应用。
- 如查询到应用,选中该应用,点击"Finish"即可。
- 如查询到的应用尚未关联任何项目,则无法选中。请先将应用添加到您的项目下。
- 如果查询到的应用所属项目尚未启用数据处理位置,请点击界面提示内的"AppGallery Connect"设置数据处理位置。
NOTICE
由于云开发目前仅支持中国站点,请确保项目启用的数据处理位置包含中国站点。
无论项目启用的默认数据处理位置为哪个站点,后续开发的云服务资源都将部署在中国站点。
- 如在当前团队中未查询到同包名应用,请先确认填写的包名是否有误。
- 如包名有误,点击界面提示中的"go back"返回工程信息配置界面进行修改。
- 如包名无误,则表明当前团队尚未在AGC控制台创建与当前工程包名相同的应用。您可点击界面提示中的"AppGallery
Connect",前往AGC控制台创建同包名应用。
完成以上操作后,DevEco Studio即可获取到同包名应用信息。选中应用后,点击"Finish"。
4.如您所属的团队尚未签署云开发相关协议,点击协议链接仔细阅读协议内容后,勾选同意协议,点击"Finish",进入主开发界面。
NOTE
只有帐号持有者和法务角色才有权限签署协议。
5.在主开发界面,可查看刚刚新建的工程。关于工程的详细目录结构介绍,请参见端云一体化开发工程介绍。
工程初始化配置
当您成功创建工程并关联云开发资源后,DevEco Studio会为您的工程自动执行一些初始化配置。
自动开通云开发相关服务
DevEco Studio为工程关联的项目自动开通云开发相关服务:认证服务、云函数、云数据库、云托管、API网关、云存储。您可在"Notifications"窗口查看服务开通状态。
NOTE
如服务开通失败,您可随界面引导前往AGC控制台进行手动开通。
如云存储服务自动开通与手动开通均失败,可能是账户欠费导致。请您,后再前往AGC控制台进行手动开通。
端侧工程自动集成AGC SDK
DevEco Studio为端侧工程自动集成AGC相关云服务最新版本SDK。
- "entry/src/main/resources/rawfile/agconnect-services.json":AGC
SDK配置文件,内含client_secret和api_key,请妥善保管。
-
"entry/oh-package.json5":自动引入了AGC相关云服务(认证服务、云函数、云存储)最新版本SDK,同时会自动集成端云一体化登录组件的最新SDK。
工程同步成功后可以看到当前从ohpm仓获取的最新版本。
云侧工程自动集成云数据库SDK
DevEco Studio为云侧工程自动集成云数据库最新版本Node.js Server SDK。
"cloudfunctions/函数目录名 (如下图idgenerator)/package.json":自动引入云数据库最新版本的Node.js Server SDK。
端云一体化开发工程介绍
端云一体化开发工程目录分为三个子工程:端开发工程(Application)、云开发工程(CloudProgram)、端侧公共库(External Libraries)。
端开发工程(Application)
端开发工程主要用于开发应用端侧的业务代码,端开发工程目录结构请参见工程介绍。
NOTICE
使用DevEco Studio 3.1 Beta1创建的工程采用的是npm包管理,而使用DevEco Studio 3.1 Release新建工程将使用ohpm作为默认包管理器。因此,在您升级到DevEco Studio 3.1 Release版本后,打开历史工程可能会出现兼容性问题,您需参考OHPM包管理器进行工程迁移。
云开发工程(CloudProgram)
在云开发工程中,您可为您的应用开发云函数和云数据库服务资源。云开发工程目录结构如下图所示:
- clouddb:云数据库工程目录。
- dataentry:用于存放数据条目文件。
NOTE
使用通用云开发模板创建的工程会默认生成post_data数据条目文件,使用商城模板创建的云开发工程则会默认生成sku(商品基本属性)、spu(商品扩展属性)以及spu_attr(商品规格属性)数据条目文件。您可按需修改。
- objecttype:用于存放对象类型文件。
NOTE
使用通用云开发模板创建的工程会默认生成post对象类型文件,使用商城模板创建的云开发工程会默认生成order(订单)、shopcart(购物车)等多个对象类型文件。您可按需修改。
- db-config.json:模块配置文件,主要包含云数据库工程的配置信息,如默认存储区名称、默认数据处理位置。
- cloudfunctions:云函数工程目录。
NOTE
使用通用云开发模板创建的工程默认自动创建一个示例函数"idgenerator",使用商城模板创建的云开发工程会默认生成mall-address(地址)、mall-commodity(商品)等多个函数。您可按需修改。
- node_modules:包含了所有第三方依赖。
- cloud-config.json:云开发工程配置文件,包含应用名称与ID、项目名称与ID、启用的数据处理位置、支持的设备类型等。
- package.json:定义了TypeScript公共依赖。
- package-lock.json:记录当前状态下实际安装的各个npm package的具体来源和版本号。
端侧公共库(External Libraries)
端侧公共库中包含了JDK的扩展类库。
那么要想成为一名鸿蒙高级开发,以上知识点是必须要掌握的,除此之外,还需要掌握一些鸿蒙应用开发相关的一些技术,需要我们共同去探索。
为了能够让大家跟上互联网时代的技术迭代,在这里我特邀了几位行业大佬 整理出一份最新版的鸿蒙学习提升资料,有需要的小伙伴自行领取,限时开源,先到先得~~~~
领取以下高清学习路线原图请点击→《鸿蒙基础入门学习指南》纯血鸿蒙HarmonyOS基础技能学习路线图
领取以上完整高清学习路线图,请点击→《鸿蒙全套学习指南》小编自己整理的部分学习资料(包含有高清视频、开发文档、电子书籍等)
以上分享的学习路线都适合哪些人跟着学习?
-应届生/计算机专业通过学习鸿蒙新兴技术,入行互联网,未来高起点就业。
-0基础转行提前布局新方向,抓住风口,自我提升,获得更多就业机会。
-技术提升/进阶跳槽发展瓶颈期,提升职场竞争力,快速掌握鸿蒙技术,享受蓝海红利。
最后
鸿蒙开发学习是一个系统化的过程,从基础知识的学习到实战技能的锤炼 ,再到对前沿技术的探索,每一环节都至关重要。希望这份教程资料能帮助您快速入门并在鸿蒙开发之路上步步攀升,成就一番事业。让我们一起乘风破浪,拥抱鸿蒙生态的广阔未来!
如果你觉得这篇内容对你有帮助,我想麻烦大家动动小手给我:点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
关注我,同时可以期待后续文章ing,不定期分享原创知识。
想要获取更多完整鸿蒙最新VIP学习资料,请点击→《鸿蒙 (Harmony OS)开发学习手册》