Flutter 鸿蒙电脑三栏窗口适配:修复 desktop_window 尺寸缩水与全屏切换

📦 desktop_window 是控制桌面窗口尺寸、宽高约束和全屏状态的 Flutter 三方库。我用鸿蒙电脑上的三栏示例复现了尺寸缩水、最小宽高写反和全屏无法恢复的问题,并修复了对应的鸿蒙实现。
完整代码已提交 PR 至官方仓库 CPF-Flutter/fluttertpc_desktop_window,有问题可以到仓库提 Issue,也可以来 鸿蒙系统Flutter开源库社区 交流。

前言

我在鸿蒙电脑模拟器上做了一个三栏配置检视示例:左边切换配置项,中间查看说明,右边看窗口调用日志。我希望打开页面后,三栏能并排放下,缩小窗口时也留够宽度,需要专注看内容时还能来回切换全屏,于是接入了 desktop_window 的社区鸿蒙版本。💻

点击“标准三栏 1120×720”后,窗口反而缩小了,页面可用宽度只剩 589.5 vp。接着设最小宽度再压窄,边界没守住;连续切换两次全屏,窗口也没恢复。我对照尺寸回读和系统日志查了源码,发现原生层没有换算像素单位,最小宽高写反了,缩放完成后的回执和全屏恢复也需要修改。

补好后,同一页面能读回 1120 × 720 的窗口逻辑尺寸;请求压窄时,宽度停在设定的 960 vp,第二次切换全屏也回到了浮动窗口。三栏布局没改,变化来自插件对窗口请求的处理。

一、使用场景与原版问题

1.1 三栏示例为什么需要窗口控制

在鸿蒙电脑的浮动窗口里同时看导航、内容和日志,宽度不够时,页面就需要折叠部分内容或提供滚动。我用三栏页面测试这种情况:左栏约 180 vp,右栏约 260 vp,中间随剩余宽度伸缩。用户可以切换三个配置模块,查看窗口参数说明,再用工具栏调整尺寸、设置边界或切换全屏。

图 1 展示了这个页面调整窗口的过程:示例发出请求,插件换算尺寸并处理约束,鸿蒙窗口系统执行操作后返回结果。图中绿色回线概括结果返回页面的方向,实际数据仍经过插件和通道。

鸿蒙电脑三栏页面经插件调用窗口系统并回读结果的流程

图1 窗口调用流程

页面中的配置项是预置数据,右侧日志则来自实际插件调用。我没有在这个 Example 里加入配置文件读取、差异解析或编辑功能,测试集中在窗口本身。需要复现时,读者用配套页面就能执行同样的操作。

我把三栏布局的显示断点定在 900 vp,窗口最小宽度设为 960 vp。低于断点时,页面主动收起三栏,只显示窄窗提示和日志。这两个数值来自示例的布局选择,红色提示也只是页面进入窄窗布局的标记。判断插件有没有处理错,还得对照请求尺寸、系统矩形和回读值。

操作期望的窗口行为检查依据
设置 1120 × 720按逻辑尺寸调整外框系统物理矩形除以屏幕密度
设置最小 960 × 560,再请求 760 × 640保留最小宽度,高度正常调整最小宽高字段与实际矩形
连续切换两次全屏进入整屏后回到原浮动窗口全屏状态、桌面画面和恢复尺寸

表1 操作与预期

三栏怎么排、按钮放在哪里、何时显示告警,都由 Example 决定。鸿蒙窗口系统提供尺寸、约束、装饰栏和全屏接口,desktop_window 负责把 Dart 请求传过去,再把结果交回应用。即使应用换一组断点,或者改为折叠布局,插件仍要按调用方传入的宽高处理窗口。

测量时还有一个容易混淆的地方:getWindowSize() 查询的是窗口外框,Flutter 页面拿到的是内容区尺寸。有系统标题栏时,两者高度本来就不同。我用宽度检查密度换算,比较高度时再扣除标题栏,避免把正常的高度差当作单位错误。

1.2 上游与社区鸿蒙实现分别负责什么

我检查了 desktop_window 上游包、CPF-Flutter 的鸿蒙适配仓,也在 oh-Flutter 组织下检索了相关包名。这个库已经有尺寸、最小最大边界、全屏和装饰栏的静态接口,正好能供示例调用,所以我选择修复现有实现。关闭拦截等窗口事件由 window_manager_plus 这类库处理,本篇只看窗口尺寸与状态。

desktop_window 0.4.4 的 pub.dev 发布页

图2 上游包页面

desktop_window 由 mix1009.com 发布,采用 MIT 许可。pub.dev 上的 0.4.4 列出了 Linux、macOS 和 Windows;我修改的鸿蒙实现来自另一个社区仓库,版本和来源需要分开看。

CPF-Flutter 社区仓库的 master 分支与 ohos 目录

图3 社区原仓

图 3 是我修改的 CPF-Flutter/fluttertpc_desktop_window。社区在上游代码旁加入了 ohos 目录、插件注册和窗口调用。根 LICENSE 沿用上游 MIT,鸿蒙源文件还保留了湖南开鸿智谷的 Apache-2.0 版权头,复用时要一起保留这些声明。

来源版本或分支核对结果
pub.dev 主包0.4.4发布平台不含鸿蒙
CPF-Flutter 鸿蒙仓master,包版本 0.4.2已有鸿蒙实现,可在其基础上修复
oh-Flutter 组织检索 desktop_window 及 fluttertpc_desktop_window本次范围内未找到同名适配仓

表2 仓库版本核查

社区仓有历史同步标签,但没有对应这次 master 基线的标签,我便用具体提交固定测试代码。修复版沿用原包名和社区版本,未升级为上游 0.4.4。第五章给出可直接使用的固定源码依赖,基线与标签的对应关系放在工程说明里。

上游 README 展示了尺寸读写、最小最大尺寸和全屏往返的用法。我对照原生实现后确认,最小宽高交叉赋值是字段映射错误;全屏无法往返则可以用同一宿主、同一组操作复现。至于逻辑像素与窗口外框的关系,下面只讨论这份鸿蒙实现,其他平台的尺寸语义没有在这里一并验证。

1.3 三项实测问题与两项配套加固

