OpenHarmony兼容性测评常见问题解答（FAQ）

OpenHarmony兼容性测评常见问题解答（FAQ）

概述

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

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

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

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

一、基础问题

Q**1**：兼容性测评包含哪些测试套件？

A：兼容性测试包括：acts、acts-validator、hats、dcts、ssts。各系统类型涉及的测试套件如下：

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

Q**2**：兼容性测评的版本要求是什么？

A：合作伙伴需选择OpenHarmony已发布LTS（Long Term Support）或Release分支的V版本进行测试，推荐使用最新发布LTS或Release分支的V版本。

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

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

Q**3**：兼容性测评相关链接有哪些？

· 测评指南：https://www.openharmony.cn/certification/document/guid

· PCS文档：https://www.openharmony.cn/certification/document/pcs

· XTS下载：https://www.openharmony.cn/systematic?tab=xts

· 测评结果公示：https://www.openharmony.cn/armList

· 兼容性标识指引：https://www.openharmony.cn/certification/award

二、测评流程

Q**4**：兼容性测评的整体流程是怎样的？

A：主要步骤如下：

· 步骤1：在开放原子开源基金会网站（https://legacy.openatom.cn/register）申请企业帐号。

· 步骤2：从Gitcode平台获取代码进行适配开发；从XTS专区（https://www.openharmony.cn/systematic?tab=xts）获取兼容性测试套件并本地执行；从PCS专区（https://www.openharmony.cn/certification/document/pcs）获取PCS自检表并填写；如需豁免，在兼容性平台(https://compatibility.openharmony.cn/)申请。兼容性测试与 PCS 自检也可委托兼容性工作组授权的兼容性测评合作中心（https://www.openharmony.cn/cooperationCenter）进行。

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

· 步骤4：工作组收到申请后进行测评，给出结果。不通过则通知整改。

· 步骤5：通过后可能启动复测流程，申请方下载复测套件包执行并上传报告。

· 步骤6：复测评审通过则测评通过，不通过则通知整改。

· 步骤7：通过后发放证书，在官网展示，授权使用OpenHarmony兼容性标识。

Q**5**：生态伙伴的企业账号/注册人信息遗忘丢失，如何处理？

A：需发送邮件至 it-admin@openatom.org 获取。

· 主题格式：OpenHarmony兼容性测评平台_企业账号信息申请-申请方：xxx公司

· 邮件正文：说明情况且附带社会信用代码及营业执照。

三、兼容性测试（XTS）相关问题

Q**6：兼容性测试指导**

A：详情请见测评指南：https://www.openharmony.cn/certification/document/guid

Q**7**：哪些产品需要使用分布式测试盒子？

