HarmonyOS 鸿蒙Next上架检测FAQ：应用或元服务明确支持设备类型

概述

应用/元服务明确支持设备类型，该检测项是兼容性测试中的重要标准，要求App pack包中，每个Hap包必须明确支持的设备类型，不能为空。

设计原则

APP pack包中，每个Hap包必须明确支持的设备类型：

1、不能为空；

2、hap包中module.json5文件，devicetypes字段配置支持的设备类型phone/tablet/tv/2in1/wearable/car/default，其中，配置为default虽然可以正常编译构建，但是不支持发布上架。建议使用phone代替。

典型案例

常见问题一：您的应用未明确支持设备类型，不符合审核标准。

{
  "module": {
    "name": "myHapName",
    "type": "feature",
    // deviceTypes字段不能为空，且取值范围为[tablet, tv, wearable, 2in1, phone, car, default]，其中，default不支持发布上架。
    "deviceTypes": [
      "default"
    ],
    // ...
  }
}

修改指引

hap包中module.json5文件，devicetypes字段支持的设备类型不能为空，且取值范围为phone/default/tablet/tv/2in1/wearable/car。详情见module.json5配置文件。

发布应用时可以为应用配置分发至多种设备，默认发布设备为创建应用时选择的设备类型，可以根据实际情况进行修改。详情见配置支持设备。

应用上架前迭代版本测试可使用DevEco Testing应用上架预检功能在本地设备/虚拟机提供黑盒专业测试能力，提前发现上架基础体验类问题，提升上架审核效率。

应用上架提审前可使用云测试应用上架预检功能在云端提供远程黑盒专业测试，包含多品类，多设备，多OS的兼容测试能力，提前发现上架基础体验类问题，提升上架审核效率。

更多关于HarmonyOS 鸿蒙Next上架检测FAQ：应用或元服务明确支持设备类型的实战教程也可以访问 https://www.itying.com/category-93-b0.html

zlyuanteng 1楼

666

更多关于HarmonyOS 鸿蒙Next上架检测FAQ：应用或元服务明确支持设备类型的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

gougou168 2楼

鸿蒙Next应用上架时，需在AppGallery Connect中明确定义支持的设备类型。在项目配置文件（app.json5或module.json5）的"deviceTypes"字段内声明，如phone、tablet、tv等。提交审核前，请确保声明的设备类型与应用的UI布局、功能及API调用完全兼容。审核将验证应用在各声明设备上的实际运行情况。

htzhanglong 3楼

这是一个非常关键的检测项，直接关系到应用/元服务能否通过上架审核。

核心要点在于：App pack包中的每一个Hap包的module.json5配置文件里，deviceTypes字段必须明确声明其支持的设备类型列表，且不能为空或仅包含"default"。

根据您提供的FAQ内容，开发者需要特别注意以下几点：

字段不能为空："deviceTypes": [] 这样的空数组配置是绝对不允许的，会导致检测失败。
禁止使用 "default" 作为上架配置：虽然编译构建时允许配置"default"，但此配置无法通过上架审核。这是一个常见的“坑”。如果您的应用主要面向手机，应将"default"替换为"phone"。
正确枚举设备类型：根据应用实际适配情况，在数组内明确列出支持的设备。例如，同时支持手机和平板："deviceTypes": ["phone", "tablet"]。有效取值范围为：phone、tablet、tv、2in1、wearable、car。

修改和检查建议：

逐一检查项目中的每个module.json5文件。
确保deviceTypes字段配置了至少一个上述有效值。
如果之前使用了"default"，请根据应用的主打设备类型（如手机phone）进行替换。
在提交上架前，务必使用 DevEco Testing的本地预检 或 云测试的云端预检 功能进行扫描，可以提前发现此类配置问题，避免审核被拒。