DevEco Studio端云协同开发云函数 原创 精华
1 端云一体化
之前本人在OpenHarmony/HarmonyOS应用程序中集成了AppGallery Connect中的认证服务做应用程序的登录入口,而HarmonyOS 3.1 Beta1更进一步提升了开发体验,依托AppGakkery Connect的Serverless云服务开放接口,通过DevEco Studio的云开发能力,开发者可以在创建工程时通过选择云开发模板,即可体验端云一体化协同开发,关于端云一体化详细介绍可参见端云一体化开发,这里关于概念性的不在赘述。
1.1 创建端云一体化示例应用
使用DevEco Studio创建端云一体化示例应用程序HelloCloud,选择模板为Empty Ability with CloudDev。
端云一体化需要关联云开发资源,需要在DevEco Studio中使用已实名认证的华为开发者账号登录。
登录完成后在Team下拉框中选择开发团队,若提示以下错误信息,则说明未在AppGallery Connect中创建对应的应用,因此需要先去AppGallery Connect中创建对应的应用。点击错误信息中的AppGallery Connect链接跳转到创建应用界面。
首先添加一个项目,然后添加一个应用,配置如下:
在AppGallery Connect中创建应用完成后,回到DevEco Studio创建工程向导,工程向导会自动查询该组织下,包名下的云端相匹配的应用信息。
HelloCloud工程创建完成后,在主界面Project页签中会显示详细工程目录,包括端开发工程(Application)、云开发工程(CloudProgram)、端侧公共库(External Libraries)。
- 端开发工程主要用于开发应用端侧业务代码;
- 云开发工程主要用于为端侧应用用到的云函数、云数据库等。
- clouddb:云数据库工程目录
- cloudfunctions:云函数工程目录
创建端云一体化应用程序并关联云开发资源后,DevEco Studio会自动初始化配置并开启云开发相关服务,如认证服务、云函数、云数据库、云托管、API网关。服务开通状态可在Event Log窗口查看,也可以在AppGallery Connect控制台查看。
相较于我之前发布的集成AppGallery Connect认证服务实现登录而言,端云一体化开发更加便捷,创建应用完成后会端侧应用自动集成agconnect-services.json配置文件以及相关云服务最新版本HarmonyOS SDK,云端自动集成云数据库SDK。
1.2 端云一体化开发体验
使用端云一体化开发,可以让团队协同开发更简单,同时可以更大程度节省企业开发成本。接下来以云函数为例,更多请参见官网。
1.2.1 创建云函数
打开云端工程,在cloudfunctions
目录右键选择New --> Cloud Function
,输入云函数名称,自动生成ts文件。
云函数创建完成后需要在function-config.json
函数配置文件中配置触发器(会自动完成HTTP触发器配置),当前可配置HTTP、CLOUDDB、AUTH、CLOUDSTORAGE、CRON五种触发器,每种触发器配置规则不同。HTTP触发器属性如下所示:
参数 | 说明 |
---|---|
type | 触发器类型,配置为"http" |
enableUriDecode | 触发器是否启用decode。 true:启用; false:不启用。 |
authFlag | 是否鉴权,默认为true。 |
authAlgor | 鉴权算法,默认为HDA-System。 |
authType | HTTP触发器的认证类型。 apigw-client:API客户端鉴权(Client)端适用。 cloudgw-client:API客户端鉴权(Server端适用)。 |
在函数入口文件addition-test.ts
中完善函数业务逻辑。
1.2.2 部署函数
完善函数代码之后,可以将函数部署到AppGallery Connect控制台,支持单个部署和批量部署。其中单个部署选中具体需要部署的函数,批量部署则选中cloudfunctions
目录,右键选择Deploy Function
进行部署。
部署完成后,可在AppGallery Connect控制台中云函数服务页面查看。
1.2.3 编写运行测试示例
在ets/services
目录下编写云函数回调方法:
在ets/pages
目录下构建调用云函数页面:
注:需要更改EntryAbility.ts
中onWindowStageCreate()
方法中初始加载页面为pages/ArgAlg
。切记在调用云函数的时候,需要发布一个正式版本才能够响应。
感谢白老师手把手教学(视频讲解也很详细)
两点注意事项:
先下载,学一下模拟器的安装和启动
随着网络的发展端云一体会越来越普及
讲得太好了,简明扼要!