A：标准系统带屏涉及分布式兼容性测试的产品需要使用辅助设备分布式测试盒子。登录兼容性平台，在"兼容性测评-分布式测试盒管理-创建申请"进行填写申请借用，借用周期60天，到期需归还。若时间紧急，也可自行购买(#小程序://京东购物丨点外卖领国补/afy0CX0HvKorOua)

Q**8**：XTS用例失败了如何处理？

A：可以单独进行复测，全量测试和单独复测组合通过即可。如果复测多次依旧失败，需自行分析用例失败原因。若PCS表中可选特性不支持或用例本身问题可申请豁免。需要注意的是，虽然支持单独复测，但兼容性测评平台提交的必须是最终一份完整的报告。

Q**9**：如何申请XTS用例豁免？

A：登录OpenHarmony兼容性平台，在"兼容性测评-豁免申请-创建申请"路径下，申请豁免类型"XTS报告豁免"进行填写。需严格按照格式提示填写，否则会被驳回。测评提交和XTS报告豁免申请可并行进行，无需等待豁免审批完成再提交。

四、测评驳回常见问题

Q1**0**：测评被驳回，提示平台信息与设备接口获取的值不一致，如何解决？

A：需确保以下三处信息完全一致：

· ① 兼容性平台填写的基本信息

· ② XTS报告中显示的值

· ③ 设备侧接口实际获取的值

设备信息接口规定如下：

· GetDeviceType()：设备类型。最多32字符，不允许使用中文，用以标识设备的品类。允许使用默认值default

· GetManufacture()：公司英文名简称。最多32字符

· GetBrand()：品牌英文名称。最多32字符

· GetMarketName()：外部产品英文名称（传播名），用户可见。最多32字符

· GetProductSeries()：产品系列英文名称，用于产品分类管理。最多32字符

· GetProductModel()：型号，用户可见，通常打印在设备铭牌上，需采用英文描述。最多32字符

· GetSoftwareModel()：内部软件子型号，多硬件共软件时区分软件分支。最多32字符

· GetHardwareModel()：内部硬件子型号。最多32字符

· GetSerial()：设备序列号，标识设备的关键信息，用户可见。最多64字符

· GetOsFullName()：操作系统及版本号，系统名与版本号以英文字符"-"连接，不能包含空格。最多64字符。使用源码默认值，不能修改

· GetDisplayVersion()：用户可见的软件版本号（整个系统的版本号而非OpenHarmony版本号）。最多64字符

· GetBootloaderVersion()：Bootloader版本号。最多64字符

· GetSecurityPatchTag()：安全补丁标签，标识当前OS的安全补丁级别。最多64字符，格式为"年/月/日"

· GetAbiList()：abi兼容性列表，多个取值以英文逗号分隔，仅在有生态的系统且包含native应用时使用。最多64字符

· GetSdkApiVersion()：系统软件API Version，一般是整数。随软件版本变更

· GetFirstApiVersion()：设备首版本的系统软件API Version，仅在有生态的系统使用，一般是整数

· GetIncrementalVersion()：差异版本号，在设备型号确定的情况下可唯一标识软件版本

· GetVersionId()：版本Id，由多个字段拼接而成，最多255字符。格式：设备类型/公司英文名简称/品牌英文名称/产品系列英文名称/操作系统及版本号/型号/内部软件子型号/系统软件API level/差异版本号/构建类型

· GetBuildType()：构建类型，如debug、release、log、nolog等，可用英文冒号分隔多个标识。最多32字符。允许使用默认值default

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

Q1**1**：安全补丁标签格式不一致怎么办？

A：平台填写的格式需与设备接口返回值完全一致。例如平台填"2025/5/1"而接口返回"2025/05/01"，需统一为相同格式。建议统一使用"YYYY/MM/DD"格式。

Q1**2**：XTS测试报告中有模块缺失或Fail，如何处理？

A：常见情况及处理方式：

· ① 模块缺失（如缺少ActsParameterTest、HatsHdfDisplayComposerAdditionalTest等）：需提供通过的可执行日志或重新执行测试。

· ② 用例Fail：先单独复测该用例，如仍失败需自行分析原因。若为可选特性不支持或用例本身问题，可申请豁免。

· ③ 执行结果中出现UN/Blocked/Unavailable状态：需提供通过的可执行日志或通过开发者工具进行复测。

Q**13**：样机投递有哪些要求？

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

· ① 样品数量：模组/开发板≥5；软件发行版≥2（每种）；商用设备≥2（整机投递≥1，预留测试接口的样机≥1）；外围辅助硬件工具需要一起投递；软件工具和对应的使用方法在提交申请时可以和固件一起打包上传或者提供下载地址；软件发行版至少需要适配两款及以上的芯片（相同的系统级别），需要投递每种至少两块；商用设备需要整体投递，并预留测试相关接口；同一厂家在申请基于以前已投递的实物并满足上述数量要求后做测评申请时不用重复投递。

· ② 创建测评后，第 5 步样机寄送页面会显示收件的联系人、联系方式、联系地址。 按照页面显示的地址投递。

· ③ 为防止混乱，投递样品的快递内应附有测评编号 ，实物明细列表（包括外围辅助硬件工具明细），企业名称，联系人及电话

· ④ 未发放证书之前厂家可以提出撤销测评申请，在撤销申请审核通过后实物退回，运费到付。发放证书之后实物要留档封存，不退回；因各种原因撤销证书，实物不退回

Q**14**：缺少串口板/测试配线等配件怎么办？

A：需补寄缺少的配件。缺少串口板等配件会导致无法进行测试，请务必在首次投递时包含所有必要的测试配件。

Q**15**：商用设备体积较大或成本过高，可以不投递整机吗？

A：可以向兼容性工作组邮箱（compatibility@mail.openharmony.io）发送特殊备案申请。

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

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

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

Q**16**：外观图有哪些要求？

A：

· ① 背景要求：纯白背景，或者抠图无背景

· ② 需包含产品正面、背面（如有）、侧面等多角度图片

· ③ 图片中需清晰展示产品位置，不可有遮挡

· ④ 外观图应与实际投递的样机一致

· ⑤ 带屏设备需展示屏幕点亮状态

Q**17**：关于OpenHarmony标识使用有哪些常见驳回原因？

A：

· ① 平台信息中使用了"OpenHarmony"字样作为产品名/系统名，不符合规范。OpenHarmony版本号不能自定义修改，需使用源码默认值。

· ② 产品首页开源组件及兼容性标识使用不符合《OpenHarmony兼容性标识使用指引》规范。

· ③ "Powered by OpenHarmony"标识使用不规范，需参照《OpenHarmony兼容性标识使用指引 V1.1》。

· ④ 软件版本号中不能包含"OpenHarmony"字样，应使用自定义品牌名称。

相关规范文件下载地址：https://www.openharmony.cn/guide

五、产品兼容性技术规范文档（PCS）

Q**18**：如何获取PCS自检表？

A：从 https://www.openharmony.cn/certification/document/pcs 下载对应版本、对应系统类型的PCS自检表。

Q**19**：PCS自检表如何填写？

A：

· 自检结果Y：满足此条规格要求

· 自检结果N：不满足，需在F列备注说明原因

· 自检结果NA：不涉及，需在F列备注说明原因

· 第一个sheet页不可手动增删改

· 自检结果、备注原因及测评信息需保持一致

六、证书与标识

Q**20**：如何下载查看证书？

A：测评发证后，登录OpenHarmony兼容性平台-我的证书-下载证书。

Q**21**：测评结果如何公示？

A：通过 https://www.openharmony.cn/armList 查看。测评通过后可随时申请公示或取消公示。

七、其他问题

Q**22**：如何获取测评相关的最新信息？

A：登录OpenHarmony兼容性平台，查看公告中心。

Q**23**：如何反馈问题、建议或寻求答疑支撑？

A：

· ① 关于兼容性测评：优先联系对应的测评合作中心

· ② 工作组邮箱：compatibility@mail.openharmony.io

Q**24**：因投递样机不退回，内部核销需要工作组邮件确认怎么办？

A：发送邮件至 compatibility@mail.openharmony.io

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