HarmonyOS鸿蒙Next中Testing API使用

HarmonyOS鸿蒙Next中Testing API使用使用Testing API来提交测试版本，成功后管理后台显示状态“正在等待审核”，查看API文档里没有支持撤销审核的接口，但是在管理后台里可以手动撤销。直接调用停止测试版本接口会报错：{“code”=>204144749, “msg”=>"[AMIS] shelf-off app failed, additional message is [[AppGalleryConnectAppMetaInfoService]No right to operate, version state is -999]"}。这种情况应该如何处理呢？

htzhanglong 1楼

原因：

状态 -999 = 正在等待审核 / 审核中
Testing API 没有专门 “撤销审核” 接口；你调用的是 停止测试（shelf-off） 接口，该接口只对 “正在测试、等待生效” 状态有效，对 -999（审核中） 无权操作 → 报错 No right to operate

正确处理方案（2 选 1）

用 Publishing API 的「撤销审核」接口（推荐）
- 接口：PUT /api/publish/v3/version/on-shelf/cancel
- 适用：测试版本（Testing）处于「正在审核 /-999」
- 效果：版本退回 准备提交，可重新提交或修改
等审核结果
- 等审核通过 → 状态变为 等待生效 / 正在测试
- 再调用 停止测试接口 即可成功

官方参考

撤销审核接口（on-shelf/cancel）：https://developer.huawei.com/consumer/cn/doc/FASP-by-Template-develop-References/on-shelf-cancel-0000002521750541
Testing 版本状态说明：https://developer.huawei.com/consumer/cn/doc/app/agc-help-test-api-versionstatus-0000001494606645
错误码说明：https://developer.huawei.com/consumer/cn/doc/app/agc-help-test-api-errorcode-0000002356508845

更多关于HarmonyOS鸿蒙Next中Testing API使用的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

bupafengyu 2楼

看错误码是应用下架失败，但是具体怎么做就不知道了

wuwangju 3楼

在HarmonyOS Next中，Testing API 基于 ArkTS/TypeScript，用于编写和运行单元测试。核心类包括 TestSuite、TestCase，通过 @Test 注解标记方法，使用 assertEqual、assertTrue 等断言验证结果。测试类需继承 TestCase，可在 @Before/@After 中初始化和清理。执行测试可通过 hdc shell test 命令或 IDE 内置测试工具。不支持 Java 或 C 语言。

gougou168 4楼

提交测试版本后进入“等待审核”状态时，该版本并未实际生效，因此无法调用“停止测试版本”（下架）接口，接口会返回状态-999表示当前版本不允许此操作。Testing API 目前没有提供撤销审核的接口，遇到这种情况只能通过 AppGallery Connect 管理后台人工撤销审，然后重新提交或调整版本。