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 在手机/折叠屏上是悬浮窗，平板上是悬浮窗+自由多窗，电脑上是自由多窗。

json5 复制代码

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

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

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

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

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

typescript 复制代码

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

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

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

4.1 监听尺寸与状态变化

typescript 复制代码

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

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

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

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

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

typescript 复制代码

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

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

五、工程纪律与坑

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

七、什么时候接

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

参考与出处

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

窗口模式（supportWindowMode / 三种窗口模式 / 设备支持矩阵）：developer.huawei.com/consumer/cn...
窗口管理（window API：setWindowResizeable / setWindowLimits / windowSizeChange / windowStatusChange）：developer.huawei.com/consumer/cn...
折叠屏开发实践（foldStatusChange / FoldStatus / foldDisplayModeChange）：developer.huawei.com/consumer/cn...
屏幕属性查询及状态监听（display API 指南）：developer.huawei.com/consumer/cn...
HarmonyOS 7 新能力一览（自由多窗 / 窗口化）：developer.huawei.com/consumer/cn...

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