# 兼容性测试 云测试为您提供全自动化的兼容性测试功能，用于检测应用或元服务在启动、崩溃、无响应、白屏、无法回退、输入一致、任务连续和设计约束等方面的兼容性问题。 ## 前提条件 您已成功创建测试任务，且配置的"测试范围"包含"兼容性测试"。 ## 查看测试报告 1. 登录[HarmonyOS 开发者中心](https://developer.huawei.com/consumer/cn/hdc-console)，进入"应用管理"页面。 2. 在左上角的应用列表中点击"切换至项目"，选择需要查看测试报告的项目。 3. 在左侧导航栏选择"质量和运维 > 云测试"，进入云测试主界面。 4. 选择"测试任务"页签，您可以通过搜索框或测试任务列表中"应用类型"、"测试场景"、"测试状态"右侧的![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c4/v3/Rmj80MrUQ9eNwEsYdCJ_uw/zh-cn_image_0000002748609185.png?HW-CC-KV=V1&HW-CC-Date=20261009T134731Z&HW-CC-Expire=31536000000&HW-CC-Sign=57C984258DAC99D9A84EEED15F7554A6394BDACCB98F0D386F97F9B0A1BBD763)筛选出您要查看的测试任务，然后点击"操作"列的"查看报告"进入测试报告页面。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e8/v3/gjMIFkfUT2elNUhKs4Tqow/zh-cn_image_0000002718929286.png?HW-CC-KV=V1&HW-CC-Date=20261009T134731Z&HW-CC-Expire=31536000000&HW-CC-Sign=A1A4054D9A6366E9842924CF751540C0701E6E08DB8BC626694C57AA78F1B72C "点击放大") 5. 在总览与测试专项区域，点击"兼容性"页签，可查看被测应用或元服务在兼容性方面的测试详情（包含测试总项、测试通过率、通过项、不通过项、警告项），以及问题类型、设备型号、系统版本、屏幕分辨率等分布情况。 兼容性测试支持的检测项和检测标准见下表。 |**检测项**|**说明**| |:-------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |安装|检测被测应用是否能够正常安装在其支持的OS版本或设备上。若可正常安装，则判断为通过；反之，则判断为不通过。| |启动|检测被测应用或元服务在其支持的OS版本或设备上是否出现无法启动、不能进入应用首页的情况。一般我们会对应用进行多次启动，任何一次出现上述问题均会被认为启动失败，判断为不通过。| |卸载|检测被测应用在其支持的OS版本或设备上安装后，是否能够正常卸载且未出现文件、数据和进程残留。若可正常卸载且不存在残留，则检测为通过；反之，则检测为不通过。| |崩溃|检测被测应用或元服务在其支持的OS版本或设备上运行过程时是否出现JsCrash崩溃异常。若未出现，则判断为通过；反之，则判断为不通过。| |无响应|检测被测应用或元服务在其支持的OS版本或设备上运行时是否出现无响应异常。若未出现，则判断为通过；反之，则判断为不通过。| |白屏|检测被测应用或元服务在其支持的OS版本或设备上运行时页面是否存在非设计的白屏。若出现，则判断为不通过；反之，则通过。| |无法回退|检测被测应用或元服务在其支持的OS版本或设备上运行时，进入某个页面后是否无法退出该页面且无法退出应用，只能强杀进程关闭。若出现，则判断为不通过；反之，则通过。| |输入一致|仅支持折叠屏。 检测被测应用或元服务在折叠屏上进行折叠态和展开态切换时是否出现输入内容丢失异常情况。若未出现，则判断为通过；反之，则判断为不通过。| |任务连续|仅支持折叠屏。 检测被测应用或元服务在折叠屏的展开态进行横竖屏切换时是否出现任务中断异常情况。若未出现，则判断为通过；反之，则判断为不通过。| |设计约束|检测被测应用或元服务在如下方面是否满足要求： * 应用/元服务需配置其支持运行的最小和目标OS版本对应的SDK版本号。 * 应用需要支持64位so文件。 * 应用/元服务安装无兼容性问题。 * 应用/元服务升级后所带卡片名称不建议更改。 * 应用在申请权限时，需要在项目的配置文件中，逐个声明需要的权限。 * 应用/元服务需要明确支持的设备类型。 * 应用/元服务[程序包结构](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/application-package-structure-stage)应符合规范。 * 所有HAP包的配置文件中bundleName、versionCode标签保持一致。 * 应用/元服务bundleName不可缺省。 * 应用/元服务versionCode不可缺省。 * 应用/元服务需要有图标。 * 应用仅支持非免安装。 * 元服务仅支持免安装。 * 元服务预加载对应模块类型不能为entry。 * 元服务需要合理设计申请手机号授权功能（**仅自定义测试场景下的兼容性测试支持该检测项**）。 * 元服务内所有包总和大小不超过10MB。 * 元服务单个包文件（包含其依赖的所有共享包）大小不超过2MB。 * 元服务禁止使用so文件。 * 卡片配置、卡片声明所支持的尺寸规格（参见supportDimensions字段取值范围）、卡片默认尺寸规格、卡片刷新方式应符合规范。具体详情请参见[卡片的配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-ui-widget-configuration)。 * 卡片isdefault字段不可缺省。 * 卡片描述以索引展现。 * 卡片的显示名称有意义。 若某一项不符合要求，则判断为不通过；若全部符合要求，则通过。| |音频规格|检测被测应用或元服务在以下场景是否满足要求： * 在音视频静音播放场景下，应用/元服务在静音播放时需采用share音频焦点策略，不得打断其他音频业务播放。 * 在短音、瞬态音播放场景下，应用/元服务需采用share、duck或pause音频焦点策略，实现与其它音频业务并发播放或短暂暂停后台音乐、听书等音频业务播放，不得打断其它音频业务并使其无法自动恢复播放。| |华为账号|检测集成华为账号能力（例如华为账号一键登录、华为账号登录或静默登录）的应用或元服务的登录功能实现是否正确。若登录功能实现正确且完整可用，则判断为通过；反之，则判断为不通过。 > 说明 > 仅自定义测试场景下的兼容性测试支持该检测项。| |2in1设备兼容|检测支持2in1设备的应用或元服务使用鼠标、键盘、触控板操作时是否出现功能异常和兼容性问题。若出现，则判断为不通过；反之，则通过。| |华为支付|检测集成华为支付能力的应用或元服务在以下场景是否满足要求： * 在商户基础支付场景下，支付页面需包含金额、余额、其他付款方式和确认支付等内容。 * 在免密支付/代扣场景下，支付页面需包含金额、余额、其他付款方式和签约产品等内容。 > 说明 > 仅自定义测试场景下的兼容性测试支持该检测项。| ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/de/v3/uCQlHSw9R6OxLjWRMOKxNA/zh-cn_image_0000002748529103.png?HW-CC-KV=V1&HW-CC-Date=20261009T134731Z&HW-CC-Expire=31536000000&HW-CC-Sign=1218C8ABE599556E01C161BFDF2F7EE629BCE1FBEEF82883E69D58718C59E164 "点击放大") > 说明 > > 测试通过率的计算公式如下： > > 测试通过率 = 通过项/测试总项。其中，测试总项包括通过项、警告项和不通过项，测试结果表格中显示"--"的未检测项不计入测试总项。 6. 点击问题汇总区域的"按问题"页签，可查看被测应用存在的兼容性问题列表，并支持通过"测试结果"、"问题类型"下拉框进行问题筛选。点击对应问题"操作"列的"说明文档"可查看该检测项详细的检测标准。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/68/v3/u3iveRY6SkqeSQm_zgne4g/zh-cn_image_0000002719089204.png?HW-CC-KV=V1&HW-CC-Date=20261009T134731Z&HW-CC-Expire=31536000000&HW-CC-Sign=B190C262E846F99AF966954131A7DE9A99E4DFE30B4DB1AE67C54FD4B84A9467 "点击放大") 7. 点击问题汇总区域的"按机型"页签，可查看被测应用在所选测试设备上各检测项的具体执行情况，并支持通过"测试结果"、"系统版本"或"设备类型"下拉框进行筛选。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b5/v3/-u3RIhL8RLmYSFrvUZTr4w/zh-cn_image_0000002748609187.png?HW-CC-KV=V1&HW-CC-Date=20261009T134731Z&HW-CC-Expire=31536000000&HW-CC-Sign=6D819366CFD817CACCECEEC62E3AD05C45D05EEF53AC8EDCD6553A2EBF30CBE5 "点击放大") 8. 点击某款测试设备"操作"列的"查看详情"，将打开被测应用在这款机型上执行的测试详情。该测试报告详情中包含兼容性测试时间、测试时长、被测应用信息、运行被测应用的测试设备、测试结果等信息，同时重点提供测试发现的问题项、问题详情、问题描述、异常日志和问题截图。 点击页面右上角的"下载录屏"，可将测试过程录屏文件下载到本地进行查看。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/05/v3/Sc0I4OM1QzqpGjtLLYjMmw/zh-cn_image_0000002719089202.png?HW-CC-KV=V1&HW-CC-Date=20261009T134731Z&HW-CC-Expire=31536000000&HW-CC-Sign=63EF65DC070189836F3F7855289B5C360D0A9BD61417541A3C4F12E6D6B38B73 "点击放大") 9. 当检测到应用存在兼容性问题时，"问题详情"页签左侧会列出所有发现的错误及警告。点击这些错误或警告，可查看对应的问题描述和问题截图。 例如，下图中检测到该应用出现了安装失败异常，点击左侧的"安装失败"错误，页面右侧"问题详情"区域将显示该错误的详细说明。点击"质量标准"处的"详情"，可查看兼容性体验建议或相关说明文档。如果存在异常信息，点击错误或警告后，"异常日志"处也会展示异常堆栈信息。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a5/v3/jOs3wUPURQGSGZXTHs-NPg/zh-cn_image_0000002718929280.png?HW-CC-KV=V1&HW-CC-Date=20261009T134731Z&HW-CC-Expire=31536000000&HW-CC-Sign=FB9F5E2EED066BFE3B654A399FCB7FDC30AF3B4990A7BEB5DDA964B9BAE5ED8E "点击放大") 10. 点击"日志文件"页签，测试过程中生成的日志片段以表格形式列出。您可以点击某个日志片段"操作"列的"下载"，将其下载到本地查看。存在多个日志片段时，可点击"全部下载"一次性下载所有日志片段。 ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1/v3/mTe0UAzlREyZqK2MXic6Cg/zh-cn_image_0000002748529101.png?HW-CC-KV=V1&HW-CC-Date=20261009T134731Z&HW-CC-Expire=31536000000&HW-CC-Sign=DA3A2A53590A05730F0E3326EE0BC9806B6F10F725BEE5C10B2A46D51C44BF03 "点击放大")