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

| OpenHarmony 兼容性测评主要是验证合作伙伴的设备和业务应用满足 OpenHarmony 开源兼容性定义的技术要求，确保运行在 OpenHarmony 上的设备和业务应用能稳定、正常运行，同时使用 OpenHarmony 的设备和业务应用有一致性的接口和业务体验。OpenHarmony 兼容性测评服务包括：产品兼容性技术规范文档与兼容性测试两部分。OpenHarmony 产品兼容性规范文档（PCS），定义设备兼容性的标准。开发者必须遵循此文档定义的规则进行设备开发。OpenHarmony 兼容性测试套件（XTS），提供验证设备兼容性的执行机制。开发者可以借助此套件对兼容性进行评估和验证。OpenHarmony 兼容性测评的费用是多少？无需任何费用，兼容性测试套为开放源代码，可供任何企业用于测试兼容性测评可能会使用到以下链接：​1）测评指南：https://www.openharmony.cn/certification/document/guid（主要对兼容性测评服务、测评流程、测评审批周期、测评版本要求、兼容性类型、源码获取、测试执行环境搭建、测试指导进行了介绍）2）PCS：https://www.openharmony.cn/certification/document/pcs（产品兼容性规范文档（简称 PCS）主要对每个版本、每个系统类型定义了 与 OpenHarmony 系统兼容的产品所必须满足的要求。兼容性测评时需使用对应版本、对应系统类型的 PCS 自检表，此表对最小系统部件集、可选部件集、商用设备信息接口规范要求也进行了详细的说明）注：填写此表时自检结果为 N/NA 时，需在 F 列备注说明原因。3）XTS：https://www.openharmony.cn/certification/document/xts（主要对测试套件、资源文件、源码路径提供下载入口）注：此页面的测试套件仅展示了标准系统（arm32）典型版本的测试套件，其他需自行编译（SSTS 测试套件较为特殊，除 arm32 其他也均可取用 XTS 页面的 SSTS 测试套件）。套件与镜像版本不匹配可能会造成用例的失败。4）测评结果：https://www.openharmony.cn/armList（主要对通过测评的产品进行公示。由伙伴在兼容性平台选择公示或不公示来决定）5）兼容性标识指引：https://www.openharmony.cn/certification/award（主要提供了 OpenHarmony 兼容性标识使用指引和兼容性标识下载）# 1 测评流程概述OpenHarmony 设备兼容性测评的流程。兼容性测评主要步骤如下：步骤 1 申请 OpenHarmony 兼容性测评的企业（以下简称“申请方”）在开放原子开源基金会网站申请企业帐号。步骤 2 申请方从 Gitee 平台获取代码进行适配开发；从 OpenHarmony 官网兼容性 XTS 专区获取兼容性测试套件并在本地测试执行，自测试完成后，申请方可获取测试报告；从 OpenHarmony 官网兼容性 PCS 专区获取 PCS 自检表并填写 PCS 自检表；如需申请失败项豁免，请前往 OpenHarmony 兼容性平台进行豁免申请，获取豁免结果；兼容性测试与 PCS 自检也可委托兼容性工作组授权的兼容性测评合作中心进行。步骤 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 注册企业帐号。2）注册完成后，使用企业账号登录开放原子开源基金会网站 https://legacy.openatom.org/，补充企业信息。3）待企业账号审核通过，即可正常登录 OpenHarmony 兼容性平台 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、sstsOpenHarmony 兼容性测试需要合作伙伴获取代码和兼容性测试套，并完成自测，取得兼容性测试报告后，在测试流程上传兼容性测试报告供开放原子开源基金会团队进行审核或抽测。兼容性测试的套件范围：| 测试分类 | 轻量系统 | 小型系统 | 标准系统 | | ---------------- | ---------- | ---------- | --------------------------------------- | | 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）的 sheet-component 页，最小系统部件集和 API 兼容性列表进行了详细的说明哪些为必选部件哪些为非必选部件## 3.4 如何获取 XTS 测试套件​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## 3.7 如何查看版本分支基线数据登录 OpenHarmony 兼容性平台，在兼容性测评-豁免申请-基线数据查看，选择对应版本、对应操作系统类型、对应测试套进行基线数据查看或者导出。（若无对应基线数据，则兼容性工作组未发布相应数据）## 3.8 XTS 用例失败了如何处理、哪些可以申请豁免及如何申请当 XTS 用例测试失败了，可以单独进行复测，全量测试和单独复测组合通过是可以的；如果复测多次依旧失败，则需要伙伴自行分析用例失败的原因。若可选特性不支持导致 或 用例本身问题可申请豁免，若需申请豁免需登录 OpenHarmony 兼容性平台，在兼容性测评-豁免申请-创建申请 路径下，申请豁免类型“XTS 报告豁免”进行填写。需严格按照格式提示进行填写否则会被驳回。## 3.9 XTS 常见问题常见问题归类可见 1. XDEVICE 自动化执行 XTS，可视化报告显示执行 UN。 - Wiki - Gitee.com# 4 产品兼容性技术规范文档（PCS）## 4.1 如何获取 PCS 自检表兼容性测评使用的 PCS 自检表，需选择对应版本、对应系统类型的 PCS 自检表进行填写。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 如何调测授权验证登陆兼容性平台，授权验证管理-管理软证书页面下载相关指导材料，“授权验证开发指南”和“软证书申请指导及解密工具”。根据指导进行调测验证。## 5.3 哪些需要集成调测、哪些可以申请授权验证豁免及如何申请测评类型为商用设备的测评产品，涉及授权验证；非商用设备测评则不涉及授权验证。若设备可以访问外网（例如百度网站），则需要集成调测，若不能访问则需申请授权验证豁免。如果需要申请豁免请登录 OpenHarmony 兼容性平台，兼容性测评-豁免申请-创建申请，选择申请豁免类型“授权验证豁免”进行填写。## 5.4 如何查看设备的授权验证结果登录 OpenHarmony 兼容性平台，授权验证管理-管理调测设备-授权验证状态-查看，即可实时查看此设备授权验证结果。# 6 如何填写测评申请在兼容性平台登录 OpenHarmony 兼容性平台，兼容性测评-兼容性测评-创建申请-下载操作指导，根据指导及平台的步骤引导进行一步步填写提交。# 7 关于投递测评样机## 7.1 投递测评样机的要求在 OpenHarmony 兼容性平台，兼容性测评-兼容性测评-创建申请-下载操作指导中 或者 测评-样、