我把社区 master 基线和修复版分别接到同一页面,在 MateBook Pro 模拟器的默认浮动窗口中对照。两个包的安装名和被测插件不同,Dart SDK 上限等构建适配保持一致。我从桌面启动应用,依次设置标准尺寸、设置最小约束并压窄,然后切换标题栏和全屏,画面、回读和系统日志里出现了三处问题:

  1. 尺寸单位与完成时机不一致。屏幕密度为 1.90,请求 1120 × 720 后,原版把同样的数值直接当物理像素传给系统,外框折合只有约 589.5 × 378.9 vp,扣掉标题栏后的内容区为 589.5 × 342.1 vp。缩放操作还没完成,插件就发回了成功回执,我紧接着读到的仍是旧矩形。
  2. 最小宽高交叉写入。原版在设置最小尺寸、设置最大尺寸和重置最大尺寸时,都把最小宽度写给最小高度,最小高度写给最小宽度。先设最小 960 × 560,再请求 760 × 640,窗口实际变成 760 × 960 px:宽度小于请求下限,高度却被拉长。
  3. 全屏切换不能往返。原版采用跟随应用沉浸设置的最大化选项。在这个宿主里,窗口只铺到 Dock 上方,全屏查询仍为假。再次切换时,它继续走最大化分支,没有调用恢复接口,因而无法回到浮动窗口。

查源码时,我还补了插件的 2in1 设备声明,用 AbilityAware 绑定前台上下文,并把可捕获的同步、异步错误统一交回 Dart。原版在这次基线测试里能启动,也能取得窗口;声明、上下文和漏回执是源码检查中发现的问题,录像里没有另外触发这些故障。

插件会回传捕获到的异常,但没有给系统 Promise 设置超时。窗口销毁、跨屏拖动和多 Ability 切换也还需要单独做设备验证,现有记录只覆盖这组窗口操作。

二、修复前后的运行效果与量化对比

我把同一份“三栏配置与日志对比检视台”分别打包为 com.example.pgc22base 和 com.example.pgc22fix,对应社区原版与修复版插件。两个包都从模拟器桌面启动,再执行相同的五步操作。测试使用的工具链、系统镜像和屏幕参数如下。

环境项版本与配置参数
Flutter 与 DartFlutter 3.41.9+ohos-1.0.2(Dart 3.11.5)
开发工具与 SDKDevEco Studio 26.0.0 · HarmonyOS SDK API 26(7.0.0)
鸿蒙电脑模拟器MateBook Pro(设备类型 2in1,系统镜像 7.0.0.107)
模拟器屏幕参数物理分辨率 3120 × 2080 px · 逻辑视口 1642.1 × 1094.7 vp · 像素密度 1.90
基线仓库CPF-Flutter/fluttertpc_desktop_window(master 默认分支)

表3 运行验证环境

2.1 原版的尺寸缩水与约束失效

我先运行原版,冷启动后依次点击“标准三栏 1120×720”“最小约束 960×560”和“压窄测试 760×640”。图 4 是压窄后的窗口。

修复前原版插件导致窗口严重缩水与横向失守

图4 修复前窄窗图

这时内容区只有 400.0 × 468.4 vp,页面已经切到窄窗提示布局。getWindowSize() 却读回 760.0 × 960.0,返回的仍是物理像素,与逻辑视口相差近一倍,页面也因此显示单位混用和面板折叠告警。

更直接的证据是最小约束:我已经设置了 960 × 560,随后请求 760 × 640,宽度仍降到了 760 px。高度反而被写反的 minHeight 撑到了 960 px。图 5 录下了从启动、缩放、压窄到两次全屏切换的过程。

原版插件在鸿蒙电脑自由窗口下的连贯故障实录

图5 原版异常动图

动图末尾,我连续点了两次“切换全屏”。第一次,窗口从桌面顶部铺到 Dock 上沿,底部图标栏仍在,页面顶栏和日志里的全屏状态都是假。第二次,窗口闪了一下,又停在最大化尺寸,没有恢复成浮动窗口。

2.2 同条件下的尺寸与全屏恢复

换成修复包,冷启动首帧回调后读到的外框尺寸是 1100.0 × 733.7 vp,已经按 1.90 的密度换算。内容区为 1100.0 × 696.8 vp,少的约 36.8 vp 是系统标题栏。我再点“标准三栏 1120×720”,得到图 6 的窗口。

修复后标准三栏逻辑尺寸精确落位

图6 修复后标准窗

这次窗口按请求展开了,左下角显示“三栏并排就绪” ✅。紧接设置后的即时回读和延时稳定回读都是 1120.0 × 720.0;内容视口为 1120.0 × 683.2 vp,三个栏也都放得下。

接着,我设置“最小约束 960×560”,再点“压窄测试 760×640”,请求宽度比下限小 200 vp,查看插件会怎样处理。

修复后最小宽度约束成功拦截过窄缩放

图7 最小约束钳制

图 7 的窗口宽度停在 960.0 vp(1824 px),没有跟着请求缩到 760 vp。此时生效的最小约束是 1824 × 1064 px;请求高度 640.0 vp(1216 px)在范围内,所以高度照常调整。内容区为 960.0 × 603.2 vp,三栏仍然并排显示。

随后我切换全屏,检查标题栏、Dock 和全屏查询的返回值。

修复后切入整屏无边框沉浸全屏检视

图8 沉浸全屏检视

图 8 中,系统标题栏和底部 Dock 都已隐藏,页面铺满 3120 × 2080 px。外框回读与内容视口同为 1642.1 × 1094.7 vp,日志里的全屏状态为真,边框状态为隐藏。图 9 保留了完整操作过程:第二次点击“切换全屏”后,窗口回到原来的 960.0 × 640.0 vp 浮动尺寸。

修复后自由窗口缩放与全屏进出恢复实录

图9 修复后动图

2.3 WindowManagerService 与 HiLog 系统记录对照

每做完一步,我还导出了 WindowManagerService 中的 WindowRect 和窗口模式,并采集原生 HiLog。这样能把页面看到的变化与系统实际记录的窗口尺寸对上。

修复前后 HiLog 与 WMS 窗口矩形日志对照

图10 窗口日志对照

原版和修复包在这次运行中的窗口号分别是 115、116。我把图 10 的日志与窗口树转储放在一起,整理出下面六个观测点。

操作节点与指标原版基线包修复后补丁包
冷启动 getWindowSize()2090.0 × 1394.0(物理 px 未换算)1100.0 × 733.7(对齐逻辑 vp)
标准三栏 1120×720 即时回读2090.0 × 1394.0(漏等待读到旧值)1120.0 × 720.0(本次即时回读一致)
标准三栏底层物理矩形[515, 281, 1120, 720](面积缩水)[515, 281, 2128, 1368] 🟢↑
设最小 960×560 后底层极值最小宽 560 px、最小高 960 px(写反)最小宽 1824 px、最小高 1064 px 🟢↑
压窄 760×640 后底层物理矩形[515, 281, 760, 960](宽跌至 400.0 vp)[515, 281, 1824, 1216](钳制在 960.0 vp)
连续两次 toggleFullScreen()首次停在 Dock 上沿返假;二次仍未恢复首次整屏 3120 × 2080 返真;二次恢复浮动窗

表4 修复前后对照

