前言折叠屏设备是HarmonyOS的重要特色屏幕状态变化时需要动态调整UI布局。pura/harmony-utils的DisplayUtil封装了屏幕变化监听方法帮助开发者实时感知屏幕状态变化实现折叠屏适配。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解帮助开发者快速掌握并应用到实际项目中。一、DisplayUtil监听核心APIDisplayUtil提供了以下屏幕变化监听方法方法说明参数使用场景onDisplayChange(callback)监听屏幕变化() void折叠屏适配offDisplayChange(callback)取消屏幕变化监听() void释放资源isFoldable()判断是否折叠屏设备无设备类型判断getFoldStatus()获取折叠状态无布局切换1.1 核心特性实时感知屏幕变化时立即触发回调折叠屏支持专门支持折叠屏状态检测回调机制基于回调函数的事件驱动模式生命周期安全支持注册和取消避免内存泄漏1.2 折叠屏状态对照折叠状态说明布局建议展开大屏模式多列布局、详情列表折叠小屏模式单列布局、简洁展示半折叠桌面模式特殊适配二、完整使用步骤2.1 安装依赖ohpminstallpura/harmony-utils2.2 监听屏幕变化import{DisplayUtil}frompura/harmony-utils;privatedisplayCallback(){letwidthDisplayUtil.getWidth();letheightDisplayUtil.getHeight();this.result屏幕变化:${width}x${height};};aboutToAppear(){DisplayUtil.onDisplayChange(this.displayCallback);}aboutToDisappear(){DisplayUtil.offDisplayChange(this.displayCallback);}2.3 折叠屏检测Button(检测折叠屏).width(100%).onClick((){try{letfoldableDisplayUtil.isFoldable();this.result折叠屏:${foldable?是 ➡️:否};}catch(e){this.result异常: e;}})三、完整页面示例import{DisplayUtil}frompura/harmony-utils;EntryComponentstruct DisplayListenerDemo{Stateresult:string;privatedisplayCallback(){letwidthDisplayUtil.getWidth();this.result屏幕变化: 宽度${width}vp;};aboutToAppear(){DisplayUtil.onDisplayChange(this.displayCallback);}aboutToDisappear(){DisplayUtil.offDisplayChange(this.displayCallback);}build(){Column({space:12}){Button(检测折叠屏).width(100%).onClick((){try{letfoldableDisplayUtil.isFoldable();letwidthDisplayUtil.getWidth();this.result折叠屏:${foldable}\n宽度:${width}vp;}catch(e){this.result异常: e;}});Text(this.result).fontSize(14).fontColor(#333333)}.padding(16)}}四、进阶用法4.1 折叠屏自适应布局import{DisplayUtil}frompura/harmony-utils;Statecolumns:number1;aboutToAppear(){this.updateLayout();DisplayUtil.onDisplayChange(()this.updateLayout());}updateLayout(){letwidthDisplayUtil.getWidth();this.columnswidth600?2:1;}4.2 折叠状态日志记录import{DisplayUtil,LogUtil}frompura/harmony-utils;DisplayUtil.onDisplayChange((){letstatusDisplayUtil.getFoldStatus();LogUtil.info(折叠状态变化:${status});});五、注意事项回调引用注册和取消监听需使用同一回调引用生命周期页面销毁时务必取消监听性能屏幕变化回调中避免耗时操作初始化依赖使用前需确保AppUtil.init()已调用多次触发折叠/展开过程中可能多次触发回调六、常见问题Q1: 非折叠屏设备需要监听屏幕变化吗建议也监听因为屏幕旋转等场景也会触发变化。Q2: getFoldStatus()在非折叠屏设备上返回什么返回无效状态建议先通过isFoldable()判断是否折叠屏。Q3: 回调中可以直接更新UI吗可以回调在主线程执行可以直接更新状态变量。Q4: 折叠过程中回调触发几次可能触发多次建议在回调中使用防抖处理避免频繁更新。总结DisplayUtil的屏幕变化监听方法为折叠屏适配提供了实时感知能力。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。开发者可以根据屏幕状态动态调整布局确保应用在折叠和展开状态下都有良好的用户体验。本文基于pura/harmony-utils工具库更多功能请参考官方文档与后续系列文章。