鸿蒙 PC × Electron:自由窗口、DPI、多屏与自绘标题栏
欢迎加入开源鸿蒙PC社区:https://harmonypc.csdn.net/
欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper
配套工程源码(墨记 MoJi):https://atomgit.com/gcw_TvBBemqt/moji-electron-ohos
验证环境:HUAWEI MateBook Pro S(MOR-M1),HarmonyOS 7.0.0.111(SP15C00E101R9P2),API 26,aarch64(2in1),HongMeng Kernel 1.13.0。运行时 Electron 40.0.1-release / Chromium 144.0.7559.76 / Node 24.11.1。应用版本 v1.0.0(本篇窗口数据采集于该版本;现行工程为 1.1.0 / versionCode 1100000),签名 HAP 219,800,284 B(v1.0.0 构建产物)。
第 1 篇只验证了窗口能开,第 2 篇把首启拆成四段。这一篇处理窗口开出来之后的账:默认多大、最小多大、用户改过之后怎么记住、系统缩放 1.9 倍时逻辑像素和物理像素怎么换算、第二块屏还没接上时哪些结论不能下,以及 v0.2 做过的自绘标题栏和置顶实验为什么没有进 v1.0。
这一篇的环境、路径和窗口数据都来自鸿蒙 PC 本机:开发、构建、装机和调试在同一台机器上完成,不需要切换到别的系统。窗口这一层跑通,是「在鸿蒙 PC 上开发鸿蒙应用」这条主线成立的一部分。
先给结论:v1.0 是一个保留系统标题栏的自由窗口应用。它记住主窗口的尺寸和位置,最小 900×620,默认 1180×760;诊断页这次记录的窗口是 1602×1031,显示器 1642×1094、缩放 1.899999976158142 倍、工作区 1643×1029、只有一块屏。自绘标题栏和置顶是 v0.2 的窗口实验,截图还在,但没有作为 v1.0 的功能发布。
1. 结论表
| 项目 | 实测值 | 出处 |
|---|---|---|
| 应用版本 | 1.0.0(现行 1.1.0) | 诊断页「应用版本」 |
| 签名 HAP | 219,800,284 B(v1.0.0 构建) | 构建产物 |
| 默认窗口 | 1180×760 | ohos-env.js 的 windowOptions() |
| 最小窗口 | 900×620 | 同上,minWidth / minHeight |
| 本次诊断窗口 | 1602×1031 | 诊断页「窗口尺寸」 |
| 窗口位置 | 42, 36 | 诊断页「窗口位置」 |
| 内容区 | 1602×1031 | 诊断页「内容区」 |
| 显示器逻辑尺寸 | 1642×1094 | 诊断页「显示」 |
| 缩放因子 | 1.899999976158142 | 诊断页「显示」 |
| 工作区 | 1643×1029 | 诊断页「工作区」 |
| 显示器数量 | 1 块 | 诊断页「显示器」 |
| 页面缩放 | 1x | 诊断页「缩放」 |
| 冷启四段 | 111 / 20 / 33 / 671 ms | 诊断页「启动四段」 |
| 冷启总耗时 | 877 ms | 诊断页 |
| 进程 RSS | 345.4 MB | 诊断页「内存」 |
| 已存窗口状态 | 1602×1031 | 诊断页「已存状态」 |
| 数据目录 | /data/storage/el2/base/files/moji | 诊断页「墨记数据」 |