最大尺寸和重置操作也单独测了一组。我保留最小 960 × 560(1824 × 1064 px),再调用 setMaxWindowSize(const Size(1280, 820)),系统读到的最小值仍为 1824 × 1064 px,最大值变成 2432 × 1558 px。随后调用 resetMaxWindowSize(),最大值恢复到最初记录的 5472 × 5472 px,最小值没有变化。这组上下限没有冲突,设置冲突值时的处理放在第四章说明。

三、原理剖析与核心代码实现

3.1 分清尺寸单位,再处理调用顺序

顺着前面的回读结果往下查,我需要先把 Flutter 视口和系统窗口外框分开,再确认尺寸在哪一层换算、操作什么时候才算完成。图 11 对应的是修复后的调用过程。

跨端逻辑尺寸与鸿蒙物理窗口极值换算架构

图11 密度换算架构

我先从高度差算起。自由多窗下,getWindowProperties().windowRect 包含顶部系统标题栏。冷启动矩形为 2090 × 1394 px,除以密度 1.90,得到外框 1100.0 × 733.68 vp。标题栏占 70 px,也就是 36.84 vp;Flutter 的 MediaQuery.size 取内容区,所以宽度仍是 1100.0 vp,高度则为 696.84 vp。

隐藏标题栏时,setWindowDecorVisible(false) 让内容区向上占满外框,两者高度才相等。这个差值并不需要靠插件“修正”。页面排版继续使用 Flutter 视口,窗口控制则使用外框尺寸,各自读对应的值。

接着,我检查了 HarmonyOS SDK API 26 的窗口声明:getWindowLimits() 返回的边界和 setWindowLimits() 默认接收的边界都以物理像素计量。这个 MateBook Pro 窗口初始读到的最小值是 608 × 190 px,最大值是 5472 × 5472 px。

因此我把原生层统一到物理像素,用 Math.round(vp * density) 转换请求尺寸后直接写入 WindowLimits 的 minWidth、minHeight、maxWidth、maxHeight 四个标准字段(OpenHarmony 公共窗口声明默认即采用物理像素,不包含 pixelUnit 字段)。密度优先从当前窗口的 win.getWindowDensityInfo() 读取,不可用时再退回默认屏幕。这里测的是单屏、密度 1.90,跨屏后是否需要重设已有约束还没验证。

初始化页面时,应用可能紧接着设置最小尺寸、最大尺寸和当前尺寸。如果前一个异步请求还没结束,后一个请求就读取边界,读到的可能仍是旧值。我在插件里加了 opChain 队列,让这些操作按顺序等待完成。它只管理当前插件实例的调用,用户或其他模块仍可能同时调整窗口。图 12 标出了原版与补丁的几处差异。

原版与修复后核心代码差异对照

图12 源码对照

3.2 补齐 2in1 设备声明与 AbilityAware 上下文生命周期

我先在插件的 ohos/src/main/module.json5 中给 deviceTypes 补上 "2in1",再处理获取窗口的上下文。

DesktopWindowPlugin.ets 通过 onAttachedToEngine 注册通道处理器,类中保存引擎上下文、前台 Ability 上下文、窗口句柄、首次读取的系统边界和操作队列。下面的函数用 AbilityAware 接收前台上下文,替代原版在普通类中调用 getContext(this) 的做法。Ability 解绑时清掉旧句柄,下一次操作再重新取窗口。

  onAttachedToAbility(binding: AbilityPluginBinding): void {
    this.abilityContext = binding.getAbility().context;
    this.windowClass = null;
    this.systemLimitsCaptured = false;
    hilog.info(LOG_DOMAIN, LOG_TAG, 'onAttachedToAbility: UIAbilityContext attached');
  }

  onDetachedFromAbility(): void {
    this.windowClass = null;
    this.abilityContext = null;
    this.systemLimitsCaptured = false;
    hilog.info(LOG_DOMAIN, LOG_TAG, 'onDetachedFromAbility: window handle released');
  }

  private async ensureWindow(): Promise<window.Window> {
    if (this.windowClass != null) {
      try {
        this.windowClass.getWindowProperties();
        return this.windowClass;
      } catch (_) {
        this.windowClass = null;
        this.systemLimitsCaptured = false;
      }
    }
    const ctx: common.Context | null = this.abilityContext ?? this.applicationContext;
    if (ctx == null) {
      throw new Error('No foreground UIAbilityContext is attached.');
    }
    const win: window.Window = await window.getLastWindow(ctx);
    this.windowClass = win;
    if (!this.systemLimitsCaptured) {
      const initLimits: window.WindowLimits = win.getWindowLimits();
      this.systemMaxWidthPx = initLimits.maxWidth ?? 0;
      this.systemMaxHeightPx = initLimits.maxHeight ?? 0;
      this.systemMinWidthPx = initLimits.minWidth ?? 0;
      this.systemMinHeightPx = initLimits.minHeight ?? 0;
      this.systemLimitsCaptured = true;
      hilog.info(
        LOG_DOMAIN,
        LOG_TAG,
        'captured system WindowLimits(px): min=%{public}dx%{public}d max=%{public}dx%{public}d',
        this.systemMinWidthPx,
        this.systemMinHeightPx,
        this.systemMaxWidthPx,
        this.systemMaxHeightPx,
      );
    }
    return win;
  }

3.3 窗口密度读取与尺寸读写换算

拿到窗口后,插件先读密度,再转换尺寸。几个辅助函数分别处理容易出错的输入:vpToPx 四舍五入并保留正整数像素,pxToVp 把回读值保留到两位小数,readPositiveNumber 检查参数是不是有限正数。查询方法读取系统矩形,再换算为 vp 数组返回。密度读取和设置尺寸的代码如下。

  private getDensity(win: window.Window): number {
    try {
      const info: window.WindowDensityInfo = win.getWindowDensityInfo();
      if (info.customDensity && info.customDensity > 0) {
        return info.customDensity;
      }
      if (info.systemDensity && info.systemDensity > 0) {
        return info.systemDensity;
      }
      if (info.defaultDensity && info.defaultDensity > 0) {
        return info.defaultDensity;
      }
    } catch (_) {
      // 回退到默认屏幕密度
    }
    const disp: display.Display = display.getDefaultDisplaySync();
    return disp.densityPixels > 0 ? disp.densityPixels : 1.0;
  }

  private async handleSetWindowSize(call: MethodCall): Promise<boolean> {
    const widthVp = this.readPositiveNumber(call, 'width');
    const heightVp = this.readPositiveNumber(call, 'height');
    const win = await this.ensureWindow();
    const density = this.getDensity(win);
    let targetWidthPx = this.vpToPx(widthVp, density);
    let targetHeightPx = this.vpToPx(heightVp, density);

    // 若窗口处于全屏或最大化态,先恢复为自由浮动窗口再调整尺寸,避免抛 1300010
    const status = win.getWindowStatus();
    if (status === window.WindowStatusType.FULL_SCREEN || status === window.WindowStatusType.MAXIMIZE) {
      await win.recover();
    }

    // 与当前生效的 WindowLimits(px) 取交集钳制,防止超出已设极值时静默失败或抛参异常
    const limits = win.getWindowLimits();
    if (limits.minWidth && limits.minWidth > 0 && targetWidthPx < limits.minWidth) {
      targetWidthPx = limits.minWidth;
    }
    if (limits.minHeight && limits.minHeight > 0 && targetHeightPx < limits.minHeight) {
      targetHeightPx = limits.minHeight;
    }
    if (limits.maxWidth && limits.maxWidth > 0 && targetWidthPx > limits.maxWidth) {
      targetWidthPx = limits.maxWidth;
    }
    if (limits.maxHeight && limits.maxHeight > 0 && targetHeightPx > limits.maxHeight) {
      targetHeightPx = limits.maxHeight;
    }

    await win.resizeAsync(targetWidthPx, targetHeightPx);
    const afterRect = win.getWindowProperties().windowRect;
    hilog.info(
      LOG_DOMAIN,
      LOG_TAG,
      'setWindowSize: reqVp=%{public}sx%{public}s density=%{public}s targetPx=%{public}dx%{public}d actualPx=%{public}dx%{public}d',
      widthVp.toFixed(1),
      heightVp.toFixed(1),
      density.toFixed(2),
      targetWidthPx,
      targetHeightPx,
      afterRect.width,
      afterRect.height,
    );
    return true;
  }

