目标
在鸿蒙原子化服务正式发布前,通过AGC(AppGallery Connect)平台提供的开放式测试方案进行灰度发布服务。
前置条件
注册华为开发者账号,并实名认证,若你还没注册,请先注册并实名;
你是华为受邀的开发者;
需要进行开放式测试的服务信息(APP ID及Developer ID)已提交至华为运维邮箱(agconnect@huawei.com)申请,并获得通过。
鸿蒙开放式测试
一、什么是HarmonyOS系统的开放式测试?
官方介绍:开放式测试,可以让您的应用在正式上架华为应用市场前,提前发布一个测试版本给您信任的测试用户。测试版本仅对您指定的测试用户可见,这样您就可以提前收到用户反馈,并在应用正式上架前改进您的应用。
简单来说:基于AGC(AppGallery Connect)应用上架前的限定用户内的测试版本。
说明:开放式测试当前支持Android应用和纯HarmonyOS应用。
二、开放式测试的工作原理
通过开放式测试服务提前配置测试用户,并在华为应用市场发布您的开放式测试版本。AGC会向您指定的测试用户发送邀请邮件或短信。测试用户点击邮件或短信中的邀请链接后接受邀请,即可从华为应用市场客户端下载您的测试应用进行相应的测试。
三、功能与特点
- 邀请指定用户测试应用
- 指定测试时间段
- 支持免人工审核
- 快速迭代
四、实战
4.1、构建原子化服务APP
1.1、创建原子化服务项目
创建原子化服务项目,比如项目名称为:MyNfc,首先打开DevEco Studio IDE,点击菜单 File->new->new project, 在创建项目弹窗中根据要求填写相关信息,项目名称:MyNfc,Project type选择Atomic service 原子化服务,点击“Finish”。
1.2、配置release认证
说明:本实战案例只是演示原子化服务的开放式测试流程,所以MyNfc暂时没有其他的业务内容,只有默认的MainAbility主页面,显示“Hello World”。
前置条件
开放式测试发布与正式发布是一样的,所以在发布之前必须有数字证书(.cer文件)和Profile文件。
简要说明
HarmonyOS应用/服务通过数字证书(.cer文件)和Profile文件(.p7b文件)来保证应用/服务的完整性,数字证书和Profile文件可通过申请发布证书和Profile文件获取。
File->Project Structure->Project->Signing Configs 中配置相关证书信息和文件。
1.3、构建App
点击菜单Build->Build APP(S),构建完成后可以在项目的build\outputs\app\release\下看到签名后的release app包。
帮你踩踩坑
问题1、原子化服务app包上传时会提示:“该软件包属于鸿蒙服务(免安装)类型,暂不支持开放式测试特性”
说明:众所周知鸿蒙原子化服务要求所有HAP包(包括Entry HAP和Feature HAP)均需满足免安装,所以在config.json的配置中可以看到,“installationFree”: true,但是鸿蒙提供的开放式测试目前只支持应用,也就是免安装的原子化服务app包上传时会提示错误,悲剧了,原子化服务无法使用此特性,怎么办?
解决方案:
在测试阶段可以修改免安装为需要安装,即在项目config.json的配置中修改"installationFree": false,这样就可以将原子化服务的app安装包上传成功了。
2、在AGC平台上创建项目与应用
说明:如果你还没有在AGC平台上创建应用,则需要先在AGC平台上先创建项目和应用,应用创建在项目下,具体的创建方法请参看官方文档:创建项目、创建应用
完成项目和应用的构建后可以在你的AGC平台上,我的项目页面 中查看到你创建的项目内容。
3、开放式测试
3.1、申请开放式测试
当前只有受邀开发者才能支持发布HarmonyOS系统的开放式测试版本,
如您需加入受邀名单,已实名开发者需发送邮件主题为“申请加入HarmonyOS应用的开放式测试”,将APP ID及Developer ID发送至agconnect@huawei.com进行申请。
如何查看APP ID及Developer ID?
官方文档:查询开发者帐号ID及项目ID
3.2、配置开放式测试
步骤1、在AGC平台上,点击我的应用菜单,选择你需要进行开放式测试的应用。
步骤 2、配置与上架
首先你的开放式测试申请需要通过才能进行,配置开放式测试包括:创建测试用户列表、上架开放式测试版本,两个流程官方文档都有详细的描述和步骤,这里就不做过多的描述。下面说下遇到的问题。
帮你踩踩坑
问题1、上传的APP包不能为原子化服务免安装APP,否则系统会提示:“该软件包属于鸿蒙服务(免安装)类型,暂不支持开放式测试特性”
解决方案:参看本文4.1.3中的问题1所提供的解决方案
问题2、应用上架无法通过,提示:“请使用发布版本的API开发应用申请上架”
问题分析:应用/服务通过IDE创建会自动配置,查看项目和module中的build.gradle文件,搜索 compileSdkVersion 字段,发现compileSdkVersion=7,目前鸿蒙版商用最高支持6,建议使用5,重现构建APP,再将新构建的APP包上传即可。
步骤3、提交审核
基础信息和版本信息填写完整后,可以提交审核,当审核通过就可以愉快的进入测试阶段。
4、测试
4.1、测试邀约请求
应用/服务上架(开放式测试)成功后,受邀请的测试用户会立刻收到测试版本的邀请链接,点击链接就可以参与测试,具体操作可以参看官方文档:用户参与开放式测试
值得一提的是,如果你邀请的测试用户没有收到邀请信息,可以通过查看测试用户详情中重新发起请求。
4.2、邀约测试用户确认加入测试
受邀的测试用户的邮箱或者手机短信会收到邀约信息,点击信息中的邀约链接即可加入到测试。