这张图是 v1.0 的三栏主界面,左侧 5 篇笔记,收藏和回收站都是 0,右侧当前笔记 226 字。它证明窗口、列表、编辑器、预览四块在同一屏内,没有横向滚动;标题栏是系统画的,不是应用自绘。注意这张图是 10:01 的状态,收藏为 0、标题右侧星标是空心;本篇另一张诊断页截图拍摄于 11:25,其间点过一次收藏,所以那张显示收藏 1 篇。两张图不是同一时刻,数字不同不是矛盾。
这张表里有三个数字容易被误读,先把它们分开。
第一,111+20+33+671 等于 835,不等于 877。差的 42 ms 不是漏打点,而是渲染层 boot:renderer-ready 到达主进程的时间。诊断页的总耗时取 rendererReady、firstPaint、windowShown 里最大的那个,四段之和只统计主进程的四个节点,所以总耗时可以大于四段之和。第 2 篇已经说明过这个口径,这一篇继续沿用,不把差额摊进任何一段。
第二,显示器 1642×1094 是逻辑像素,截图 3120×2080 是物理像素。两者不是一回事,中间隔着 1.9 倍缩放。1642×1.9 等于 3119.8,1094×1.9 等于 2078.6,四舍五入就是 3120×2080。截图尺寸和诊断页的显示尺寸能对上,说明这条链路没有额外的二次缩放。
第三,窗口 1602×1031 比默认的 1180×760 大,是因为它读取了上一次保存的状态,不是默认值被改了。诊断页「已存状态」也是 1602×1031,两处一致。默认值只在没有可用的 window-state.json 时生效。
2. 四个尺寸口径
2.1 默认值不是硬编码在窗口构造函数里
窗口参数收在 src/main/ohos-env.js 的 windowOptions():
const base = {
width: 1180,
height: 760,
minWidth: 900,
minHeight: 620,
backgroundColor: '#f5f7fa',
show: false,
title: '墨记',
webPreferences: {
preload: path.join(__dirname, '..', 'preload', 'index.js'),
contextIsolation: true,
nodeIntegration: false,
sandbox: false,
spellcheck: false,
webviewTag: false,
},
};
createWindow() 会先把持久化的 bounds 合并进来,再传给 BrowserWindow。所以构造函数里的 1180×760 只是兜底,真正生效的是「保存状态优先、没有状态才用默认值」。win:set-size 里还有一份 1180×760 的兜底,用来处理渲染层传入空对象的情况。
默认值的选择理由不复杂:1180 的宽度下,左侧 220 px、中间 300 px、右侧还剩 660 px,三栏都不挤;760 的高度能放下工具栏、编辑区和状态栏。最小 900×620 是再小就会让中间列表折行、右侧预览出现横向滚动的临界值。这两个数字在 minWidth / minHeight 和 win:set-size 的 clamp 里各出现一次,改的时候要一起改。
2.2 保存状态先做合法性检查
readSavedWindowState() 不是读到什么就用什么。它先检查四个数是不是有限数,再检查宽高是否低于 900×620,最后用 screen.getDisplayMatching() 找到窗口所在的显示器,把宽高裁到工作区,把 x/y 夹到工作区范围内。任何一步失败都返回空对象,回落到默认值。
if (![b.x, b.y, b.width, b.height].every((n) => Number.isFinite(n))) return {};
if (b.width < 900 || b.height < 620) return {};
const display = screen.getDisplayMatching({ x, y, width, height });
const area = display.workArea;
const width = Math.min(Math.round(b.width), area.width);
const height = Math.min(Math.round(b.height), area.height);
const x = Math.min(Math.max(Math.round(b.x), area.x), area.x + area.width - width);
const y = Math.min(Math.max(Math.round(b.y), area.y), area.y + area.height - height);
这段代码解决的是「窗口跑到屏幕外」和「换了一块更小的屏」两个问题。上一版把窗口拖到第二块屏,拔掉显示器后再启动,窗口会出现在不存在的位置,用户看到的是「应用启动了但没有窗口」。现在恢复前先按当前显示器的工作区夹一遍,最坏情况是窗口被挪回主屏,不会消失。
2.3 为什么 ready-to-show 里还要再设一次
鸿蒙 PC 的窗口服务有一个实际行为:构造参数里的尺寸有时不生效,尤其是从持久化状态恢复的时候。代码在 ready-to-show 里显式 setBounds(saved.bounds, false),300 ms 后再设一次:
win.once('ready-to-show', () => {
mark('windowShown');
if (isMain && saved.bounds) {
try { win.setBounds(saved.bounds, false); } catch (err) { /* 记录 warn */ }
}
win.show();
if (isMain && saved.bounds) {
setTimeout(() => {
if (win.isDestroyed()) return;
try { win.setBounds(saved.bounds, false); } catch (err) { /* 记录 warn */ }
}, 300);
}
});
两次设置不是保险起见,是因为第一次设置可能发生在窗口真正显示之前,窗口服务会在显示时按自己的默认尺寸重排一次。300 ms 的第二次设置落在显示之后,能把尺寸拉回来。代价是窗口出现时可能有一帧尺寸不对,视觉上是一次很短的跳变。这一版接受这个代价,没有做「先隐藏、设置完再显示」的更复杂流程。
2.4 保存的触发点
主窗口挂了四个事件:resize、move、maximize、unmaximize,每个都走 400 ms 防抖;close 时取消防抖并立即保存。渲染层还会在 resize 时通过 win:report-size 上报视口尺寸,但主进程有一个 1800 ms 的启动窗口期,启动阶段的上报直接丢弃:
if (Date.now() - (win.__createdAt || 0) < 1800) return;
const w = Math.max(900, Math.round(Number(width) || 1180));
const h = Math.max(620, Math.round(Number(height) || 760));
win.__lastSize = { width: w, height: h };
saveWindowState(win);
启动阶段的 window.innerWidth 不可靠:窗口还没稳定,渲染层拿到的可能是默认尺寸或者 0。1800 ms 之后才接受上报,是为了不让一次错误的视口尺寸覆盖掉正确的持久化状态。
只有主窗口保存状态。window:new 开出来的窗口不写 window-state.json,关闭后不留位置记录。这个取舍是为了避免「打开三个窗口后,下次启动恢复的是最后一个辅助窗口的尺寸」。辅助窗口每次按主窗口的尺寸减 180×120 生成,最小 900×620,最大 1000×680,居中压在父窗口上。
| 触发点 | 延迟 | 写入内容 | 备注 |
|---|---|---|---|
resize | 400 ms 防抖 | x/y/宽/高/最大化 | 连续拖动只写最后一次 |
move | 400 ms 防抖 | 同上 | 移动和缩放共用一个 timer |
maximize | 400 ms 防抖 | 最大化标记 | 尺寸仍取 __lastSize |
unmaximize | 400 ms 防抖 | 最大化标记 | 恢复后的尺寸由事件补齐 |
| 渲染层上报 | 1800 ms 后生效 | 宽/高 | 启动期上报被丢弃 |
close | 立即 | 同上 | 取消防抖,最后写一次 |
before-quit | 立即 | 主窗口状态 | 应用退出前兜底 |
2.5 落盘文件长什么样
window-state.json 不只有 bounds,还带 maximized 和 updatedAt。写入走 Store.atomicWriteJson(),和笔记正文一样是先写临时文件再 rename,避免写到一半断电留下半个 JSON。读取时 readJson() 解析失败会返回空对象,不会把应用卡在启动阶段。
{
"bounds": { "x": 42, "y": 36, "width": 1602, "height": 1031 },
"maximized": false,
"updatedAt": "2026-11-14T15:12:22.000Z"
}
保存时有一个细节:saveWindowState() 优先用 win.__lastSize,没有才用 win.getBounds() 的宽高。__lastSize 来自两个地方,一是恢复时读到的 saved.bounds,二是渲染层在窗口稳定后上报的视口尺寸。这样做的原因是缩放过程中 getBounds() 可能返回中间态,而 __lastSize 保留的是用户停手后的尺寸。x/y 仍然用 getBounds(),因为位置没有对应的渲染层上报。
maximized 为 true 时,bounds 仍然保存还原后的尺寸,不是最大化后的尺寸。恢复流程是先用 bounds 建窗口,再 maximize();用户点还原时,窗口回到 bounds。这是桌面端窗口状态的常见做法,在鸿蒙 PC 上也能工作,但诊断页这次记录的是 maximized: false,所以最大化恢复路径没有被这张截图覆盖。这一条要在第 24 篇做多窗口时补测。
2.6 为什么恢复要等两次
ready-to-show 里的第一次 setBounds 解决「构造参数没生效」,300 ms 后的第二次解决「显示时被窗口服务重排」。两次之间窗口已经可见,用户可能看到宽度从默认值跳到保存值。这个跳变在 1602×1031 这种大窗口上比较明显,在 1180×760 上不明显。
更彻底的做法是 show: false 之后先设 bounds,等一帧再 show。这一版没有这么做,因为 ready-to-show 本身已经是在首帧之后,再等一帧会把窗口出现时间往后推,和「尽快让用户看到内容」冲突。两害相权,选了「先出现、再纠正尺寸」。如果以后要做无闪烁恢复,可以把两次 setBounds 都移到 show 之前,再用 paintWhenInitiallyHidden 控制首帧,这是另一个实验。
3. 三档窗口尺寸,不是三档页面缩放
设置面板里有三个按钮:标准 1180×760、小窗口 900×620、大窗口 1600×1050。它们调用的是 win:set-size,不是 webContents.setZoomFactor()。这一点需要说清楚,因为「缩放三档」这个说法容易让人以为是网页缩放。
win:set-size 的处理顺序是:取当前窗口 bounds,找到所在显示器的工作区,把宽高分别 clamp 到 [900, workArea.width] 和 [620, workArea.height],如果窗口处于最大化先 unmaximize(),设置 win.__lastSize,setBounds(..., false),最后按 store.settings.zoom 恢复页面缩放。
const width = Math.min(Math.max(900, Math.round(Number(size.width) || 1180)), area.width);
const height = Math.min(Math.max(620, Math.round(Number(size.height) || 760)), area.height);
if (win.isMaximized()) win.unmaximize();
win.__lastSize = { width, height };
win.setBounds({ x, y, width, height }, false);
try { win.webContents.setZoomFactor(store ? store.settings.zoom || 1 : 1); } catch (err) { /* 忽略 */ }
这里有一个和屏幕尺寸有关的实际结果:工作区是 1643×1029,所以「大窗口 1600×1050」的高度会被裁到 1029,实际得到 1600×1029,不是 1600×1050。宽度 1600 小于 1643,保持 1600。按钮文案没有跟着变,因为它写的是请求值,不是结果值。要显示结果值,得把 win:set-size 返回的 bounds 读回来再更新文案,这一版没做。
页面缩放是另一条线。did-finish-load、did-navigate 和 createWindow() 末尾都会执行一次 setZoomFactor(store.settings.zoom || 1)。原因是上一版出现过缩放残留:某个窗口把 zoomFactor 设成 2,重启后新窗口仍然是 2,页面看起来像被放大了一倍,但窗口尺寸没变。现在的做法不是「强制回到 1」,而是「回到用户上一次设置的值」:settings.json 里存着 zoom,没有这一项才落到 1。这份窗口数据采集时 settings.zoom 是 1,所以诊断页「缩放」显示 1x;v1.1 实测把缩放调到 130%(factor=1.3),随后再调到 140%,settings.json 里是 "zoom": 1.4,重启后窗口仍按 140% 打开。
| 入口 | 请求值 | 代码行为 | 本次实测 |
|---|---|---|---|
| 设置「标准」 | 1180×760 | clamp 后 setBounds,zoom=settings.zoom | 未单独点击测量 |
| 设置「小窗口」 | 900×620 | clamp 后 setBounds,zoom=settings.zoom | 未单独点击测量 |
| 设置「大窗口」 | 1600×1050 | 高度被工作区裁到 1029 | 未单独点击测量 |
| 拖拽边缘 | 用户决定 | 400 ms 防抖后持久化 | 诊断窗口 1602×1031 |
| 系统最大化 | 显示器工作区 | maximize(),记录标记 | 诊断页「最大化:否」 |
| 页面缩放 | settings.zoom(本次 1x) | 加载/导航/set-size 后恢复该值 | 诊断页 1x |
「未单独点击测量」不是懒,是因为这一版的诊断页只记录了当前窗口的最终尺寸,没有记录每次点击的请求值和返回值。1602×1031 是用户拖动后保存的状态,不是三个预设按钮的结果。要验证预设,得在诊断页里加一条「最近一次 set-size 请求/返回」的事件,这一版没加,所以文章不编造三组数字。
4. 多窗口:同一个页面,两份状态
「在新窗口打开」由 window:new 处理,参数是笔记 id。主进程 createWindow({ main: false, noteId }) 会加载同一个 index.html,把 id 放进 query:
const loadOptions = noteId ? { query: { note: noteId } } : undefined;
Promise.resolve(win.loadFile(pagePath, loadOptions)).catch((err) => {
const url = pathToFileURL(pagePath);
if (noteId) url.searchParams.set('note', noteId);
win.loadURL(url.toString());
});
渲染层启动时读 ?note=,找不到就退回 settings.lastNoteId,再找不到就选列表第一条。新窗口的尺寸按主窗口减 180×120,最小 900×620,最大 1000×680,位置在主窗口中间。截图里主窗口和辅助窗口并排,辅助窗口更小,右侧仍然是编辑加预览:

