文章目录GlobalInfoModel 保存什么ObservedV2 和 Trace 的意义页面里怎么连接StorageKey 避免写错字符串WindowUtil 负责写入数据这套设计好在哪里写在最后这个项目里有个很关键但不太显眼的类GlobalInfoModel。它保存窗口尺寸、断点、安全区高度让不同组件都能拿到同一份设备信息。项目源码https://gitcode.com/HarmonyOS_Samples/SmartReach/tree/masterGlobalInfoModel 保存什么文件在entry/src/main/ets/model/GlobalInfoModel.etsObservedV2exportclassGlobalInfoModel{TracepublicfoldExpanded:booleanfalse;TracepublicwidthBreakpoint:WidthBreakpointWidthBreakpoint.WIDTH_SM;TracepublicheightBreakpoint:HeightBreakpointHeightBreakpoint.HEIGHT_SM;TracepublicnaviIndicatorHeight:number0;TracepublicstatusBarHeight:number0;TracepublicdecorHeight:number0;TracepublicdeviceHeight:number0;TracepublicdeviceWidth:number0;}这不是业务数据而是布局数据。页面要不要多列、顶部留多少、底部避开多少都靠它。ObservedV2 和 Trace 的意义ObservedV2表示这个类可以被观察Trace标记的字段变化后可以触发相关 UI 更新。小白可以先这么理解GlobalInfoModel不是普通对象它是会参与 UI 响应式更新的状态对象。页面里怎么连接MainPage.ets里这样拿LocalglobalInfoModel:GlobalInfoModelAppStorageV2.connect(GlobalInfoModel,StorageKey.GLOBAL_INFO)??newGlobalInfoModel();WaterFlowView.ets里也这样拿LocalglobalInfoModel:GlobalInfoModelAppStorageV2.connect(GlobalInfoModel,StorageKey.GLOBAL_INFO)??newGlobalInfoModel();这就很舒服主页面和内容组件不用互相传一堆参数都从AppStorageV2拿同一份全局信息。StorageKey 避免写错字符串项目没有到处写字符串 key而是放在CommonConstants.etsexportenumStorageKey{UI_CONTEXTSmartReach_sample_UIContext,GLOBAL_INFOSmartReach_sample_GlobalInfoModel,}这个习惯建议保留。全局状态最怕 key 写错编译不一定能帮你发现运行时才发现数据拿不到。WindowUtil 负责写入数据全局状态的来源主要是WindowUtilconstglobalInfoModel:GlobalInfoModelAppStorageV2.connect(GlobalInfoModel,StorageKey.GLOBAL_INFO,()newGlobalInfoModel())??newGlobalInfoModel();globalInfoModel.statusBarHeightWindowUtil.uiContext.px2vp(systemAvoidArea?.topRect?.height??0);globalInfoModel.naviIndicatorHeightWindowUtil.uiContext.px2vp(bottomArea?.bottomRect?.height??0);AppStorageV2.connect(GlobalInfoModel,StorageKey.GLOBAL_INFO,()globalInfoModel);也就是说窗口工具拿到系统信息后写进GlobalInfoModel页面组件再读取它做布局。这套设计好在哪里如果不用全局状态你可能会这样传EntryAbility - MainPage - WaterFlowView - 子组件。层级一多参数会越来越乱。现在的方式是窗口信息统一进入AppStorageV2谁需要谁连接。对于设备信息、主题信息、登录态这类跨页面数据这种写法很顺手。写在最后AppStorageV2在这个项目里不是为了炫技而是为了解决真实问题多个组件都要知道当前设备状态。把GlobalInfoModel看懂后面的断点、安全区、瀑布流布局就都串起来了。