OpenHarmony开发者论坛

标题: 关于OpenHarmony兼容性测评常见问题解答（FAQ） [打印本页]
作者: litiantian    时间: 2024-5-28 15:45
标题: 关于OpenHarmony兼容性测评常见问题解答（FAQ）
[md]OpenHarmony兼容性测评主要是验证合作伙伴的设备和业务应用满足OpenHarmony开源兼容性定义的技术要求，确保运行在OpenHarmony上的设备和业务应用能稳定、正常运行，同时使用OpenHarmony的设备和业务应用有一致性的接口和业务体验。

**OpenHarmony兼容性测评服务包括：产品兼容性技术规范文档与兼容性测试两部分。**

OpenHarmony 产品兼容性规范文档（PCS），定义设备兼容性的标准。开发者必须遵循此文档定义的规则进行设备开发。

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

**OpenHarmony兼容性测评的费用是多少？**

无需任何费用，兼容性测试套为开放源代码，可供任何企业用于测试

**兼容性测评可能会使用到以下链接：**

**1）测评指南：[https://www.openharmony.cn/certification/document/guid](https://www.openharmony.cn/certification/document/guid)**

（主要对兼容性测评服务、测评流程、测评审批周期、测评版本要求、兼容性类型、源码获取、测试执行环境搭建、测试指导进行了介绍）

**2）PCS：[https://www.openharmony.cn/certification/document/pcs](https://www.openharmony.cn/certification/document/pcs)**

（产品兼容性规范文档（简称PCS）主要对每个版本、每个系统类型定义了 与OpenHarmony 系统兼容的产品所必须满足的要求。兼容性测评时需使用对应版本、对应系统类型的PCS自检表，此表对最小系统部件集、可选部件集、商用设备信息接口规范要求也进行了详细的说明）

注：填写此表时自检结果为N/NA时，需在F列备注说明原因。

**3）XTS：[https://www.openharmony.cn/certification/document/xts](https://www.openharmony.cn/certification/document/xts)**

（主要对测试套件、资源文件、源码路径提供下载入口）

注：此页面的测试套件仅展示了标准系统（arm32）典型版本的测试套件，其他需自行编译（SSTS测试套件较为特殊，除arm32其他也均可取用XTS页面的SSTS测试套件）。套件与镜像版本不匹配可能会造成用例的失败。

**4）测评结果：[https://www.openharmony.cn/armList](https://www.openharmony.cn/armList)**

（主要对通过测评的产品进行公示。由伙伴在兼容性平台选择公示或不公示来决定）

**5）兼容性标识指引：[https://www.openharmony.cn/certification/award](https://www.openharmony.cn/certification/award)**

（主要提供了OpenHarmony兼容性标识使用指引和兼容性标识下载）

# 1 测评流程概述

OpenHarmony设备兼容性测评的流程。

![](https://compatibility.openharmon ... 7f3b0adba994937a1d4)

兼容性测评主要步骤如下：

**步骤 1** 申请OpenHarmony兼容性测评的企业（以下简称“申请方”）在[开放原子开源基金会](https://legacy.openatom.cn/register)网站申请企业帐号。

**步骤 2** 申请方从Gitee平台获取代码进行适配开发；从[OpenHarmony官网兼容性XTS专区](https://www.openharmony.cn/certification/document/xts)获取兼容性测试套件并在本地测试执行，自测试完成后，申请方可获取测试报告；从[OpenHarmony官网兼容性PCS专区](https://www.openharmony.cn/certification/document/pcs)获取PCS自检表并填写PCS自检表；如需申请失败项豁免，请前往OpenHarmony兼容性平台进行豁免申请，获取豁免结果；兼容性测试与PCS自检也可委托兼容性工作组授权的[兼容性测评合作中心](https://www.openharmony.cn/certification/cooperationCenter "兼容性测评合作中心")进行。

**步骤 3** 申请方首次申请测试报告评审时，应签署OpenHarmony兼容性平台所示《OpenHarmony兼容性协议》及《OpenHarmony兼容性平台隐私声明》；申请方上传测试报告、PCS自检表和镜像到OpenHarmony兼容性平台，申请方还应在上传测试报告同时向OpenHarmony兼容性工作组寄送产品样品。

**步骤 4** OpenHarmony兼容性工作组收到申请方上传的测试报告和产品样品后进行测评，并给出测评结果。若测评通过，则进入步骤5；若测评不通过，则OpenHarmony兼容性工作组将通知申请方进行整改。

**步骤 5** 若步骤4测评通过，则OpenHarmony兼容性工作组将按需启动复测流程。如未被选中复测，则申请方通过本次OpenHarmony兼容性测评。如被选中复测，则复测所用的兼容性测试套件包将由OpenHarmony兼容性工作组上传至平台。申请方自OpenHarmony兼容性平台下载前述复测套件包并在本地执行，生成复测报告后上传到OpenHarmony兼容性平台。

**步骤 6** OpenHarmony兼容性工作组对申请方复测报告进行评审，若复测评审通过，则本次OpenHarmony兼容性测评通过；若复测评审不通过，OpenHarmony兼容性工作组将通知申请方整改。

**步骤 7** OpenHarmony兼容性测评通过后，开放原子开源基金会将发放证书，在OpenHarmony官网进行展示，并授权申请方在其设备类OpenHarmony兼容产品及其包装、营销材料上使用OpenHarmony兼容性标识。

# 2 企业账号如何注册申请

1）在开放原子开源基金会网站[https://legacy.openatom.cn/register](https://legacy.openatom.cn/register)注册企业帐号。

2）注册完成后，使用企业账号登录开放原子开源基金会网站[https://legacy.openatom.org/](https://legacy.openatom.org/)，补充企业信息。

3）待企业账号审核通过，即可正常登录OpenHarmony兼容性平台[https://www.openharmony.cn/certification/document/guid](https://www.openharmony.cn/certification/document/guid)

# 3 兼容性测试（XTS）

## 3.1 兼容性测评版本要求

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

规则如下：

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

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

注：如果想了解具体时间最新消息可登录OpenHarmony兼容性平台，查看公告中心。

## 3.2 兼容性测试的套件范围

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

OpenHarmony兼容性测试需要合作伙伴获取代码和兼容性测试套，并完成自测，取得兼容性测试报告后，在测试流程上传兼容性测试报告供开放原子开源基金会团队进行审核或抽测。兼容性测试的套件范围：

| 测试分类       | 轻量系统 | 小型系统 | 标准系统                          |
| -------------- | -------- | -------- | --------------------------------- |
| acts           | Y        | Y        | Y                                 |
| acts-validator | N        | N        | Y（支持ArkTS应用+带屏的产品涉及） |
| hats           | N        | N        | Y                                 |
| dcts           | N        | N        | Y（带屏产品涉及）                 |
| ssts           | N        | N        | Y                                 |

## 3.3 兼容性测试的部件集范围

详情请见对应版本、对应系统类型的PCS自检表（PCS：[https://www.openharmony.cn/certification/document/pcs](https://www.openharmony.cn/certification/document/pcs)）的sheet-component页，最小系统部件集和API兼容性列表进行了详细的说明哪些为必选部件哪些为非必选部件

## 3.4 如何获取XTS测试套件

**XTS：**[https://www.openharmony.cn/certification/document/xts](https://www.openharmony.cn/certification/document/xts)此页面主要对测试套件、资源文件、源码路径提供下载入口。

注：此页面的测试套件仅展示了标准系统（arm32）典型版本的测试套件，其他需自行编译（**SSTS测试套件较为特殊**，除32位其他也可取用XTS页面的SSTS测试套件）。套件与镜像版本不匹配可能会造成用例的失败。

## 3.5 哪些需要申请、如何申请分布式测试盒子、是否有费用？

涉及标准系统分布式兼容性测试的产品，需要使用辅助设备分布式测试盒子。登录OpenHarmony兼容性平台，在兼容性测评-分布式测试盒管理-创建申请，进行填写可向兼容性工作组申请借用盒子，借用周期为60天，到期需进行归还。

费用：免费使用，无需任何费用。

## 3.6 兼容性测试指导

详情请见测评指南：[https://www.openharmony.cn/certification/document/guid](https://www.openharmony.cn/certification/document/guid)

## 3.7 如何查看版本分支基线数据

登录OpenHarmony兼容性平台，在兼容性测评-豁免申请-基线数据查看，选择对应版本、对应操作系统类型、对应测试套进行基线数据查看或者导出。（若无对应基线数据，则兼容性工作组未发布相应数据）

## 3.8 XTS用例失败了如何处理、哪些可以申请豁免及如何申请

当XTS用例测试失败了，可以单独进行复测，全量测试和单独复测组合通过是可以的；如果复测多次依旧失败，则需要伙伴自行分析用例失败的原因。

若可选特性不支持导致 或 用例本身问题可申请豁免，若需申请豁免需登录OpenHarmony兼容性平台，在兼容性测评-豁免申请-创建申请 路径下，申请豁免类型“XTS报告豁免”进行填写。需严格按照格式提示进行填写否则会被驳回。

## 3.9 XTS常见问题

常见问题归类可见[1. XDEVICE 自动化执行XTS，可视化报告显示执行UN。 - Wiki - Gitee.com](https://gitee.com/openharmony/xt ... E8%A1%8CUN%E3%80%82)

# 4 产品兼容性技术规范文档（PCS）

## 4.1 如何获取PCS自检表

兼容性测评使用的PCS自检表，需选择对应版本、对应系统类型的PCS自检表进行填写。

PCS：[https://www.openharmony.cn/certification/document/pcs](https://www.openharmony.cn/certification/document/pcs)

## 4.2 如何填写

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

2）此表第一个sheet页不可手动进行增、删、改。

## 4.3 关于商用设备信息接口

测评类型为商用设备的测评产品，需尤其注意PCS自检表的第一个sheet页的软件兼容性-最小系统部件集和API兼容性-设备信息格式规范（即sheet1中的表1-1设备信息接口列表），此条规格要求是必须项，需满足。即设备信息接口列表所有API接口需按照实际设备信息进行定义，并满足表中的返回值要求。GetOsFullName()操作系统及版本号，使用源码默认值，不能修改。

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

# 5 授权验证

## 5.1 授权验证是什么

授权验证包括设备侧集成的设备证明模块与基金会云侧的校验服务。通过端云结合的方式验证当前设备是否为基金会通过兼容性测评的设备。

## 5.2 如何调测授权验证

登陆兼容性平台，授权验证管理-管理软证书页面下载相关指导材料，“授权验证开发指南”和“软证书申请指导及解密工具”。根据指导进行调测验证。![image-20240503181948472.png](https://forums-obs.openharmony.c ... btkfffpt23xq824.png "image-20240503181948472.png")

## 5.3 哪些需要集成调测、哪些可以申请授权验证豁免及如何申请

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

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

## 5.4 如何查看设备的授权验证结果

登录OpenHarmony兼容性平台，授权验证管理-管理调测设备-授权验证状态-查看，即可实时查看此设备授权验证结果。

# 6 如何填写测评申请在兼容性平台

登录OpenHarmony兼容性平台，兼容性测评-兼容性测评-创建申请-下载操作指导，根据指导及平台的步骤引导进行一步步填写提交。

# 7 关于投递测评样机

## 7.1 投递测评样机的要求

在OpenHarmony兼容性平台，兼容性测评-兼容性测评-创建申请-下载操作指导中 或者 测评-样机寄送-投递物品清单模板 都可查看以下样机要求。

| 序号 | 要求项   | 内容                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ---- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1    | 样品数量 | 模组/开发板≥5<br />软件发行版≥2（每种） <br />商用设备≥2（整机投递≥1，预留测试相关接口的测试样机≥1） <br />外围辅助硬件工具需要一起投递； <br />软件工具和对应的使用方法在提交申请时可以和固件一起打包上传或者提供下载地址； <br />软件发行版至少需要适配两款及以上的芯片（相同的系统级别），需要投递每种至少两块； <br />商用设备需要整体投递，并预留测试相关接口； <br />同一厂家在申请基于以前已投递的实物并满足上述数量要求后做测评申请时不用重复投递。 |
| 2    | 投递地址 | 北京市海淀区北清路156号J园区Q6，兼容性工作组收，13671335601。                                                                                                                                                                                                                                                                                                                                                                                                    |
| 3    | 投递附件 | 为防止混乱，投递样品的快递内应附有的信息。<br />● 测评编号● 实物明细列表（包括外围辅助硬件工具明细）● 企业名称● 联系人及电话                                                                                                                                                                                                                                                                                                                                 |
| 4    | 实物档案 | 未发放证书之前<br />厂家可以提出撤销测评申请，在撤销申请审核通过后实物退回，运费到付。<br />发放证书之后<br />实物要留档封存，不退回；<br />因各种原因撤销证书，实物不退回。                                                                                                                                                                                                                                                                                     |

## 7.2 商用设备测评样机体积较大或者成本过高，可以不投递吗？

若测评样机体积较大或者成本过高，可向兼容性工作组邮箱（compatibility@mail.openharmony.io）发送邮件申请特殊备案处理。因邮箱每天接收大量邮件，需统一主题格式以便工作组及时进行处理答复。

**主题示例格式**：OpenHarmony兼容性测评商用设备非整机投递申请-测评编号：OHCxxxxxxxxxxxx-申请方：xxx公司

**邮件正文内容**：要体现传播名、物品整机效果图与实际投递物品图片及之间关系，无法邮寄整机原因，申请使用对应主控板认证等。

非整机投递时，带屏设备，需至少投递两套（主控+屏幕）；非带屏设备，需至少投递两套主控。且实际投递主控与屏幕需要与整机一致。

## 7.3 因投递的样机不退回，内部核销需工作组邮件回复确认怎么办？

因投递样机不退回，但是内部核销物料需要兼容性工作组邮件答复，可向兼容性工作组邮箱（compatibility@mail.openharmony.io）发送邮件，工作组会定时处理答复。因邮箱每天接收大量邮件，需统一主题格式以便工作组及时进行处理答复。

**主题示例格式**：OpenHarmony兼容性测评物料签收确认申请-测评编号：OHCxxxxxxxxxxxx-申请方：xxx公司

## 7.4 递样机现场投递，测评中的快递单号如何填写？

如果现场投递，测评中的快递单号可以填写测评编号

# 8 关于证书下载查看、结果公示、兼容性标识使用

证书下载查看：当测评发证后，登录OpenHarmony兼容性平台-我的证书-下载证书，即可下载查看

测评结果公示：可通过[https://www.openharmony.cn/armList](https://www.openharmony.cn/armList)查看测评公示结果（当测评通过后可随时申请公示或者取消公示）

兼容性标识使用指引：可通过[https://www.openharmony.cn/certification/award](https://www.openharmony.cn/certification/award)下载OpenHarmony兼容性标识使用指引和兼容性标识，按照规范使用兼容性标识。

# 9 如何获取测评相关的最新信息

登录OpenHarmony兼容性平台，查看公告中心，可获取测评相关的最新消息。

# 10 各个流程节点处理周期

1、企业帐号申请审批周期：3个工作日；

2、兼容性测评审批周期：14个工作日；

3、授权验证豁免审批周期：3个工作日；

4、XTS用例豁免审批周期：7个工作日（测评提交和XTS报告豁免申请可并行进行，无需等待XTS豁免审批完成再进行提交）；

5、分布式测试盒子审批周期：7个工作日（处理申请为7个工作日，但因盒子数量有限，实际投递周期不固定）；

6、软证书申请审批周期：实时（若页面状态一直显示”处理中“，可以进行刷新页面）；

7、调测设备的授权验证状态审批周期：实时（取决于伙伴调测成功的时间）；

8、发证流程审批周期：3个工作日；

9、公示流程审批周期：实时（取决于伙伴在测评中选择的公示时间，如：发证即公示则发证会实时公示在官网）；

# 11 如何反馈问题、建议或者寻求答疑支撑

关于兼容性测评或者兼容性平台相关，若反馈问题、建议或者需答疑支撑请登录OpenHarmony兼容性平台反馈问题详情。

若想了解更多的测评信息或者了解测评的其中某一版块，可在下方留言！
[/md]
作者: wber00vip    时间: 2024-6-1 14:59
建议或者需答疑支撑请登录 OpenHarmony 兼容性平台反馈问题 ？

入口在哪
作者: litiantian    时间: 2024-6-4 20:38
回复 wber00vip: https://www.openharmony.cn/certification/document/guid登录OpenHarmony兼容性平台，点击反馈，建议同步填写联系方式，方便工作人员联系
作者: zhonghuihui    时间: 2024-7-1 15:36
老师下午好！我这边软件绿色联盟的运营，看到您写的这篇文章很不错，想问一下方便转载吗，转载到软件绿色联盟的微信公众号上，绿盟覆盖主体主要是开发者，通过日常发布技术文章赋能开发者，转载文章会备注来源以及作者，期待老师的回复！
作者: 夕之蓝    时间: 2024-7-15 20:00
很全的解答帖👍
作者: JerryL    时间: 2024-7-31 10:14
请问兼容性测评除了要使用到分布式测试盒子之外，还会涉及到哪些外设？
作者: lxd_0619    时间: 2024-8-19 14:02
标题: 关于OpenHarmony兼容性测评常见问题解答（FAQ）
[md]关于第7.2条，我们拟测评的设备成本高，能否将整机寄到你处，测评完成后，再给我们寄回来？
[/md]
作者: charleeyang    时间: 2024-8-20 13:16
回复 lxd_0619: 不能。看下李老师第7.2，7.3章节的要求就是专门针对这个问题的！
我们遇到和你相同的问题，上主控吧！
作者: hhj    时间: 2024-9-4 09:01
xts 兼容性测试套件下载 里面有ACTS  ACTS-VALIDATOR ,HATS,DCTS,SSTS  这么多要怎么用？用哪个，这些步骤里面的要怎么做？发现鸿蒙这刷系统，兼容性测试，这些乱七八糟的事情，占用的精力比开发时间还要多。这也是鸿蒙到现在还没什么人用的原因吧，把开发者都折腾的够呛
作者: hellokun    时间: 2024-9-9 19:22
回复 hhj: 社区有完整教程的，不是所有套件都要跑。基本流程：确定设备类型、是否符合最小测试集、自检表确认、导出测试项目（建议用脚本导出）、准备测试材料、开始测试。我第一次搞XTS也是花了一天时间来梳理流程https://www.openharmony.cn/certification/document/guid



欢迎光临 OpenHarmony开发者论坛 (https://forums.openharmony.cn/) Powered by Discuz! X3.5