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

关联云开发资源

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包管理器进行工程迁移。

在这里插入图片描述