OpenHarmony开源鸿蒙兼容性测试常见问题解答分享

深光标准

已于 2025-04-03 15:45:39 修改

阅读量679

点赞数 20

文章标签：开源 harmonyos 华为

于 2025-04-02 15:51:59 首次发布

本文链接：https://blog.csdn.net/nsd2303/article/details/146948237

版权

OpenHarmony 兼容性测评主要是验证合作伙伴的设备和业务应用满足 OpenHarmony 开源兼容性定义的技术要求，确保运行在 OpenHarmony 上的设备和业务应用能稳定、正常运行，同时使用 OpenHarmony 的设备和业务应用有一致性的接口和业务体验。

一、兼容性测评服务

1.1、OpenHarmony 兼容性测评服务包括哪些？

包括产品兼容性技术规范文档（PCS）与兼容性测试两部分。

1.2、产品兼容性技术规范文档PCS如何填写？

回答这个问题之前，我们了解下PCS表的重要性：它定义设备兼容性的标准，开发者必须遵循此文档定义的规则进行设备开发，主要对每个版本、每个系统类型定义了与OpenHarmony 系统兼容的产品所必须满足的要求。

兼容性测评时需使用对应版本、对应系统类型的 PCS 自检表，此表对最小系统部件集、可选部件集、商用设备信息接口规范要求也进行了详细的说明）

注：填写此表OpenHarmony标准系统兼容性规范时自检结果（Y/N/NA）中的”Y“代表满足此条规格要求；”N“代表不满足；“NA”代表不涉及。填写此表时自检结果为 N/NA 时，需在 F 列备注说明原因。

注：填写此表sheet 1时根据设备实际参数字段填写，此表第一个 sheet 页不可手动进行增、删、改。

const.product.devicetype 这个字段改了之后产生黑屏或进入不了主界面现象的话（如上所示），可以使用默认default。

1.3、关于开源鸿蒙商用设备信息接口

测评类型为商用设备的测评产品，需尤其注意 PCS 自检表的第一个 sheet 页的软件兼容性。

最小系统部件集和 API 兼容性设备信息格式规范（即 sheet1 中的表 11 设备信息接口列表），此条规格要求是必须项，需满足。即设备信息接口列表所有 API 接口需按照实际设备信息进行定义，并满足表中的返回值要求。GetOsFullName()操作系统及版本号，使用源码默认值，不能修改。

查询 L1\L2 设备信息命令：begetctl dump api

二、兼容性测试（XTS）

2.1什么是兼容性测试测试套件？

OpenHarmony 兼容性测试套件（XTS），提供验证设备兼容性的执行机制。开发者可以借助此套件对兼容性进行评估和验证。

2.2 兼容性测评版本有什么要求？

提交的兼容性测评申请需要选择 OpenHarmony 已发布 LTS（Long Term Support）或 Release 分支的 V 版本进行测试。推荐使用最新发布 LTS 或 Release 分支的 V 版本。

规则如下：

1、新的 LTS 或 Release 分支发布 6 个月后，不支持基于新产品老分支版本测评。

2、老产品（已测评过产品），在 LTS 或 Release 分支维护周期内支持升级测评。

2.3、兼容性测试的套件范围

兼容性测试包括：acts、acts-validator、hats、dcts、ssts

兼容性测试的套件范围：

2.4 常见fail项

DPI 默认是240，但是目前使用默认值测试通常会fail，200是我们实际测试是可以通过的。

2.5、XTS 用例失败了如何处理？

当 XTS 用例测试失败了，可以单独进行复测，全量测试和单独复测组合通过是可以的；如果复测多次依旧失败，则需要分析用例失败的原因。然后在项目提交的同时也提交豁免项。

三、授权验证

3.1 opeharmony的授权验证是什么？

授权验证包括设备侧集成的设备证明模块与基金会云侧的校验服务。通过端云结合的方式验证当前设备是否为基金会通过兼容性测评的设备。可登陆兼容性平台下载相关指导材料；

3.2 哪些设备需要集成调测？哪些可以申请授权验证豁免及如何申请？

测评类型为商用设备的测评产品，涉及授权验证；非商用设备测评则不涉及授权验证。

若设备可以访问外网（例如百度网站），则需要集成调测，若不能访问则需申请授权验证豁免。如果需要申请豁免请登录 OpenHarmony 兼容性平台，兼容性测评豁免申请创建申请，选择申请豁免类型“授权验证豁免”进行填写。

四、测评样机

投递测评样机的要求

*以上是正式验证的要求数量，做预测试时，需要对应多寄2台，留着与官方对报告。

五、Openharmony兼容性测试常用命令：

1、 run acts 执行全量测试，启动兼容性测试套件，覆盖所有预定义用例，适用于整体兼容性验证。

2、run -l ActsSamgrTest;actsAceWebViewWebStorageJsunit 执行指定模块测试，支持分模块测试，以分号分隔多个模块，便于问题定位与针对性修复。

3、hdc list targets v显示已连接的设备详细信息（如序列号、IP），确保测试环境正确配置。

4、hdc shell reboot 重启设备，强制重启设备，解决测试过程中系统卡顿或配置未生效的问题。

5、hdc shell mount o rw,remount / 挂载系统分区为可写，修改系统配置文件（如`install_list.json`）时解除只读限制。