设置尺寸时,插件先做单位换算,必要时恢复浮动窗口,然后按当前上下限裁剪目标值,最后等待缩放 Promise。这次用到的尺寸都恰好能换成整数物理像素,因此回读与请求一致;换成其他密度或小数尺寸,取整仍可能带来误差。

补上 await 后,成功回执会等系统缩放操作完成再发回。不过,Flutter 视口随后还有自己的布局过程,不能把收到回执的时刻当作页面已经渲染完毕。

3.4 修正最小宽高,处理上下限关系

原版的最小宽高写反后,不只是设置最小值时出错,设置或重置最大值时也会带入这组错误字段。我改成每次先读当前生效的边界,再把最小宽、高分别写回各自字段,并等待系统返回。

设置最大值的处理与之对应;如果任一最大尺寸分量小于等于 0,插件会转去重置上限。上下限冲突时,新设的一侧优先,另一侧随之调整。下面是设置最小值和重置最大值的完整函数。

  private async handleSetMinWindowSize(call: MethodCall): Promise<boolean> {
    const minWidthVp = this.readPositiveNumber(call, 'width');
    const minHeightVp = this.readPositiveNumber(call, 'height');
    const win = await this.ensureWindow();
    const density = this.getDensity(win);
    const minWidthPx = this.vpToPx(minWidthVp, density);
    const minHeightPx = this.vpToPx(minHeightVp, density);

    const current = win.getWindowLimits();
    let maxWidthPx = current.maxWidth ?? this.systemMaxWidthPx;
    let maxHeightPx = current.maxHeight ?? this.systemMaxHeightPx;
    if (maxWidthPx > 0 && maxWidthPx < minWidthPx) {
      maxWidthPx = minWidthPx;
    }
    if (maxHeightPx > 0 && maxHeightPx < minHeightPx) {
      maxHeightPx = minHeightPx;
    }

    const nextLimits: window.WindowLimits = {
      minWidth: minWidthPx,
      minHeight: minHeightPx,
      maxWidth: maxWidthPx,
      maxHeight: maxHeightPx,
    };
    const applied = await win.setWindowLimits(nextLimits);

    // 若当前浮动窗口窄于新设最小尺寸,立即撑开至最小约束阈值
    if (win.getWindowStatus() === window.WindowStatusType.FLOATING) {
      const rect = win.getWindowProperties().windowRect;
      const effMinW = applied.minWidth ?? minWidthPx;
      const effMinH = applied.minHeight ?? minHeightPx;
      if (rect.width < effMinW || rect.height < effMinH) {
        await win.resizeAsync(Math.max(rect.width, effMinW), Math.max(rect.height, effMinH));
      }
    }

    hilog.info(
      LOG_DOMAIN,
      LOG_TAG,
      'setMinWindowSize: reqVp=%{public}sx%{public}s appliedMinPx=%{public}dx%{public}d appliedMaxPx=%{public}dx%{public}d',
      minWidthVp.toFixed(1),
      minHeightVp.toFixed(1),
      applied.minWidth ?? minWidthPx,
      applied.minHeight ?? minHeightPx,
      applied.maxWidth ?? maxWidthPx,
      applied.maxHeight ?? maxHeightPx,
    );
    return true;
  }

  private async handleResetMaxWindowSize(): Promise<boolean> {
    const win = await this.ensureWindow();
    const current = win.getWindowLimits();
    const nextLimits: window.WindowLimits = {
      minWidth: current.minWidth ?? this.systemMinWidthPx,
      minHeight: current.minHeight ?? this.systemMinHeightPx,
      maxWidth: this.systemMaxWidthPx,
      maxHeight: this.systemMaxHeightPx,
    };
    const applied = await win.setWindowLimits(nextLimits);
    hilog.info(
      LOG_DOMAIN,
      LOG_TAG,
      'resetMaxWindowSize: keptMinPx=%{public}dx%{public}d restoredMaxPx=%{public}dx%{public}d',
      applied.minWidth ?? 0,
      applied.minHeight ?? 0,
      applied.maxWidth ?? this.systemMaxWidthPx,
      applied.maxHeight ?? this.systemMaxHeightPx,
    );
    return true;
  }

3.5 沉浸全屏双向切换与统一异常回执

全屏的问题要从最大化选项改起。我用 window.MaximizePresentation.ENTER_IMMERSIVE 让窗口铺满整屏,这时标题栏和 Dock 隐藏,win.getWindowStatus() 返回 WindowStatusType.FULL_SCREEN。退出时等待 win.recover(),窗口便恢复到进入全屏前的位置和宽高。

