HarmonyOS端云体化开发—创建端云一体化开发工程

云开发工程模板

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)开发学习手册》