这张图证明的是辅助窗口确实加载了同一篇笔记,不是把主窗口截图缩小。两个窗口的标题栏都写着「周会纪要 · 11 月 14 日 · 墨记」,辅助窗口的左侧栏计数也是 5 篇。
多窗口的边界在数据层,不在窗口层。每个窗口是独立的渲染进程,启动时各自调用一次 notes:load,拿到的是各自那一刻的 index.json 和全部正文快照。v1.0 时窗口 A 改了正文并保存,窗口 B 收不到通知;窗口 B 再保存,会用它的旧内容覆盖窗口 A 的结果。v1.1 补了广播:保存成功后主进程 broadcast('note:changed') 发给其它窗口,接收窗口用最新正文和标题刷新编辑器和列表,实测延迟 3 ms。广播解决的是「显示同步」,不是「冲突合并」——两个窗口同时编辑同一篇,仍然没有版本号、没有 updatedAt 比较,后写覆盖先写。截图只能证明两个窗口能同时显示,不能证明它们的内容一致。
| 项目 | 主窗口 | 辅助窗口 |
|---|---|---|
| 是否保存窗口状态 | 是 | 否 |
| 初始尺寸 | 保存状态或 1180×760 | 主窗口减 180×120,夹在 900×620 到 1000×680 |
| 初始位置 | 保存状态或居中 | 主窗口中心 |
| 笔记来源 | lastNoteId 或列表首条 | ?note=<id> |
| 启动时加载 | notes:load 全量 | notes:load 全量 |
| 关闭行为 | 关最后一个窗口才退出 | 只移除自己 |
| 窗口间同步 | v1.1 广播 note:changed(约 3 ms) | 同左,无冲突合并 |
| 是否可多开 | — | 是,windows Set 计数 |
多窗口数量没有上限,windows 是一个 Set,window:new 返回当前数量。实际开三个以上没有测,内存和渲染开销也没有采样。诊断页的 RSS 345.4 MB 是单窗口时的值,不能拿来推算三个窗口。
5. DPI:1.9 倍是怎么落到截图上的
诊断页的「显示」一行是 1642×1094 @ 1.899999976158142x,「工作区」是 1643×1029。这两个值来自 screen.getPrimaryDisplay() 的 size、scaleFactor、workAreaSize。
缩放因子不是整齐的 1.9,而是 1.899999976158142。这是浮点数存储的结果,不是显示错误。做像素换算时不能把它当成精确的 1.9 去反推每一个像素,只能用来解释量级:1642×1.9≈3119.8,1094×1.9≈2078.6,截图 3120×2080 正好落在这个范围。
工作区宽度 1643 比显示器宽度 1642 多 1 px,高度 1029 比 1094 少 65 px。宽度多 1 是取整和边框口径的差,高度少 65 是底部任务栏占掉的空间。窗口最大化时用的是工作区,不是显示器全尺寸;所以最大化窗口的高度不会是 1094,而是 1029 左右。
| 口径 | 数值 | 单位 | 用途 |
|---|---|---|---|
| 显示器逻辑尺寸 | 1642×1094 | 逻辑 px | screen.size |
| 缩放因子 | 1.899999976158142 | 倍 | 逻辑到物理 |
| 显示器物理尺寸 | 约 3120×2080 | 物理 px | 截图 |
| 工作区逻辑尺寸 | 1643×1029 | 逻辑 px | 最大化、窗口夹取 |
| 窗口逻辑尺寸 | 1602×1031 | 逻辑 px | getBounds() |
| 内容区逻辑尺寸 | 1602×1031 | 逻辑 px | getContentBounds() |
| 页面缩放 | 1x | 倍 | getZoomFactor() |
窗口 1602×1031 的高度比工作区 1029 多 2 px。这不是窗口越界,而是 getBounds() 和工作区取整口径的差;诊断页同时显示「内容区 1602×1031」,说明这块窗口的系统装饰没有从内容区里扣掉。桌面端 Electron 的 getContentBounds() 通常会减去标题栏和边框,鸿蒙 PC 这块的口径不一样。写跨平台布局代码时不能假设「内容区一定比窗口小」。
窗口位置 42, 36 也不是居中值。居中会得到 (1642-1602)/2=20、(1029-1031)/2=-1,实际是 42,36,说明这是用户拖动后保存的位置,不是 center() 的结果。诊断页的「已存状态」和「窗口尺寸」一致,进一步说明恢复逻辑生效了。
5.1 1.9 倍不是「放大 90%」
1.9 倍缩放的意思是 1 个逻辑像素对应 1.9 个物理像素,不是「界面放大 90%」。在 CSS 里写 15 px 的字号,物理上占 28.5 个像素;写 1 px 的边框,物理上占 1.9 个像素,会落在两个物理像素之间,由系统做抗锯齿。截图里细边框看起来不是纯一像素的灰线,原因就在这里。
Chromium 暴露给页面的 window.devicePixelRatio 应该也是 1.9 左右。这一版没有把这个值写进诊断页,只写了 screen.scaleFactor。两者理论上一致,但一个是浏览器层、一个是系统层,遇到缩放切换时可能有一帧不同步。要排查「界面突然变大/变小」,应该同时记录 devicePixelRatio 和 scaleFactor,再看 zoomFactor 是不是 1。这一版只记录了后两个,devicePixelRatio 未测。
分辨率 3120×2080 也解释了为什么截图里的文字看起来比 1180×760 窗口里的更清楚:截图是物理像素,页面布局是逻辑像素,两者差 1.9 倍。把截图直接按 1:1 放进文章,读者看到的是物理像素;把窗口尺寸写成 1602×1031,读者看到的是逻辑像素。文章里同时出现这两组数时,必须注明口径,否则会以为窗口有 3120 宽。