边框查询也改为优先读取 getWindowDecorVisible()。13 个通道操作都经过前面的队列;操作中捕获到错误时,reportError 把错误码和消息交回 Dart。下面的函数负责状态切换和错误回执。

  private isWindowFullScreen(win: window.Window): boolean {
    const status = win.getWindowStatus();
    if (status === window.WindowStatusType.FULL_SCREEN) {
      return true;
    }
    return win.getWindowProperties().isFullScreen;
  }

  private async applyFullScreenState(win: window.Window, targetFull: boolean, action: string): Promise<boolean> {
    const beforeStatus = win.getWindowStatus();
    if (targetFull) {
      await win.maximize(window.MaximizePresentation.ENTER_IMMERSIVE);
    } else if (
      beforeStatus === window.WindowStatusType.FULL_SCREEN ||
      beforeStatus === window.WindowStatusType.MAXIMIZE
    ) {
      await win.recover();
    }
    const afterStatus = win.getWindowStatus();
    const afterFull = this.isWindowFullScreen(win);
    hilog.info(
      LOG_DOMAIN,
      LOG_TAG,
      '%{public}s: target=%{public}s statusBefore=%{public}d statusAfter=%{public}d isFull=%{public}s',
      action,
      String(targetFull),
      beforeStatus,
      afterStatus,
      String(afterFull),
    );
    return true;
  }

  private reportError(result: MethodResult, method: string, error: Object): void {
    const err = error as BusinessError;
    const code = err?.code != null ? String(err.code) : 'WINDOW_ERROR';
    const message = err?.message ?? String(error);
    hilog.error(
      LOG_DOMAIN,
      LOG_TAG,
      '%{public}s failed: code=%{public}s message=%{public}s',
      method,
      code,
      message,
    );
    result.error(code, message, null);
  }

Dart 端的公开方法签名没变,我补的是返回数据的检查,例如把尺寸数组里的整数和浮点数统一转为 double。尺寸参数则由 ArkTS 校验:当前尺寸和最小尺寸都要求有限正数,校验失败经通道抛出 PlatformException,不会在 Dart 端抛 ArgumentError。最大尺寸另有非正值重置规则,所以业务输入框仍应提前检查,避免把误输的负数当成解除上限。

四、工程踩坑与边界条件

4.1 系统边界、错误回执与兼容版本

同一个尺寸请求,在浮动、最大化和全屏状态下不一定都能执行。插件会先看窗口状态,必要时恢复浮动,再按当前边界缩放。如果应用希望继续保持全屏,就不应同时调用设置浮动尺寸的方法。我把另外几个会影响接入的条件也放在表 5 中。

条件处理方式证据范围
全屏或最大化时调整尺寸先恢复,再调用异步缩放插件源码与宿主回归检查调用顺序
窗口 API 抛出错误保留错误码、消息并回传宿主回归注入拒绝,检查错误后队列继续
下限与上限冲突新设的一侧优先,另一侧同步收敛当前实现策略,不属于系统默认承诺
可选置顶权限不足捕获系统返回的权限错误权限声明核查,未验证获授权的置顶效果

表5 边界与处理

上下限冲突时,需要先决定保留哪个值。比如最大宽度原本为 800,后来又设置最小宽度 960,两者无法同时满足。当前补丁会把最大宽度提高到 960;反过来设置更小的最大宽度,则降低最小宽度。因此,另一侧约束只有在不冲突时才会保留。若应用希望遇到冲突直接报错,需要先在业务层检查。

前面读到的 608 × 190 px 和 5472 × 5472 px,是这个模拟器窗口的初始边界,不能作为所有设备的常量。我没有单独测试更小的尺寸请求会不会被系统限制到这组初始值;设置边界后,插件优先采用系统返回的生效值。

版本也有要求。我核对本机 SDK 后确认,窗口密度查询从 API 15 提供,装饰栏可见性查询从 API 18 提供。这份工程只在 API 26 编译和运行过,降低宿主的最低版本声明并不代表完成了旧系统适配。

查询失败时还要看回退逻辑:窗口密度可以退回默认屏幕密度,装饰栏状态则可能使用缓存值。后者在异常条件下未必与系统当时的状态一致。

4.2 权限和设备形态

本例的尺寸读写、最小最大尺寸、全屏切换和装饰栏显隐,都不需要额外声明窗口权限。可选的 DesktopWindow.stayOnTop(true) 要调用系统置顶接口,需要 ohos.permission.WINDOW_TOPMOST 和匹配的签名 Profile。我检查了权限要求,但还没有验证授予权限后的置顶效果。

设备是否支持自由窗口也要单独判断。我用的是 MateBook Pro 电脑模拟器,手机默认主窗口、平板是否开启自由多窗、双屏是否采用不同缩放比,都不在这组结果里。屏幕够宽只能说明页面可能放得下三栏,不能说明系统允许浮动窗口操作。应用应结合设备能力和实际调用结果显示控制入口,失败时保留普通页面。

4.3 自动测试覆盖到哪一层

最初的 Dart 单测由假宿主回应 MethodChannel,可以检查方法名、返回载荷和异常传播。不过,假宿主自己也模拟了像素转换,即使测试通过,实际 ArkTS 仍可能写反字段。

我随后补了一层直接加载 DesktopWindowPlugin.ets 的宿主测试。密度换算和边界处理都执行插件源码,系统替身只记录传入参数、模拟返回。这样可以检查宽高映射、异步等待、全屏调用顺序,也能注入一次错误,再看队列是否继续处理后面的请求。

至于窗口最终有多大、标题栏和 Dock 是否隐藏、退出全屏后回到哪里,仍要看模拟器画面和系统日志。Ability 解绑、重绑目前也只在宿主测试中检查了句柄引用,多 Ability 的设备行为还没测。把这几层分开后,失败的检查才有明确的排查位置:是 Dart 传参、原生插件处理,还是系统窗口行为。

五、结论与可直接复用的建议

5.1 这次修复解决了什么

需要并排查看内容的电脑页面,可以直接使用修复版设置窗口尺寸和上下限,再按需切换全屏。像素换算、最小宽高映射和全屏恢复由插件处理;应用仍负责选择合适的布局断点,决定窗口过窄时怎样显示内容。

5.2 在自己的项目中使用

💡 接入时,在应用的 pubspec.yaml 中添加下面的固定提交依赖。社区原分支尚不包含这个补丁,pub.dev 发布包也没有鸿蒙实现,所以这里需要指定实际的修复源码。

dependencies:
  desktop_window:
    git:
      url: https://atomgit.com/abaoge/fluttertpc_desktop_window.git
      ref: 02be9ea7781ba4917e889be6cf0fe6542651b479

打开宿主的 ohos/entry/src/main/module.json5,确认 module.deviceTypes 包含 "2in1",例如 ["phone", "tablet", "2in1"]。普通尺寸调整无需额外窗口权限,运行环境先按已验证的 API 26 自由窗口设备准备。首次加入或修改原生插件后,需要重新完整构建。

在页面导入 package:desktop_window/desktop_window.dart 后,可以从首帧渲染回调或按钮事件调用下面的辅助方法。它先设置最小边界,再设初始尺寸;遇到 PlatformException 时记录错误并返回空值,调用方可以据此保留普通布局。

import 'package:desktop_window/desktop_window.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

class WorkbenchWindowHelper {
  static Future<Size?> applyThreePaneBounds() async {
    try {
      // 先建立最小边界,再设置初始尺寸;调用失败时保留普通页面。
      await DesktopWindow.setMinWindowSize(const Size(960, 560));
      await DesktopWindow.setWindowSize(const Size(1120, 720));
      return await DesktopWindow.getWindowSize();
    } on PlatformException catch (error) {
      debugPrint('窗口尺寸约束未生效(${error.code}): ${error.message}');
      return null;
    }
  }

