【共创稿事节】HarmonyOS 7 自由多窗实战：supportWindowMode + 断点布局，大屏多任务主动接管-平芜编程栈

作本文聚焦 HarmonyOS 7（API 26）的「自由多窗 / 窗口化」能力，把"一个 App 同时开三个窗口、平板像电脑一样拖拽缩放"讲清楚。文中 API 名与接口来自官方文档，运行表现以真机实测为准。

手机上刷着视频、旁边挂着备忘录、再开个文档对照——这种"一屏多窗"在平板上早就是刚需。HarmonyOS 把这套能力分成两路：平行视界是系统给不适配的应用兜底（28 篇讲过），自由多窗则是应用主动声明"我能缩放、能多窗并存"，自己接住布局。V哥这篇讲后者。

一、自由多窗到底是什么

简单说，自由多窗（Free Multi-Window）是 HarmonyOS 在大屏设备（平板、电脑）上提供的窗口化体验：应用不再"占满整屏"或"被系统塞进分屏"，而是可被用户自由拖动、拉伸缩放、和别的窗口并排共存，类似桌面操作系统。它和平行视界的边界：

平行视界：系统级兜底，针对没做横屏/分屏适配的应用，系统左右两栏硬拆，应用基本不感知。
自由多窗：应用级适配，开发者声明支持哪些窗口模式、最小多大、能否缩放，尺寸变化时自己重排布局。

一句话：平行视界是"系统替你分"，自由多窗是"你自己管"。

二、三种窗口模式与设备矩阵

HarmonyOS 把窗口模式归纳为三种，应用通过supportWindowMode声明：全屏fullscreen、分屏split、自由悬浮多窗floating。官方明确默认值["fullscreen","split","floating"]三种全支持；注意floating在手机/折叠屏上是悬浮窗，平板上是悬浮窗+自由多窗，电脑上是自由多窗。

{ "abilities": [ { "name": "EntryAbility", "supportWindowMode": ["fullscreen","split","floating"] } ] }

不声明也不影响系统按默认行为处理，但显式声明能让应用在自由多窗里有确定性表现；想动态修改可调用setSupportedWindowModes()（仅 2in1 与平板可正常调用）。

设备支持矩阵（官方）：手机支持全屏/分屏/悬浮窗、不支持自由多窗；折叠屏多数不支持；平板全支持；电脑支持且自由多窗为默认。结论很直白——自由多窗是平板和电脑的专属能力，适配前用能力查询判断，别在手机上硬开floating指望自由窗。

三、尺寸约束：给窗口划红线

光声明"支持"不够，还得告诉系统窗口"最小多大、最大多大"，否则用户拉到畸形比例布局就崩。系统给两条路：module.json5 的 metadata 声明（系统红线），或代码setWindowLimits动态设置（更灵活）：

import{window}from'@kit.ArkUI';letwin=window.getLastWindow(this.context);win.setWindowResizeable(true);// 允许通过拖拽缩放win.setWindowLimits({minWidth:320,maxWidth:1200,minHeight:480,maxHeight:1600});// 尺寸红线（单位以官方 window 参考为准）

这些边界是硬红线——但真正的自适应还得靠代码，声明只是兜底。

四、主动适配三步（含真实 API）

4.1 监听尺寸与状态变化

win.on('windowSizeChange',(size:window.Size)=>{constwidth=px2vp(size.width);this.breakpoint=calcBreakpoint(width);// 选 xs/sm/md/lg/xl 重组 GridRow/GridCol});win.on('windowStatusChange',(type:window.WindowStatusType)=>{// 模式切换（最大化 / 最小化 / 自由多窗）时切换列表-详情布局});constrect=win.getWindowProperties().windowRect;// 首屏尺寸建议 onPageShow 取

两个官方提示：模式变化时系统尺寸未刷新，新尺寸要在windowSizeChange回调里取；首屏尺寸在onPageShow取，别在aboutToAppear取（窗口不可见时值不准）。

4.2 用断点布局接住任意宽度

自由多窗的本质是"窗口宽高不确定"，布局必须响应式。用GridRow/GridCol的断点（xs/sm/md/lg/xl）做多列自适应，宽了多列、窄了堆叠——这是"一多"工程底线（呼应 35 篇）：320vp 能看、1200vp 不乱。

4.3 折叠屏展开/折叠也要接

import{display}from'@kit.ArkUI';display.on('foldStatusChange',(status:display.FoldStatus)=>{// EXPANDED / FOLDED / HALF_FOLDED：配合窗口宽决定单栏或多栏});

官方提醒：要拿折叠后的屏幕宽高，用foldDisplayModeChange更稳，foldStatusChange可能因时序拿到错误宽高。

五、工程纪律与坑

别只配限制：红线不等于这些尺寸下好看，真布局还得靠断点代码兜住。
尺寸变化要防抖：windowSizeChange拖拽时高频触发，重排逻辑要轻量或做节流。
设备支持要判：自由多窗是平板/电脑专属，手机不支持，别硬开 floating。
多窗状态隔离：同一应用开多个自由窗口时，各实例状态要独立，别共享单例导致串窗。
折叠态与窗口宽一起算：两个监听结合看，只看一个会漏判。

六、和前面篇章的关系

自由多窗是第 28 篇平行视界的"主动版"：28 是系统兜底，39 是应用接管；它依赖第 35 篇的断点自适应，第 38 篇接续则管"跨设备续干"——多窗管同屏多任务，接续管跨设备续干，是 HarmonyOS 7 "全场景多设备"主线的两枚齿轮。

七、什么时候接

平板、电脑、折叠屏上的文档、笔记、邮件、社交通讯这类应用，V哥建议把自由多窗列为适配必做：用户能把应用拖成任意大小并排干活，体验从"手机放大版"升级到"桌面级"。成本主要是断点重构，但这是"一多"工程一次投入全设备受益的长期资产。

参考与出处

以下为本文涉及的官方文档与能力说明，建议以官方最新版本为准。

窗口模式（supportWindowMode / 三种窗口模式 / 设备支持矩阵）：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-multi-device-window-mode
窗口管理（window API：setWindowResizeable / setWindowLimits / windowSizeChange / windowStatusChange）：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-window
折叠屏开发实践（foldStatusChange / FoldStatus / foldDisplayModeChange）：https://developer.huawei.com/consumer/cn/doc/best-practices-V14/bpta-foldable-guide-V14
屏幕属性查询及状态监听（display API 指南）：https://developer.huawei.com/consumer/cn/doc/HarmonyOS-Guides/screenproperty-guideline
HarmonyOS 7 新能力一览（自由多窗 / 窗口化）：https://developer.huawei.com/consumer/cn/features/

最后一句：自由多窗不是"系统帮你分屏"的兜底，而是应用自己声明规矩、自己接住任意尺寸主动重排——HarmonyOS 7 把窗口主动权交还开发者，剩下的"怎么在 320 到 1200 之间都好看"，才是大屏适配要练的内功。