HarmonyOS开发实战知识：端云一体化开发工程

最新推荐文章于 2024-08-20 16:55:29 发布

代码中的爱码士

最新推荐文章于 2024-08-20 16:55:29 发布

阅读量1k

点赞数 30

分类专栏： HarmonyOS 鸿蒙鸿蒙学习文章标签： harmonyos 华为鸿蒙学习驱动开发 android 鸿蒙系统

本文链接：https://blog.csdn.net/maniu110/article/details/140217137

版权

HarmonyOS 同时被 3 个专栏收录

46 篇文章 0 订阅

订阅专栏

鸿蒙

46 篇文章 0 订阅

订阅专栏

鸿蒙学习

46 篇文章 0 订阅

订阅专栏

云开发工程模板

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”，开始关联云开发资源。

关联云开发资源

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 NEXT）学习路径和一些资料的整理供小伙伴学习

点击领取→纯血鸿蒙Next全套最新学习资料希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取~~

一、鸿蒙（HarmonyOS NEXT）最新学习路线

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）…等技术知识点。

获取以上完整版高清，请点击→纯血版全套鸿蒙HarmonyOS学习资料

二、HarmonyOS Next 最新全套视频教程