页面没有报截断短屏上确认按钮却消失了HarmonyOS 7 怎么验关键任务始终可达DevEco Studio 26.0 场景化体检把“截断”纳入多设备检测官方多设备指南也明确提醒短屏高度受限时要保证关键区可见并支持滚动。但最难发现的不是文字少一行而是页面看起来完整确认按钮、错误提示或下一步入口落在可操作区域之外。短屏验收应该围绕任务终点而不是围绕某个组件是否超出边界。问题怎么复现准备一个包含标题、说明、表单、错误提示和底部确认按钮的页面。分别在普通手机、短屏窗口和软键盘弹出状态下执行“填写错误值、修正、提交”。记录 viewportHeight、keyboardHeight、headerHeight、contentHeight、actionTop、scrollOwner、focusedField 和 submitVisibleRatio。若用户能看见输入框却无法在不丢失焦点的情况下找到确认按钮任务可达性失败。复现记录至少包含设备形态、窗口尺寸、字体或显示配置、关键状态、操作路径和截图时间。只保存一张最终截图无法解释问题是在布局、状态恢复还是输入阶段发生。机制拆解先算关键区预算可用高度等于窗口高度减去系统避让、键盘、固定头部和固定底部。正文可以滚动关键动作必须有明确归属不能同时被多个容器截断。这里必须同时保存输入条件、设备或窗口形态、触发动作和最终可观察状态。工具报告用于缩小范围任务是否可完成仍由同一条用户路径的读回结果决定。滚动只能有一个主所有者页面外层和表单内层同时滚动时焦点跳转常把按钮留在错误容器之外。确定主滚动容器错误定位与键盘避让都驱动同一容器。这里必须同时保存输入条件、设备或窗口形态、触发动作和最终可观察状态。工具报告用于缩小范围任务是否可完成仍由同一条用户路径的读回结果决定。验收终点是动作可执行体检报告发现布局风险后还要跑任务断言错误出现时可读修正后按钮可见点击后状态变化。截图只证明一个时刻。这里必须同时保存输入条件、设备或窗口形态、触发动作和最终可观察状态。工具报告用于缩小范围任务是否可完成仍由同一条用户路径的读回结果决定。案例一软键盘弹出后按钮被推到屏幕外不要简单把整个页面上移。计算键盘与按钮区域的重叠量驱动主滚动容器滚到“焦点字段 错误提示 确认按钮”可共同理解的位置键盘关闭后保留合理阅读位置。修复后用原始条件再次执行完整任务并保留修改前后同一节点的可见性、可操作性和状态对照。案例二短屏中说明文字把主操作挤到第二屏把说明区设为可折叠的次要信息保持任务标题、当前字段和主操作优先但不能直接隐藏错误原因。验收展开/收起两种状态下内容仍可访问。第二个案例选择不同形态或不同状态用来证明方案不是对单一截图的局部修补。方案对比方式优点风险固定压缩所有间距改动快可读性和点击热区下降给页面随意加滚动内容可见嵌套滚动与焦点错乱关键区预算 单滚动所有者 任务断言可解释需要重构页面层级我的选择采用第三种。允许视觉随空间收缩但不允许任务入口失去可达性。工程侧模型type ViewBudget{viewport:number;keyboard:number;system:number;fixed:number} function available(v:ViewBudget){return Math.max(0,v.viewport-v.keyboard-v.system-v.fixed)} function needsScroll(v:ViewBudget,content:number){return contentavailable(v)}模型只表达稳定的决策边界界面组件、窗口事件和工具结果通过适配器接入避免把设备差异散落在每个页面。可独立执行的状态断言function available(v){return Math.max(0,v.viewport-v.keyboard-v.system-v.fixed)} if(available({viewport:700,keyboard:300,system:48,fixed:96})!256)throw new Error(可用高度计算错误); if(!(520available({viewport:700,keyboard:300,system:48,fixed:96})))throw new Error(滚动需求漏判);这些断言验证纯状态、几何或边界计算不代表 API 26 工程已经编译也不代表真机、模拟器特定镜像或应用市场审核已经通过。封装与复用封装 ViewportBudget、TaskAnchor 与 ReachabilityProbe。页面注册主操作和错误锚点适配器统一处理窗口、键盘和系统避让变化。复用层输出决策和证据不强行统一所有页面视觉。每个页面仍可保留自身信息层级但必须满足相同的任务可达性与状态连续标准。验收清单短屏与键盘状态同时覆盖。页面只有一个主滚动所有者。错误提示和主操作都能被焦点导航到。点击热区不因压缩而变小。以完整任务成功而非截图通过作为结论。验证边界本文依据当前华为官方文档整理能力与约束纯状态模型已在本机执行。当前本机 HarmonyOS SDK 为 API 24且没有连接 HDC 设备因此 API 26 编译、目标模拟器镜像行为、折叠真机连续性和平台审核结果仍属于待验证项。完成目标环境验证后应把版本、设备、构建身份和读回结果补入证据包。官方资料DevEco Studio 场景化体检鸿蒙应用多设备通用适配指南多设备适配开发助手多设备预览器总结用关键区预算、滚动归属和任务终点断言解决短屏上的“内容都在但操作做不完”。 适配不是让截图“看起来差不多”而是让关键任务在形态变化后依然可见、可操作、可恢复。