这张图把显示尺寸、工作区、窗口尺寸、内容区、缩放、已存状态和启动四段放在同一屏,是这一篇的主要数据来源。图里的启动四段是 111/20/33/671,总耗时 877 ms,RSS 345.4 MB,笔记 5 篇、收藏 1 篇、回收站 0 篇。图左上「应用版本」写的是 1.0.0,和本篇正文的版本口径一致;现行工程是 1.1.0,这张图没有重拍。收藏 1 篇与上一张主界面图的 0 篇的差异,见上一张图下面的说明。
6. v0.2 的自绘标题栏与置顶实验
v1.0 没有自绘标题栏,窗口顶部是系统画的标题栏和最小化/最大化/关闭按钮。自绘标题栏是 v0.2 的「窗口实验」页做的,截图还在,但不能当成 v1.0 的功能。
v0.2 的实验窗口长这样:顶部没有系统标题栏,应用自己画了一条深色标题栏,标题是「墨记 · 自绘标题栏」,下面是「环境基线 / 启动排障 / 窗口实验」三个标签页。窗口内容区的第一屏显示「第一个窗口已经打开」,右侧是 107 ms / 192 ms / 863 ms 三段耗时:

这张图能证明的是:实验窗口自己画了一条标题栏,画面里也没有看到系统标题栏。但它不能证明「系统标题栏被隐藏了」这个机制成立——ohos-env.js 的 frameless 分支只把 preload 换成 frameless.js,并没有往 BrowserWindow 里传 frame: false,而窗口边框要去掉,必须传这个参数。实验页的「能力矩阵」里,framefalse 一栏写的也是「未测」。所以这一条的准确说法是「自绘标题栏已验证,frame: false 未验证」:能画出来是真的,边框是不是被 frame: false 去掉了,没有可复现的证据。拖动、双击最大化、贴边分屏这些行为同样不能从这张图推出。
第二个实验是最大化。窗口铺满工作区,标题栏还在,内容区被拉宽,启动三段变成 113 ms / 25,963 ms / 26,696 ms:

这里的 25,963 ms 不是正常冷启数据,是最大化路径把「窗口创建」这个打点拖到了最大化之后。它说明实验页的打点顺序在最大化场景下不可靠,不能拿来和第 2 篇的 880–941 ms 冷启对比。自绘标题栏在最大化后仍然显示,但标题栏的拖动区、双击最大化、最大化/还原按钮的状态同步都没有测。
第三个实验是置顶。点击「置顶」按钮后,界面显示「已执行」,但窗口状态里的「置顶」仍然是「否」,能力矩阵写「静默失效」,实测值一栏是空的:

这张图是这一篇最重要的失败记录。alwaysOnTop 调用没有抛异常,Promise 也正常返回,但窗口的置顶状态没有变化。也就是说,调用方无法通过返回值判断成功还是失败,只能再读一次窗口状态。这种「静默失效」比直接报错更难排查,因为它不会在日志里留下错误,只会让用户觉得「按钮点了没用」。
v0.2 的能力矩阵还记录了另外几项:setBounds 可用,实测 1182×762;maximize 未测;fullscreen 可用;setZoomFactor 可用,实测 100%;framefalse 未测。实验页显示缩放 1.90x,窗口 1182×762,位置 194,203,显示器 1642×1094,工作区 1643×1029,1 屏。这些数字和 v1.0 诊断页一致,说明窗口服务本身没有换。
| 能力 | v0.2 实验结果 | 证据 | 是否进 v1.0 |
|---|---|---|---|
| 自绘标题栏 | 能画出来;frame: false 未验证 | 自绘标题栏实验图 + 能力矩阵 | 否 |
| 最大化 | 窗口铺满工作区,标题栏保留 | 最大化实验图 | 保留系统最大化 |
| 置顶 | 调用返回成功,状态不变 | 置顶实验图 | 否 |
setBounds | 可用,1182×762 | 能力矩阵 | 是 |
fullscreen | 可用 | 能力矩阵 | 未使用 |
setZoomFactor | 可用,100% | 能力矩阵 | 仅用于重置 1x |
framefalse | 未测 | 能力矩阵 | 否 |
为什么 v1.0 不用自绘标题栏?三个原因。
第一,系统标题栏负责的不只是画三个按钮。拖动、双击最大化、贴边分屏、右键窗口菜单、触控板手势都挂在系统窗口装饰上。自绘之后这些都要自己补,v0.2 只补了「画出来」,没补「拖起来」。
第二,置顶已经出现静默失效,说明窗口管理器对部分属性的支持是不完整的。自绘标题栏依赖的 frame:false 和拖动区,在这个运行时上同样可能部分生效。没有把每一项都测过之前,不适合作为默认形态。
第三,自绘标题栏会让「窗口状态持久化」多一套坐标。系统标题栏的窗口位置是外框坐标,自绘之后拖动区、按钮区、内容区各有一套命中测试,最大化/还原时还要同步图标。v1.0 的窗口状态已经因为「构造参数不生效」需要二次 setBounds,再叠一层自绘,出问题的面太大。
所以 v1.0 保留系统框,ohos-env.js 里虽然有 frameless 分支,会切换到 preload/frameless.js,但 createWindow() 从不传这个参数,mojiEnv.frameless 始终是 false。代码留着是为了以后做开关,不是当前功能。这里还有一处没补:只传 frameless: true 不会去掉系统边框,窗口选项里还需要 frame: false;windowOptions() 里没有这个参数,createWindow() 也没有传,所以「自绘标题栏」这条路目前只走完了「画出自己的标题栏」一半。
这一段还解释了一个界面上的空白:设置面板里没有「自绘标题栏」开关。代码里有 frameless 分支,但没有任何 UI 能打开它,等于这个实验在 v1.0 里只保留了痕迹,没有保留入口。这样处理比留一个半可用开关更稳:用户看不到,就不会打开一个拖动、最大化、置顶都没验证完的窗口形态。
7. 多屏:现在只有一块,结论到此为止
displayList() 会遍历 screen.getAllDisplays(),把每块屏的 id、label、scaleFactor、rotation、bounds、workArea、internal、primary 都返回。诊断页只显示「显示器 N 块」和主屏尺寸,没有逐块列表。本次是 1 块。
一块屏意味着下面这些结论都不能下:
- 窗口从 1.9x 屏拖到 1x 屏,尺寸会不会按逻辑像素保持,还是按物理像素缩放;
- 两块屏缩放不同时,
screen.getDisplayMatching()夹取用的是哪块屏的工作区; - 辅助窗口按主窗口减 180×120 生成,如果主窗口在副屏,辅助窗口会不会跑到主屏;
- 最大化时用的是当前屏的工作区还是主屏的工作区;
- 热插拔显示器后,已保存的窗口位置怎么处理。
代码里有 getDisplayMatching(),说明作者考虑了多屏,但没有第二块屏就没法验证。这一篇不写「支持多屏」,只写「接口按多屏写了,实测一屏」。第 24 篇做多窗口对照阅读时会再碰这块,如果那时能接第二块屏,再补数据。在此之前,所有关于多屏的结论都只到接口层,没有到行为层。
| 多屏项目 | 代码状态 | 实测状态 |
|---|---|---|
| 枚举显示器 | displayList() 已实现 | 1 块 |
| 主屏标记 | display.id === primaryId | 有 |
| 窗口恢复夹取 | getDisplayMatching() | 单屏下生效 |
| 跨屏拖动 | 依赖系统 | 未测 |
| 不同缩放切换 | 无专门处理 | 未测 |
| 显示器热插拔 | 无监听 | 未测 |
| 辅助窗口定位 | 相对主窗口 | 单屏下可用 |
8. 边界与踩坑
| # | 现象 | 原因 | 当前处理 |
|---|---|---|---|
| 1 | 恢复后窗口尺寸不对 | 鸿蒙窗口服务忽略构造参数里的尺寸 | ready-to-show 后 setBounds,300 ms 后再设一次 |
| 2 | 窗口跑到屏幕外 | 保存的位置属于已拔掉的显示器 | 恢复前用工作区夹取 |
| 3 | 启动时窗口闪一下再变大 | 第一次 setBounds 在显示前,显示时被重排 | 接受一帧跳变,没有做延迟显示 |
| 4 | 大窗口按钮得到 1600×1029 | 工作区高度只有 1029 | clamp 到工作区,按钮文案仍写 1050 |
| 5 | 页面被放大 | 旧版本 zoomFactor 残留 | 加载/导航后恢复 settings.zoom(缺省 1) |
| 6 | 辅助窗口关闭后主窗口状态被覆盖 | 只有主窗口保存状态 | 辅助窗口不写 window-state.json |
| 7 | 两个窗口编辑同一篇互相覆盖 | 每个窗口独立加载,无同步 | 未做冲突检测,最后写入者胜 |
| 8 | 置顶按钮显示已执行但没置顶 | alwaysOnTop 静默失效 | v0.2 实验记录,v1.0 不提供 |
| 9 | 最大化后打点异常 | 打点顺序被最大化路径拉长 | 不把 25,963 ms 当冷启数据 |
| 10 | 内容区等于窗口尺寸 | 鸿蒙 getContentBounds() 不减系统装饰 | 布局不假设内容区更小 |
| 11 | 多屏结论缺失 | 只有一块屏 | 写「未测」,不写「支持」 |
| 12 | 窗口状态 2 px 越界 | getBounds() 与工作区取整口径差 | 不视为越界,记录口径 |
这一版在窗口上没做的事:没有做自绘标题栏开关,没有做窗口置顶,没有做窗口冲突合并(v1.1 只有 note:changed 广播),没有做多屏热插拔,没有做页面缩放档位,没有把三档预设的返回值显示在界面上。这些都不影响窗口本身的可用性,但会影响「窗口实验」类文章的复现精度。
下一篇处理文件边界:userData/moji 下面到底有哪些目录、哪些能写、导入导出走的是路径还是 URI、拖拽为什么反而最安全,以及诊断页那条 EPERM 是怎么来的。
参考
- 框架仓库:https://atomgit.com/CPF-Electron/Electron
- 预编译包:https://atomgit.com/CPF-Electron/Electron/releases/tag/v40.0.1
- 第 1 篇:从 367MB 预编译包到第一个能开窗的 HAP
- 第 2 篇:首启排障的四个检查层
- 开源鸿蒙 PC 社区:https://harmonypc.csdn.net/
更多推荐



所有评论(0)