本地上架预检通过，云真机仍报兼容问题：HarmonyOS 上架测试证据怎么分层

HarmonyOS 开发者测试服务既提供本地真机的上架预检，也提供 AGC 云测试的多设备能力。两者目标互补：本地适合快速重现与调试，云侧覆盖更多真实机型。一次本地通过只证明该构建在该设备和该用例集合下通过，不能替代云端设备矩阵，更不能直接等同最终上架审核。

先选证据模式，再开始录制

方案对比

方式	优点	风险
只做本地预检	反馈快	设备覆盖不足
只依赖云端报告	覆盖广	定位迭代较慢
本地修复环 + 云端矩阵 + 审核闭环	证据完整	需统一构建身份

我的选择：采用第三种，所有层级必须引用同一构建摘要，否则“都通过”也无法比较。

复现与取证起点

选择同一签名构建，在本地目标真机完成兼容性、性能、稳定性、UX 与功耗预检，再在云测试选择不同机型重复关键专项。记录 buildDigest、deviceModel、systemVersion、testSuiteVersion、caseCount、passed、failed、notRun、reportId 和 evidenceLevel。对云侧失败项回到本地可复现设备验证，不能混用不同构建报告。

复现记录至少包含设备形态、窗口尺寸、字体或显示配置、关键状态、操作路径和截图时间。只保存一张最终截图，无法解释问题是在布局、状态恢复还是输入阶段发生。

决策依据

本地预检解决快速反馈

设备可控、日志完整，适合高频修复。但设备覆盖有限，报告结论只属于当前环境。

这里必须同时保存输入条件、设备或窗口形态、触发动作和最终可观察状态。工具报告用于缩小范围，任务是否可完成仍由同一条用户路径的读回结果决定。

云测试补充设备矩阵

热门真机提供兼容性、稳定性、性能、功耗、UX 与安全专项。它能暴露特定机型差异，但仍需核对构建和用例版本。

这里必须同时保存输入条件、设备或窗口形态、触发动作和最终可观察状态。工具报告用于缩小范围，任务是否可完成仍由同一条用户路径的读回结果决定。

最终审核需要独立记录

预检报告可用于上架参考和提高效率，不是自动批准。提交身份、审核结论和退回项必须单独保存。

这里必须同时保存输入条件、设备或窗口形态、触发动作和最终可观察状态。工具报告用于缩小范围，任务是否可完成仍由同一条用户路径的读回结果决定。

工程侧模型

type TestEvidence={level:'local'|'cloud'|'review';build:string;failed:number;notRun:number}
function comparable(a:TestEvidence,b:TestEvidence){return a.build===b.build}
function ready(items:TestEvidence[]){return items.every(x=>x.failed===0&&x.notRun===0)&&new Set(items.map(x=>x.build)).size===1}

模型只表达稳定的决策边界，界面组件、窗口事件和工具结果通过适配器接入，避免把设备差异散落在每个页面。

可独立执行的状态断言

function ready(a){return a.every(x=>!x.fail&&!x.skip)&&new Set(a.map(x=>x.build)).size===1}
if(!ready([{build:'A',fail:0,skip:0},{build:'A',fail:0,skip:0}]))throw new Error('同构建证据误判');
if(ready([{build:'A',fail:0,skip:0},{build:'B',fail:0,skip:0}]))throw new Error('异构建报告被混用');

这些断言验证纯状态、几何或边界计算，不代表 API 26 工程已经编译，也不代表真机、模拟器特定镜像或应用市场审核已经通过。

案例一：本地折叠屏通过，云端普通手机报导航遮挡

设备形态与系统版本不同。核对同一 buildDigest，在云端保存失败截图与设备信息，再把该机型加入本地或云回归矩阵。

修复后用原始条件再次执行完整任务，并保留修改前后同一节点的可见性、可操作性和状态对照。

案例二：云测试报告通过，最终审核仍退回权限说明

测试覆盖运行质量，审核还包含合规与资料。把权限声明、隐私链接和审核反馈作为另一层证据，不用运行测试报告替代合规检查。

第二个案例选择不同形态或不同状态，用来证明方案不是对单一截图的局部修补。

封装与复用

封装 ReleaseEvidenceLedger，以 buildDigest 为主键关联本地报告、云设备矩阵、失败复现、资料检查与最终审核收据，任何结论都能回到具体环境。

复用层输出决策和证据，不强行统一所有页面视觉。每个页面仍可保留自身信息层级，但必须满足相同的任务可达性与状态连续标准。

验收清单

• 本地与云端使用同一构建。
• 报告保存设备与系统版本。
• notRun 不能当作通过。
• 云失败项进入固定回归矩阵。
• 审核结果与测试结果分层记录。

验证边界

本文依据当前华为官方文档整理能力与约束，纯状态模型已在本机执行。当前本机 HarmonyOS SDK 为 API 24，且没有连接 HDC 设备，因此 API 26 编译、目标模拟器镜像行为、折叠真机连续性和平台审核结果仍属于待验证项。完成目标环境验证后，应把版本、设备、构建身份和读回结果补入证据包。

官方资料

• HarmonyOS 开发者测试服务
• AGC 云测试业务介绍
• DevEco Studio 场景化体检
• HarmonyOS 应用上架运营流程

最终结论

区分本地真机、云测试设备矩阵与最终审核证据，避免把单环境通过当成全量兼容。 适配不是让截图“看起来差不多”，而是让关键任务在形态变化后依然可见、可操作、可恢复。