  static Future<bool?> toggleImmersiveFullScreen() async {
    try {
      await DesktopWindow.toggleFullScreen();
      return await DesktopWindow.getFullScreen();
    } on PlatformException catch (error) {
      debugPrint('全屏切换未完成(${error.code}): ${error.message}');
      return null;
    }
  }
}

5.3 使用时保留这几个判断

  1. 布局读取内容视口。getWindowSize() 的高度包含系统标题栏,本例比 MediaQuery.size.height 多约 36.8 vp;隐藏标题栏或进入沉浸全屏后,两者才相等。纵向布局继续以 MediaQuery 为准。
  2. 按需要搭配窗口事件库。desktop_window 无需额外初始化,适合尺寸、上下限和全屏控制。如果还要拦截右上角关闭按钮,弹出未保存确认框,可以交给处理窗口事件的 window_manager_plus。
  3. 按目标设备补测。这里跑过的是 MateBook Pro 模拟器,API 26、单屏密度 1.90。macOS、Windows、Linux 的原有代码未改,也未做运行回归;真机跨屏拖动和取得权限后的 stayOnTop(true),还需要在目标硬件上验证。

想看页面怎样组织,可以参考完整 Example;需要构建它时,再看 Example 说明中的英文路径构建方法。接到自己的应用里,用上面的依赖和公开接口即可,工具链与权限条件见本节和环境表。

小结

现在,三栏页面能按请求展开,缩小时保住需要的宽度,全屏后也能回到浮动窗口。🎉 回头看这次排查,最容易混淆的是“接口返回了什么”和“页面实际有多大”:标题栏造成的高度差本来正常,漏等异步操作和宽高字段写反才需要修改。我把请求、系统矩形和页面视口逐项对上后,才分清哪些该留给布局处理,哪些必须回到插件修。

参考资料

  1. desktop_window 上游源码仓库
  2. CPF-Flutter/fluttertpc_desktop_window 社区鸿蒙适配仓库
  3. HarmonyOS ArkUI Window 模块(@ohos.window)API 参考

相关推荐

开源鸿蒙社区月度优秀评选|9 月批次获奖名单公示

开源鸿蒙社区月度优秀评选由,面向高校学生开发者,秉持小任务、快认定、强反馈、持续贡献原则,搭建高校常态化贡献评优体系,沉淀开源鸿蒙优质生态成果。2026 年 6 月—12 月6-8 月开展统一评选,合并批次获奖名额为三个月名额总和。9 月、10 月、11 月、12 月每月独立评选。目前,9 月批次优秀评选名单已正式产生,现予以公示。以下名单。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 2

全国第一课!启元T1 Pro走进北邮研究生课堂

北京邮电大学研究生课程《机器人认知计算》迎来一位特殊的“助教”——上纬启元旗下的启元T1 Pro机器人。在启元“具身智能产教融合创新实践平台”的支持下,方斌老师以启元T1 Pro为示范,为60余名研究生讲授“基于VLM的具身智能技术”。这是启元T1 Pro在全国高校课堂上的第一课,也标志着启元具身智能产教融合平台在高校教学中正式落地。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 2

KMP 鸿蒙电脑快捷键实战:用 Kotlin 状态机接管 Ctrl+S 与右键菜单

本文介绍Kotlin Multiplatform鸿蒙社区推出的kmp-ohos-pc-shortcut库,解决鸿蒙电脑端快捷键实现难题。基于KMP共享层构建状态机,精准处理修饰键、焦点切换、输入法干扰等复杂场景,支持Ctrl+S、Ctrl+Shift+S等多组合键,并在2in1模拟器中实现自由窗口右键菜单自动适配。全链路由Kotlin决策,ArkTS仅订阅事件,确保跨端一致性与可靠性。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 3

Flutter 修复 flutter_tts 鸿蒙分段等待与 WAV 导出:折叠屏双栏讲义朗读

针对折叠屏双栏有声讲义场景,修复了 oh-flutter/flutter_tts_ohos 在首次朗读引擎未初始化、播放等待早退及离线 WAV 导出缺失的问题。通过串行化引擎重建与播放完成等待逻辑,并按分片序号拼接带标准文件头的 WAV 文件,实现三段朗读逐段等待(模拟器18,658ms)、单次导出246ms生成173,204B有效WAV。修复后在真机上稳定运行,捕获并重排跨进程乱序分片,完整代码已开源于 atomgit.com/oh-flutter/flutter_tts_ohos

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 3

Flutter 修复 device_calendar 鸿蒙重复规则与服务链接:让周期会议日程准确展开并保留入会入口

本文修复了鸿蒙版 device_calendar 插件在周期日程同步与会议链接读取中的关键问题,包括重复频率映射错误、链接转换缺失及周期实例查询异常。通过对比模拟器与真机测试,验证了修复后可正确返回每日/每周重复日程(如7天晨会、4周研讨),并完整回读会议链接。完整代码已开源至 oh-flutter/device_calendar,支持鸿蒙系统Flutter开发,欢迎提交Issue或参与社区交流。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 4

Flutter 修复 screen_retriever 鸿蒙电脑屏幕工作区检索:让桌面贴边窗口精准避让系统 Dock 栏

基于 oh-flutter/screen_retriever 0.4.0 单包分支,修复鸿蒙端缺失实现及 Dart 3.11.5 兼容问题,恢复标准 MethodChannel 桥接,补全逻辑像素折算、系统可用工作区读取、监听注销闭环与窗口内光标采样。解决贴边窗口越界、底部按钮被遮挡等问题,实现工具窗精准贴靠桌面右下角,代码已开源至 oh-flutter/screen_retriever。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 7

Flutter 适配 wearable_rotary 鸿蒙穿戴旋转表冠:圆屏长列表单手平滑浏览

为解决鸿蒙圆屏模拟器上Flutter应用表冠滚动失效问题,作者在wearable_rotary基础上新增鸿蒙原生支持,通过onDigitalCrown接收旋转事件,实现焦点容器绑定、角度换算与整数幅度解析,使列表可双向滚动。适配后支持表冠浏览与触屏标记协同操作,代码已开源至oh-flutter/plugins,欢迎参与共建。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 4

读徐直军《走进华为的创新之旅》:让创新成为可持续的能力

华为轮值董事长徐直军在美国《时代》杂志发表署名文章《走进华为的创新之旅:看见、亲历、引领》,回顾三十余年来亲历和推动华为创新发展的历程,分享关于人才投入、研发体系建设与基础研究的思考。对于服务开发者的 AtomGit 而言,这些实践经验也带来了启发:我们应该如何支持人的创造力,如何帮助协作形成合力,又如何让今天的积累成为未来创新的基础?以下分享这篇文章,与广大开发者共同学习,并结合平台实践展开思考。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 12

