文档开发者中心
我的
|

ArkUI (方舟UI框架)

HarmonyOS 6

应用媒体

HarmonyOS 5

测试应用出现问题

10

mate80上可以测试,(代码API12,版本5.0.0),nova12不能测试,鸿蒙版本都是6.1,感觉很奇怪

点赞
1
收藏
2
回复
20
分享
举报
浏览838 发布于2026-07-07 01:30湖北
全部评论
最多点赞
最新发布
最早发布
|
技术支持
尊敬的开发者,您好:
如果您是在使用邀请测试链接将测试应用安装至手机上时出现上述问题,引起该问题的原因较多,如:
  • 邀请测试链接过期
  • 应用项目的工程级build-profile.json5-compatibleSdkVersion配置与对应设备不兼容
  • 分发区域未选择中国大陆
您可以参考帖子:使用邀请测试链接安装应用-提示不支持此设备该如何定位 来进行问题排查
8楼回复于2026-07-07 08:38 来自广东

这个现象建议先不要只看“鸿蒙版本都是 6.1”,同版本下不同机型的 API 兼容、SystemCapability 和硬件能力仍可能不同。建议按这个顺序排查:

1. 在两台设备上打印 deviceInfo.productModel、deviceInfo.sdkApiVersion / distributionOSApiVersion、abiList,确认实际 API 与架构是否一致;API 12 工程也可能调用到更高 API 或某个机型没有的能力。

2. 对可疑接口用 canIUse('SystemCapability.xxx') 或 deviceInfo.apiAvailable(...) 做运行前判断,返回 false 时走降级逻辑,不要直接调用。

3. 如果是安装/启动测试失败,检查 module.json5 的 deviceTypes 是否覆盖 phone,并看真机日志里是否有 syscap、permission、so ABI 或 API not available 类错误。

4. 如果只有 nova12 失败,把失败时的 hilog/安装报错和用到的关键 API 贴出来,才能继续判断是机型能力差异还是应用自身兼容处理缺失。

4楼回复于2026-07-07 01:53 未知归属地

AGC 支持邀请 / 公开两种 HarmonyOS 应用测试模式,用户打开邀请链接安装测试包时提示设备不兼容,可按以下维度排查:

  1. 核对工程build-profile.json5兼容 SDK 版本,匹配设备系统;
  2. 校验邀请测试发布配置、链接有效期、分发区域(国内需勾选中国大陆);
  3. 必须使用系统浏览器打开链接,第三方浏览器会拦截识别。

其他常见异常处理

  1. 链接提示任务不存在:改用二维码扫码打开;
  2. 提示账号无法参与测试:华为账号未加入开发者测试群组;
  3. 尝鲜专区看不到应用:需先通过邀请链接授权测试;
  4. 新增测试用户无通知:任务开启后新增用户不会自动推送邀请,需手动下发链接。

限制规则

测试群组最多 30 个,所有群组测试用户总数不超 1000 人。

6楼回复于2026-07-07 04:47 来自广东
有些功能需要升级到125才能用。这就是大家吵着要更新的原因
2
5楼回复于2026-07-07 02:24 来自浙江
  • Franklin蔡
    哦哦哦,nova12用的是117,mate80用的是125
    2026-07-07 02:30 来自湖北
  • 子非鱼回复Franklin蔡
    这就对了嘛
    2026-07-07 02:30 来自浙江
部分应用会限制机型
6
2楼回复于2026-07-07 01:40 来自辽宁
  • Franklin蔡
    这是我自己做的应用,也没有限制啊
    2026-07-07 01:41 来自湖北
  • 阿柳回复Franklin蔡
    都用了哪些API呀
    2026-07-07 01:42 来自辽宁
  • 阿柳回复Franklin蔡
    有一些接口k8000是不能用的
    2026-07-07 01:45 来自辽宁
  • 展开剩余3条回复

在正式版本发布之前,您可以面向全网公开招募部分用户测试您的应用,以收集测试用户的反馈意见,助您提前发现问题,及时修复问题和优化版本体验。

公开测试会把您的应用上架至AppGallery,面向全网招募测试用户。公开测试和其他测试方式区别如下,您可以根据实际业务需求,选择合适的测试方式。

https://developer.huawei.com/consumer/cn/doc/app/agc-help-public-test-overview-0000002259136294

cke_176.png

10楼回复于2026-07-08 09:18 来自广东

这个提示一般不是应用本身有问题,而是测试版本与当前设备不匹配导致的。

根据官方和 AGC 文档,这种情况通常可以从下面几个方向排查:

  1. 邀请测试链接是否已过期

    邀请测试链接有有效期,如果链接失效,会出现”不支持此设备”等提示。 

  2. 检查 build-profile.json5 的 compatibleSdkVersion 配置

    如果工程中配置的 compatibleSdkVersion 高于当前设备支持的版本,或者与设备版本类型不匹配,也会导致部分机型无法安装。建议确认 Mate80 和 nova12 对应系统基线是否一致。 

  3. 检查测试版本的分发区域

    邀请测试、公开测试目前仅支持中国大陆地区。如果 AGC 后台没有勾选中国大陆,或者设备登录账号所属区域不一致,也可能提示当前设备不支持。 

  4. 确认 AGC 后台的设备适配配置

    如果发布测试版本时配置了设备范围、能力限制,可能导致 Mate80 可以安装,而 nova12 被过滤。建议检查 AGC 后台对应测试版本的配置。 

如果 Mate80 可以安装,而 nova12(同为 HarmonyOS 6.1)不能安装,个人更倾向于优先检查下面两项:

  • build-profile.json5 中的 compatibleSdkVersion 配置是否正确;
  • AGC 测试版本的分发区域和设备适配范围是否配置有误。

另外想确认一下:

  • 是 通过 AGC 邀请测试链接安装,还是直接安装 HAP?
  • nova12 是 HarmonyOS NEXT,还是兼容版 HarmonyOS?这两种场景排查方向也会有所不同。
3
9楼编辑于2026-07-07 13:09 来自辽宁
  • Franklin蔡
    我的这个是通过的AGC邀请测试安装。
    2026-07-22 07:51 来自湖北
  • Franklin蔡
    nova 12跟mate80都是用的同样的带安卓兼容层的HarmonyOS.
    2026-07-22 07:55 来自湖北
  • Franklin蔡
    ADC的分发区域和设备适配范围都是对的,然后呃那个文件里面的配置也是6.0.0。
    2026-07-22 07:55 来自湖北
您在HUAWEI Mate 80和华为nova 12上的测试差异,主要是因为两款手机的硬件平台不同,导致其支持的鸿蒙系统API接口存在差异,即使系统大版本号相同。
7楼回复于2026-07-07 07:50 来自内蒙古
1楼回复于2026-07-07 01:37 来自湖北
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。