启元机器人 Developer Playground 深圳开发者见面会圆满落幕

当「整活」的开发者遇上具身智能,代码不再只停留在屏幕之内,而是驱动实体机器人听懂指令、跑通一套新 Skill。11 月 14 日,启元机器人 Developer Playground 开发者见面会暨启元机器人深圳旗舰店开业仪式,在深圳卓悦中心正式启幕,来自 AI 应用、企业研发、机器人与嵌入式及高校技术团队的开发者们齐聚现场,围绕T1 变形机器人、Q1 人形机器人完成技术分享与 Robot Challenge 双赛道实操。为活动致辞。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 8

AtomGit 10月:“建设人工智能开源社区 AtomGit,释放开源活力。”

10 月 19 日,国务院新闻办公室新闻发布会上,工业和信息化部科技司司长魏巍在介绍“人工智能+制造”专项行动成效时明确提及:“建设人工智能开源社区 AtomGit,释放开源活力。未来,AtomGit 将持续携手开发者与生态伙伴,汇聚开源创新力量,共同推动人工智能技术创新与应用。AtomGit 企业版正式上线;开源实践中心上线,同步推出城市坐标计划 · 活动日历、开源人物志与五阶段开源成长路径;OpenAPI 文档全新改版;模型硬件匹配能力、企业版、热门专题页上线。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 41

诚邀报名 | 相约南京!2026 开源鸿蒙技术大会即将启幕,共探操作系统与 AI 共生演进新方向

随着人工智能技术加速发展,操作系统正迎来新一轮变革。面对、具身智能等前沿技术带来的新需求,操作系统将如何与深度融合、协同演进?二者的融合创新又将为软件开发与产业发展带来哪些新机遇?大会信息时间2026 年 11 月 28 日地点南京扬子江国际会议中心主办开源鸿蒙项目群技术指导委员会(TSC)看点主论坛 · 二十场技术分论坛 · 创新成果展区。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 17

开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用

AI 已经把写代码这一段压平了,可改完到看见结果之间还隔着编译、重启和打包:一次全量编译要等 11 分 09 秒,一天能试几轮?要把桌面应用交付到开源鸿蒙 PC,又不想为这一端单独维护一套代码和一层桥接,路径该怎么选?开源鸿蒙跨平台系列直播第 24 期将结合 cj-tauri 的实践,分享「仓颉后端 + 系统 WebView 前端」这套组合。内容覆盖仓颉在开源鸿蒙生态里的位置、宿主与 IPC 双向桥的分工、能力白名单的最小权限模型,以及前端热更新给迭代节奏带来的变化;

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 17

报名开启|11 月 21 日北京,CANN 油气 & 化工行业 AI Meetup,共探 AI 落地路径

AI 加速走进油气化工行业,前沿技术如何落地业务、解决真实痛点,成为行业开发者共同关注的话题。为推动 AI 技术与行业场景深度融合,分享一线场景实践经验,围绕生态共建研讨,CANN 开源社区「油气 & 化工行业 AI Meetup」!本次活动聚焦三维全波形反演、AI 储层建模、油气 CV 应用、算子优化、图机器学习适配、化工智能体与分子筛选等方向,与行业伙伴、技术专家面对面交流,共探 AI 落地路径。活动时间:2026 年 11 月 21 日(周六)13:30–17:10。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 11

本期精选 G-Star 开源项目推荐|DSH 插件生态

从桌面状态反馈、界面设计和团队协作,到视觉理解、图像创作与应用操作,这些项目展示了 DSH 生态不同的扩展方向。有的解决具体体验问题,有的为 Agent 增加一类能力,也有项目把通用工具带进 DSH 工作区。欢迎前往仓库阅读 README、体验项目,并通过Star、Issue 或 PR支持作者。也欢迎更多开源项目申请加入 G-Star 计划,让你的项目被更多开发者看到。素材使用提示:本文介绍的是开源项目的技术能力。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 40

报名开启|11 月 21 日北京,CANNBot × MegaKernel Meetup,共探智能算子新方向

大模型落地浪潮下,算子开发、性能调优成为模型部署的核心难点。CANN 持续开源开放,依托 Agent 技术探索算子自动生成新范式。为促进算子开发者深度交流、共建 CANN 开源生态,11 月 21 日 CANN 开源社区在北京发起「CANNBot × MegaKernel Meetup」,现已开放报名!🙌。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 29

Flutter 修复 no_screenshot 鸿蒙窗口隐私模式切换:让一次性恢复口令页离开后恢复正常截屏

本文记录了在鸿蒙系统上使用 no_screenshot 插件实现页面截屏保护时,遇到的二次切换失效、恢复接口返回值错误及异步状态不同步问题。通过分析原生实现,修复了状态切换逻辑错误、返回值混淆及监听取消时的竞态问题,确保窗口隐私状态正确同步。修复后,模拟器与真机(畅享 100 Pro Max)均能正常实现进入/退出受保护页面后的截屏恢复,完整代码已开源于 oh-flutter/no_screenshot。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 62

Flutter 修复 audio_waveforms 鸿蒙波形提取句柄与内存驻留:多段语音备忘录预览与切歌释放

修复 Flutter 鸿蒙版 audio_waveforms 库在语音备忘录连续预览与切歌时的资源泄漏问题,补全文件关闭、提取取消与播放器释放逻辑,通过两段式 Worker 停止机制与零字节 EOS 处理,实现 144 轮切换无句柄残留、内存稳定。修复版已提交至 CPF-Flutter/fluttertpc_audio_waveforms,支持鸿蒙系统高效波形提取与资源管理。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 27

Flutter 修复 read_pdf_text 鸿蒙文档选择器 URI 读取:平板双栏讲义导入与摘录

修复鸿蒙平板上读取PDF文件时因授权URI处理不当导致无法复制的问题,通过改用只读文件描述符转存,并接入系统PDFKit实现分页浏览与片段保存。优化缓存清理策略,避免路径失效,确保连续导入与摘录功能稳定。完整代码已开源,支持鸿蒙平台的PDF文本提取与双栏讲义阅读场景。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 42

Flutter 修复 pasteboard 鸿蒙平板图片剪贴板读写:让批注画布复制后即刻无损粘贴

修复鸿蒙平台 pasteboard 库在写入大图后立即读取返回 null 的问题,通过等待系统编码完成并补全标准位图与文件 URI 读取支持。修复版已开源至 oh-flutter/pasteboard,兼容鸿蒙平板双栏批注场景,提升剪贴板跨端可靠性。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 98

Flutter 鸿蒙分布式数字身份实战:基于 HUKS 封装 flutter_did_ohos,实现私钥安全托管、离线凭证验签

本文介绍了一个基于鸿蒙系统的 Flutter 插件 flutter_knock_share,实现去中心化身份(DID)与可验证凭证(VC)的本地闭环。通过整合 HUKS 密钥库、cryptoFramework 与分布式 KV 存储,该方案在离线环境下实现私钥安全存储、身份自证与凭证验签,具备 34ms 身份创建、3ms 签发、58ms 验证的高性能表现。核心创新在于将公钥指纹作为 DID 标识,确保身份与密钥绑定,并通过 ArkTS 插件层保障私钥不外泄,构建了无需依赖外部服务的自主身份系统。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 68

KMP/CMP 接入鸿蒙实况窗:用 Kotlin 状态机驾驭 Live View Kit,把跨端 App 的锁屏进度卡片接起来

本文通过一个运行在API 26模拟器上的KMP实况窗Demo,揭示了状态机、节流与超时回收为何应置于Kotlin共享层:统一状态流转逻辑、精准控制更新频率,并实现跨端一致性。push裁决必须穿过C桥,确保ArkTS仅负责系统翻译,而核心决策由Kotlin全权掌控。六张实测截图完整呈现从启动、运行、暂停到恢复的生命周期,验证了状态机校验、节流策略与统计反馈的可靠性,证明该模式是KMP封装鸿蒙实况窗的理想方案。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 149

Flutter 修复鸿蒙平板方向控制:阅读页与全屏内容切换

本文修复了鸿蒙平台下 auto_orientation_v2 库因上下文错误导致的固定方向设置失败问题,通过改用 AbilityAware 绑定窗口、增加异步代次校验,并新增横竖两轴受限自动旋转功能。修复后,平板阅读页与全屏内容切换场景中方向控制稳定可靠,策略可正确实现 1 → 10 → 1 的流转。完整代码已开源,支持 Flutter 鸿蒙适配交流。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 68

Flutter 修复 desktop_drop 鸿蒙电脑自由窗口文件拖拽:让非原点窗口准确命中并读取附件

修复鸿蒙版 desktop_drop 插件在窗口下半区拖放无响应及文件读取失败问题,通过修正坐标换算(扣除标题栏高度)与路径转换(剥离 file:// 协议头),确保文件准确交付。经双窗口复现验证,修复后可稳定接收并读取同沙箱文件,完整代码已提交至 CPF-Flutter 仓库,支持社区交流与后续维护。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 95

RN 鸿蒙安全三方库落地:react-native-digital-shield,密钥不出 TEE,AES-GCM/RSA-JWT 跨端身份打通

本文基于 RNOH 0.84 与 HarmonyOS API 26,自研数字盾库 react-native-digital-shield,把 ArkTS 专属的 HUKS、asset 能力经TurboModule 桥接给 JS:提供 AES-256-GCM 加解密与密钥托管、敏感资产存储、RSA-2048 签发校验 RS256 JWT,并以 JWK 公钥和 HS256 共享密钥实现跨端身份互认,密钥明文始终不出 TEE。文中还复盘 TurboModule 双侧注册、GCM 需拆分 16 字节

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 32

Flutter 修复鸿蒙 WebView Cookie 同名键丢失:离线回读与开发助手复核实录

修复了 Flutter 三方库 webview_cookie_manager 鸿蒙端因同名键误判导致的 Cookie 名称丢失问题,确保业务键如 path、domain 等在回读时正确保留。修复后,模拟器与真机测试均实现四组数据完整恢复,值中多等号也保持不变。补丁已提交至 CPF-Flutter 官方仓库,提升插件在鸿蒙平台的可靠性。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 34

Flutter 鸿蒙启动图撤销后编译失败:用 DevEco Code 复核三方库修复

本文针对 Flutter 鸿蒙启动图撤销时导致编译失败的问题,修复了 flutter_native_splash_ohos 库在移除启动图时误删仍被引用资源的缺陷。通过保留1×1透明图片并透传自定义模块路径,确保资源引用完整性,使工程可正常构建。修复已提交至官方仓库,支持幂等操作与多场景验证,提升开发体验。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 50

Flutter 接入鸿蒙 ArkWeb 预初始化:帮助页首开时机与主线程成本实测

为解决Flutter鸿蒙版webview_flutter无法在无视图状态下提前初始化引擎的问题,我在其原生实现中新增可选静态入口initializeWebEngine()。实测表明,在2秒预热窗口下,页面首屏渲染(FCP)耗时从中位数1791ms降至1019ms,显著提升首次打开体验;而在零延迟场景下,总路径耗时略有上升,需权衡预热时机与用户等待成本。该补丁已提交至CPF-Flutter官方仓库,支持社区协作优化。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 50

Flutter 优化鸿蒙 printing_ohos 多页 PDF 光栅化:原生资源释放与缓冲复用

针对鸿蒙端 printing_ohos 插件存在的页码映射错误与高内存占用问题,本文提出并实现三项优化:修正页码索引映射、引入原生资源分层释放机制、复用像素缓冲区。修复后,第三页显示正确,内存增长显著降低——在模拟器上PSS增量中位数下降65.8%,真机测试下降64.4%。完整补丁已提交至官方仓库,支持社区协作与问题反馈。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 38

React Native 鸿蒙权限审计实战:让每一项权限都有人认领

本文介绍一款纯 JS 编写的 React Native 鸿蒙权限审计工具,解决权限声明与使用对账难、最小权限集计算矛盾、审核必填字段缺失三大痛点。通过 module.json5 声明、使用台账与源码扫描三路输入对账,自动识别未使用权限、补全 reason/usedScene、生成可粘贴的最小清单,并支持 CI 卡控与风险分评估。工具内核独立,离线运行,兼顾准确性与安全性,助力应用高效通过审核。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 18

Cordova 鸿蒙 WebView 安全实战:能改的运行时拦,改不了的构建期审

本文通过 cordova-plugin-harmony-webguard 插件,解决 Cordova/HarmonyOS 应用中导航安全、引擎不可修改配置、JS 门面静默降级三大难题。基于运行时策略闸门(onPageStart + JS 预检)与构建期审计 CLI(扫描 MainPage.ets、config.xml 等),实现协议拦截、白名单校验、高危配置阻断,支持 CI 失败退出,将安全基线可视化、可测化,真正落地“能改的运行时拦,改不了的构建期审”。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 39
上一篇: RN 鸿蒙安全三方库落地:react-native-digital-shield,密钥不出 TEE,AES-GCM/RSA-JWT 跨端身份打通
下一篇: Flutter 修复 desktop_drop 鸿蒙电脑自由窗口文件拖拽:让非原点窗口准确命中并读取附件
AtomGit 代码君
AtomGit 代码君 企业官方账号 企业官方账号
博客等级 码龄6年 2万+粉丝 880原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值