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

📦 screen_retriever 用于读取桌面显示器的尺寸、工作区和光标坐标,但社区仓库 ohos/screen_retriever 分支刚同步上游 0.4.0(nativeapi),既无鸿蒙端实现也无法在 Dart 3.11.5 上解析依赖;我基于该分支恢复单包标准通道桥接,补齐逻辑像素折算、系统可用工作区读取、流订阅清理与窗口内鼠标采样。
完整代码已开源在 oh-flutter/screen_retriever,欢迎提交 Issue 或前往 鸿蒙系统Flutter开源库社区 交流。

前言

💻 我在 MateBook Pro 鸿蒙电脑模拟器上做了一个可以贴靠桌面右下角的工具面板,希望底部按钮始终停留在系统 Dock 上方。刚开始准备接入时,社区仓库 oh-flutter/screen_retriever 的 ohos/screen_retriever 分支只完成了上游 0.4.0 同步,里面改成了基于 nativeapi 的桌面实现,不仅缺鸿蒙端,还要求 Dart 3.14;如果换成仅调 @ohos.display 基础属性把物理屏幕尺寸与整屏宽高直接传给按逻辑像素布局的页面,点击贴边,窗口就会滑出屏幕,只剩一截标题栏。

🔍 顺着依赖报错与返回值偏差逐层核对后,我直接以 oh-flutter/screen_retriever 的 ohos/screen_retriever(0.4.0)单包结构为基线撤除了未适配的 nativeapi 依赖,恢复 MethodChannelScreenRetriever 标准通道桥接,并在鸿蒙原生侧补齐各屏幕独立缩放比折算、系统可用矩形读取、成员监听注销闭环与窗口内局部指针采样。同条件下重新跑通贴边演示,窗口底边从越界的 2872 像素回到 1932 像素,悬停在 Dock 顶边上方约 23 像素处,底部按钮恢复正常点击 🎉。

工具窗查询系统工作区后由宿主移到 Dock 上方

图1 工作区贴边

一、使用场景、开源仓库核查与核心问题

1.1 把工具窗贴在桌面右下角

手机上的全屏页面可以用 SafeArea 或 MediaQuery.padding 避开状态栏和底部导航条。鸿蒙电脑的自由窗口则可以在桌面上自由移动和缩放;要把整个窗口贴到屏幕边缘,还得先知道桌面上哪些区域真正可用。

我做了一个 760 × 520 虚拟像素的「快捷剪藏与桌面工作区贴边面板」。窗口从桌面左上方启动,点击「贴靠右下角工作区」后,应移到主屏右下角,与边缘保留 12 虚拟像素的间距,底部按钮也要留在 Dock 上方。页面里的归档按钮只增加计数,用来检查按钮能否点击;它没有采集剪贴板、持久化或真正归档资料。

这个桌面贴边操作需要四类屏幕信息:

  1. 统一的逻辑像素坐标系:Flutter 布局层以逻辑像素(在鸿蒙上对应虚拟像素 vp)定义窗口目标尺寸 760 × 520 vp,而鸿蒙原生 @ohos.window 的 moveWindowTo 与 resize 接收的是物理像素(px)。插件需要像在 macOS、Windows、Linux 上一样,将屏幕尺寸与可用工作区统一折算为逻辑像素返回,并通过 Display.scaleFactor 给出该显示器的真实缩放比。
  2. 扣除系统常驻栏后的真实可用工作区:鸿蒙电脑桌面底部常驻系统任务栏 SCBSmartDock。如果 visibleSize 返回全屏高度而不扣除任务栏高度,按右下角贴边公式算出的窗口底部就会钻进任务栏下方,挡住底部操作按钮。
  3. 动态工作区与多屏热插拔感知:当用户外接扩展显示器、调整系统显示缩放比,或者切换系统 Dock 栏自动隐藏与常驻状态时,应用需要收到变化通知再重新查询几何。插件提供 ScreenListener 入口,但这一通知机制不等于已经完成多屏热插拔或 Dock 自动隐藏的真机验收。
  4. 窗口交互期的屏幕光标坐标:用户在工具窗内点击时,应用可以把当前鼠标事件换算到屏幕坐标,用于定位伴随菜单。窗口内采样只覆盖交互发生的瞬间,不承诺持续追踪整个桌面的光标。

1.2 上游与社区仓库核查:为何基于 0.4.0 单包恢复标准通道

动手修改前,我先后检查了 leanflutter 的上游源码仓库、pub.dev 包信息,以及 oh-flutter、CPF-Flutter 等开源组织下的既有移植。上游 leanflutter/screen_retriever 用于桌面显示器尺寸、工作区和光标查询,按 MIT 许可分发,仅覆盖 Linux、macOS 与 Windows 三端。

leanflutter 的 screen_retriever 上游仓库主页

图2 上游仓库

同时我核查了社区仓库 oh-flutter/screen_retriever 的 ohos/screen_retriever 分支(图 3)以及 CPF-Flutter 组织的旧版移植。社区新仓库刚完成上游 0.4.0 同步,已经把 0.2.x 的多包联合架构收拢回单包,并把底层切到 nativeapi 0.6.0 与 DisplayManager 新接口,要求 Flutter 3.50 和 Dart 3.14;不仅没有鸿蒙实现,在当前 HarmonyOS Flutter 3.41.9+ohos-1.0.2(Dart 3.11.5)上连依赖解析都无法通过。而早先社区的 0.2.x 移植虽然通过方法通道接入了部分屏幕属性,但结构与社区新版主干分叉,且未读取系统可用工作区,贴边窗口依然会落入底部 Dock。

社区仓库 oh-flutter/screen_retriever 的 ohos/screen_retriever 分支状态

图3 鸿蒙适配仓

如果另起一个低版本仓库或硬退回旧的联合多包结构,后续就很难顺滑合回社区已经建好的 ohos/screen_retriever 分支;如果强行保留 nativeapi 依赖,在当前鸿蒙 Flutter 工具链上又编译不起来。因此我直接以 0.4.0 单包基线为起点,保留对外 screenRetriever、Display、ScreenListener 等既有 Dart 接口不变,在内部撤除未适配依赖、恢复标准通道 MethodChannelScreenRetriever 并补全 ArkTS 原生工作区实现(见表 1)。

核查来源版本或分支与本篇相关的核查结论
leanflutter 主分支0.4.0迁移至 nativeapi C++ 核心,要求 Flutter 3.50 / Dart 3.14,无鸿蒙实现
oh-flutter/screen_retrieverohos/screen_retriever(基线 0.4.0)已由上游 0.4.0 单包导入建仓,尚未实现鸿蒙原生端与通道兼容
既有社区旧版移植参考0.2.x 分支方法通道契约可作参考,但未扣减系统可用工作区且与 0.4.0 单包目录分叉
本次单包适配分支feat/ohos_screen_retriever_0.4.0移除 nativeapi 依赖限制,恢复通道并补全鸿蒙单包工作区避让与鼠标采样

表1 版本与范围

1.3 素朴直传基线与鸿蒙接入时的五处隐患

🐛 为什么不能只在鸿蒙端简单调一下 display.getDefaultDisplaySync() 把宽高塞进字典就交差?我结合对照基线、0.4.0 基线代码与 0.2.x 通道协议逐项排查,梳理出五处直接影响桌面贴边定位与运行稳定性的问题:

  1. 物理像素直传与缩放比失真。在上游桌面三端约定的契约中,size、visiblePosition、visibleSize 返回的全部是逻辑像素。如果鸿蒙端直接把物理宽高 3120 和 2080 原封不动写入字典且漏填 scaleFactor,业务层回退读取当前视图缩放比 1.90 去把逻辑目标坐标换算成物理像素时,3120 会被当成逻辑宽度再乘一次 1.90,横向目标瞬间膨胀到 4461 像素。此外,多显示器场景下必须优先读取每块屏幕自身的 densityPixels,不能拿主窗口像素比硬套外接副屏。
  2. 可用工作区按整屏硬编码,忽略鸿蒙电脑系统 Dock 避让区。如果构造工作区字段时把起点固定填为零点、把 visibleSize 直接赋值为整块屏幕的宽高,就会漏掉桌面常驻栏。HarmonyOS SDK 从 API 12 起已在 @ohos.display 的 Display 接口上公开了无需额外权限的 getAvailableArea() 方法,专门返回扣除顶部状态栏与底部 Dock 任务栏后的可用物理像素矩形。在 MateBook Pro(3120 × 2080 像素)桌面上,底部系统任务栏占据高度 125 像素(65.8 vp),忽略这部分占用就会让贴边窗口底边伸入 Dock 下方。
  3. 单包平台入口注册与模块设备形态声明缺位。0.4.0 基线根 pubspec.yaml 的平台配置节点尚未接入鸿蒙插件类 ScreenRetrieverPlugin 声明;若鸿蒙原生模块 ohos/src/main/module.json5 的 deviceTypes 未同时覆盖 default、tablet 与 2in1 三种形态,应用在鸿蒙电脑上还可能退回手机兼容窗口而非原生自由多窗口模式。
  4. 事件通道恢复后须守住流订阅取消闭环。上游 0.4.0 已在 ScreenRetriever 内部通过 _subscription?.cancel() 修复了早先 0.2.x 时期 removeListener 在监听清空时错写成新建空订阅的流泄漏,但在将底层从 nativeapi 换回 EventChannel 时,原生侧也必须保存并注销成员回调引用,防止页面反复进出时叠加派发或残留原生监听器。
  5. 窗口交互期缺少光标屏幕坐标换算。鸿蒙普通三方应用无法在无权限后台全局监听桌面指针,但在鼠标进入当前 Flutter 自由窗口交互期间,完全可以结合宿主窗口矩形、标题栏渲染偏移和当前局部鼠标事件算出准确的屏幕逻辑坐标。它是受交互范围限制的补充能力,不能替代系统级全局指针钩子。

二、修复前后运行效果与 WMS 数据对比

2.1 测试环境与同条件复现口径

为了直观验证上述问题对桌面贴边窗口的实际影响,我准备了页面布局、贴边公式与交互逻辑完全同款的「快捷剪藏与桌面工作区贴边面板」对照工程:修复前基线包(com.example.pgc28base)模拟未做逻辑像素折算、未接入 getAvailableArea() 且光标固定返回零点的原始全屏直出实现;修复后包则接入本文适配后的 screen_retriever 0.4.0 单包与鸿蒙原生工作区避让实现。随后我在同一硬件规格的 MateBook Pro 鸿蒙电脑模拟器上使用 0.4.0 单包完成复测(因调试签名模板绑定包名,0.4.0 重测日志中的进程包名为 com.example.splashremovepatched,下文的界面录屏与定格图保留同条件对照包 com.example.pgc28fix 的同几何运行画面)。运行与测量环境如下:

  • 跨端框架与构建工具链:Flutter 3.41.9+ohos-1.0.2(Dart 3.11.5),DevEco Studio 26.0.0.865,HarmonyOS SDK 26.0.0.105 / API 26。
  • 运行目标设备:鸿蒙电脑模拟器 MateBook Pro(设备形态 2in1,镜像/系统版本 7.0.0.107(SP8DEVC00E47R1P3))。
  • 系统显示与任务栏基准参数:主屏物理分辨率为 3120 × 2080 像素(60 赫兹),虚拟像素比 densityPixels 为 1.90(对应完整屏幕逻辑尺寸 1642.1 × 1094.7 vp);底部系统任务栏窗口常驻占据物理矩形 [0, 1955, 3120, 125] 像素(顶边位于纵坐标 1955 像素,占用高度 125 像素即 65.8 vp)。

两包启动后,宿主 EntryAbility.ets 均将初始自由窗口定位在桌面左上基准矩形 [180, 140, 1444, 988] 像素(即逻辑宽高 760 × 520 vp),随后按一致的物理坐标序列执行三步点击操作:点击初始窗口底部操作栏 (575, 1061) 像素处的「读取光标坐标」按钮;点击 (340, 1061) 像素处的「贴靠右下角工作区」按钮(目标逻辑宽高 760 × 520 vp,右下安全边距 12 vp);最后在右下角预期贴边窗口的底部操作栏依次点击「读取光标坐标」与「确认归档剪藏」按钮。

2.2 修复前:窗口越过屏幕边缘

先在干净桌面拉起基线对照包并执行上述三步同条件操作,实际运行过程如图 4 所示:

修复前基线包贴边越界动图

图4 修复前操作

从图 4 的初始面板可以看到,未折算的接口把屏幕尺寸与可用工作区均返回为 3120.0 × 2080.0,缩放比为空,右侧几何投影画布已经预警画出了超出屏幕框右下角的红色目标框。第 1 步点击「读取光标坐标」后,面板读到的光标坐标恒为零点。

紧接着执行第 2 步点击「贴靠右下角工作区」,面板按照公式向原生窗口发起 [4461, 2941, 1444, 988] 像素的移动请求,最终定格画面如图 5 所示:

修复前窗口飞出右下角并被 Dock 遮挡

图5 修复前越界

观察图 5 右下角时间托盘正上方:因为请求的坐标超出了 3120 × 2080 像素的屏幕物理边界,鸿蒙电脑窗口管理服务触发了边缘保底钳制,将基线窗口限制在 [2783, 1884, 1444, 988] 像素(窗口底边达 2872 像素)。此时整个窗口只有左上角一小截标题栏露在右下角任务栏上方,页面内容和底部操作按钮落到屏幕右下方,受到屏幕边缘和 Dock 遮挡,第 3 步归档点击落空。即便只补上 1.90 缩放除算而仍按整屏高度 1094.7 vp 返回工作区,按公式推算出的窗口底边也会落在 2057 像素,依然伸入顶边位于 1955 像素的系统 Dock 栏下方 102 像素(53.7 vp)。

2.3 修复后:窗口停在 Dock 上方

停止基线包后,在同一桌面条件下拉起接入修复后单包的示例工程并执行相同的三次点击序列,实测过程如图 6 所示:

修复后精准贴靠 Dock 正上方动图

图6 修复后操作

修复包启动后,面板顶部状态显示绿色的「已识别 Dock 避让区」:size 折算为 1642.1 × 1094.7 vp,scaleFactor 返回原生 1.90,visibleSize 返回扣除底部 65.8 vp 系统任务栏后的 1642.1 × 1028.9 vp。第 1 步点击 (575, 1061) 像素处的「读取光标坐标」按钮时,面板立即刷新出 (302.6, 558.4) vp——用物理点击坐标除以 1.90 验算后与显示值一致。

第 2 步点击「贴靠右下角工作区」并完成第 3 步贴边后光标读取与剪藏归档的定格效果如图 7 所示:

修复后窗口稳稳停靠在系统 Dock 栏上方

图7 修复后贴边

在图 7 中,快捷剪藏面板停在桌面右下角,右侧和底部各留出 12 vp(约 23 像素)间距,底部操作栏完整显示在系统任务栏上方。随后在右下角新位置点击 (2048, 1865) 像素处的「读取光标坐标」,该次点击返回值为 (1077.9, 981.6) vp,点击「确认归档剪藏」后,演示计数变为 1。用 0.4.0 单包构建产物在干净 2in1 模拟器复测,同样实得主屏可用矩形 [0, 0, 3120, 1955] 像素、Dock 占位 [0, 1955, 3120, 125] 像素、窗口管理服务实测位置 [1653, 944, 1444, 988] 像素以及 (302.6, 558.4) 与两组复测光标坐标,验证结果完全一致。

两包在 MateBook Pro 上采集到的 HiLog 指标与窗口管理服务实测数据对照见表 2:

测量维度与核验项修复前基线包修复后单包工程
Display.size 返回值3120.0 × 2080.0(物理像素误传)1642.1 × 1094.7 vp(逻辑像素)
Display.scaleFactor 返回值空值(字段缺失)1.90(目标屏幕真实缩放比)
Display.visiblePosition(0.0, 0.0)(硬编码)(0.0, 0.0)(实测顶栏无占用)
Display.visibleSize3120.0 × 2080.0(忽略底部 Dock)1642.1 × 1028.9 vp 🔴↓(扣除 65.8 vp Dock)
左上初始位光标读取(0.0, 0.0) vp(硬编码零点)(302.6, 558.4) vp(本次点击取一位小数)
右下贴边请求物理矩形[4461, 2941, 1444, 988] px[1653, 944, 1444, 988] px
窗口管理服务实测物理矩形[2783, 1884, 1444, 988] px[1653, 944, 1444, 988] px
窗口底边相对 Dock 顶边(1955 px)2872 px(越界遮挡)1932 px 🔴↓(悬停于 Dock 上方 23 px)
贴边后光标读取与归档结果按钮越界不可达,归档 0 条光标 (1077.9, 981.6) vp,演示计数 1 条 🟢↑

表2 实测指标对比

三、鸿蒙电脑屏幕工作区与单包插件实现解析

3.1 把查询、鼠标采样和屏幕事件拆成三条独立通路

在适配后的 screen_retriever 单包中,我按照 ScreenRetrieverPlatform 的抽象契约在 MethodChannelScreenRetriever 中把跨端通信重新拆回三条清晰链路:显示器查询走方法通道返回显示器模型,鼠标查询走同一方法通道返回屏幕坐标,屏幕与工作区动态变化则通过独立的事件通道 EventSink 推送给 ScreenListener。应用的窗口移动仍由示例工程自身的宿主通道负责,插件只专注提供准确的屏幕几何信息。

显示器查询、鼠标采样与屏幕事件的三条通路

图8 跨端调用链

整个单包适配按以下顺序推进:

  1. 在根 pubspec.yaml 中撤除尚未适配鸿蒙且依赖 Dart 3.14 的 nativeapi / nativeapi_flutter,恢复 sdk: ^3.4.0 约束,并在 flutter.plugin.platforms.ohos 注册原生插件类 ScreenRetrieverPlugin。
  2. 对外保留 lib/screen_retriever.dart 转导出 legacy.dart 契约,在 MethodChannelScreenRetriever 恢复标准方法与事件通道并接入对 display.getAvailableArea() 与独立 densityPixels 的原生读取。
  3. 在 MethodChannelScreenRetriever 层对原生返回的字典做 _normalizeDisplayMap 归一化,并在 Display.fromJson 兼容数值转浮点,消除 ArkTS 整数分流风险。
  4. 在 ScreenRetrieverPlugin.ets 桥接显示器增删改与可用区变化事件、在引擎或订阅取消时按成员引用执行 off 注销,同时收紧 MethodChannelScreenRetriever 中窗口内鼠标采样的微任务作用域。

3.2 设备形态声明与可用工作区核心折算源码

在鸿蒙工程构建阶段,插件与宿主模块的 module.json5 需同时覆盖目标运行设备形态,否则包管理服务在鸿蒙电脑上可能以手机兼容窗口而非原生 2in1 自由多窗口模式拉起应用。我在插件根目录的 ohos/src/main/module.json5 的 deviceTypes 中声明了 "default"、"tablet" 与 "2in1",核心配置与主屏查询实现如图 9 所示:

设备形态声明与主屏工作区查询核心实现

图9 核心配置实现

在 ScreenRetrieverPlugin.ets 中,主屏查询处理默认显示器,显示器列表查询逐块遍历屏幕。两条路径都会先通过 displayItem.densityPixels 确定每块显示器各自的缩放比,再异步读取物理可用区,最后将结果换算为逻辑像素字典;扩展屏还会叠加显示器自身的全局坐标起点。下面是读取可用区的完整函数:

  // 优先调用系统异步可用矩形接口,失败或返回空值时按三级兜底策略回退。
  private async resolveAvailableAreaPx(displayItem: display.Display): Promise<AvailableAreaResult> {
    try {
      const rect: display.Rect = await displayItem.getAvailableArea();
      if (rect != null && rect.width > 0 && rect.height > 0) {
        return {
          left: Number(rect.left ?? 0),
          top: Number(rect.top ?? 0),
          width: Number(rect.width),
          height: Number(rect.height),
          source: 'display.getAvailableArea',
        };
      }
    } catch (err) {
      hilog.warn(
        LOG_DOMAIN,
        TAG,
        'display(id=%{public}d).getAvailableArea 降级: %{public}s',
        displayItem.id,
        String(err)
      );
    }

    const availWidth: number = Number(displayItem.availableWidth ?? 0);
    const availHeight: number = Number(displayItem.availableHeight ?? 0);
    if (availWidth > 0 && availHeight > 0 &&
        (availWidth < displayItem.width || availHeight < displayItem.height)) {
      return {
        left: 0,
        top: 0,
        width: availWidth,
        height: availHeight,
        source: 'display.availableWidthHeight',
      };
    }

    const avoidFallback: AvailableAreaResult | null = this.resolveWindowAvoidFallbackPx(displayItem);
    if (avoidFallback != null) {
      return avoidFallback;
    }

    if (availWidth > 0 && availHeight > 0) {
      return {
        left: 0,
        top: 0,
        width: availWidth,
        height: availHeight,
        source: 'display.availableWidthHeightFull',
      };
    }

    return {
      left: 0,
      top: 0,
      width: displayItem.width,
      height: displayItem.height,
      source: 'display.fullSizeFallback',
    };
  }

这里之所以把 getAvailableArea() 放在第一优先级,是因为它返回包含左上角起点与宽高的完整矩形。同步宽高属性只有两个标量,一旦遇到顶部状态栏或左侧停靠栏占用,就无法表达可用区的起点偏移。本次在 MateBook Pro 上实测命中的是主屏原点为零、底部 Dock 常驻 125 像素的路径;顶部或侧边停靠栏形态仍需在对应桌面布局下单独核验。

3.3 标题栏偏移换算、事件通道与流订阅注销修复

窗口内光标换算有一个容易忽略的原点差异:鸿蒙自由窗口的 windowRect 包含系统标题栏,而 Flutter 指针事件的局部坐标从内容渲染区左上角算起。实测 MateBook Pro 标准自由窗口标题栏高度约为 36.84 vp(70 像素),漏加这层偏移会让算出的屏幕纵坐标整体偏小。

插件通过 AbilityAware 取得宿主主窗口,再从当前 Flutter 渲染节点读取 getPositionToWindow() 偏移。单屏条件下,屏幕逻辑坐标等于窗口物理起点除以显示器缩放比,加上渲染区域相对窗口的偏移,再加当前鼠标事件的局部坐标。以初始窗口点击为例,窗口物理起点是 [180, 140] 像素,局部鼠标坐标为 [207.9, 447.9] vp,标题栏渲染偏移为 [0.0, 36.8] vp,换算后得到 [302.6, 558.4] vp,与物理点击坐标除以 1.90 的结果吻合。

屏幕动态变化走独立的 dev.leanflutter.plugins/screen_retriever_event 事件通道。原生侧在订阅建立时注册显示服务的增删改回调与默认显示器的可用区变化回调,将事件统一转换为标准名称并通过 EventSink 发送;在取消订阅或引擎分离时传入保存的同一个成员函数引用执行 off 解绑。与此同时,我在 ScreenRetriever 单例里沿用了先判断监听器为空、再调用 _subscription?.cancel() 并置空订阅句柄的收尾方式,确保反复进出页面重新注册监听时不会残留旧流订阅。

3.4 鼠标位置采样只在当前事件微任务内有效

在 MethodChannelScreenRetriever 中,我还收紧了窗口局部鼠标位置的缓存生命周期。如果无限期保留“最后一次鼠标局部坐标”,当鼠标已经移出窗口或窗口被代码移到了右下角之后,业务再去调用查询,就会把过期的旧局部坐标与新窗口起点强行相加,拼出一个看似合法、实则从未发生过点击的虚假坐标;触摸屏点按事件同样不能混作桌面鼠标位置。

下面是 MethodChannelScreenRetriever 中的完整指针路由采样函数。它仅接收鼠标设备的悬停、移动、按下和松开四类事件,并在当前事件循环的微任务尾部自动清空;鼠标移出、取消或触摸输入会立即清空采样。保留松开事件,是因为按钮的 onPressed 点击回调恰好在松开阶段同步触发。

  void _handlePointerEvent(PointerEvent event) {
    // 每次收到新指针事件先清空旧值,避免跨事件残留过期局部坐标。
    _cursorEvent = null;
    _lastLocalCursorPoint = null;
    if (event.kind != PointerDeviceKind.mouse) {
      return;
    }
    if (event is PointerHoverEvent ||
        event is PointerMoveEvent ||
        event is PointerDownEvent ||
        event is PointerUpEvent) {
      _cursorEvent = event;
      _lastLocalCursorPoint = event.position;
      scheduleMicrotask(() {
        // 仅清理当前同一事件对象,防止提前误删后续新事件写入的采样。
        if (identical(_cursorEvent, event)) {
          _cursorEvent = null;
          _lastLocalCursorPoint = null;
        }
      });
    }
  }

_cursorEvent 与 _lastLocalCursorPoint 均为 MethodChannelScreenRetriever 的可空私有成员。考虑到组件树手势回调可能早于全局指针路由执行,getCursorScreenPoint 在尚未拿到采样时会先等待一次微任务让同次输入完成路由派发,随后立即将局部坐标连同安全读取的视图像素比传给原生通道;一旦业务先等待网络请求或窗口移动动画结束再去查询,微任务早已将采样清零,不会误用旧坐标。

基线对照包与0.4.0单包适配后的实测日志摘录

图10 运行日志

图 10 右侧展示了 0.4.0 单包方案在 MateBook Pro 干净模拟器上真实采集的原生与界面日志(调试签名模板为该测试安装包装配的包名为 com.example.splashremovepatched,日志显示前缀为 om.example.splashremovepatched):ScreenRetrieverPlugin 通过 display.getAvailableArea 读出物理可用区 [0, 0, 3120, 1955] 像素并折算为 1642.1 × 1028.9 vp,窗口贴靠至 [1653, 944, 1444, 988] 像素后,底边实测落点为 1932 px,第二次点击准确换算出 (1077.9, 981.6) vp。

四、工程踩坑与多设备边界条件

除了核心工作区折算,这次将 0.4.0 单包在鸿蒙工具链上改为标准通道实现时,还有几处容易踩坑的跨端细节与硬件边界需要一起说明。

4.1 消除 ArkTS 整数分流引发的反序列化异常

对接通道数据时有一个隐蔽的类型陷阱:在早先桌面端或严格按浮点强转的 Display.fromJson 写法中,坐标与尺寸转换器常常直接写 Offset(map['dx'] as double, map['dy'] as double)。而在 ArkTS 中所有数字都是数值类型,鸿蒙原生层的标准消息编解码器在序列化时,只要数值恰好没有小数位(例如工作区起点 0 除以 1.9 仍为 0,或在 2.0 缩放比屏幕上 3120 除以 2.0 等于 1560),就会按 32 位整数 INT32 写入字节流,到达 Dart 侧变成整型,一旦遇到 as double 强转就会触发 type 'int' is not a subtype of type 'double' 崩溃。

为此我在单包内同时做了两道防护:一方面在 MethodChannelScreenRetriever 收到原生通道字典后先经过 _normalizeDisplayMap 统一清洗,把尺寸、可用区起点、可用区宽高与缩放比里的数值转为 double,把显示器编号转为字符串;另一方面在 Display.fromJson 的内部几何解析函数中也把整型与浮点兼容读取写成 (map['width'] as num).toDouble(),即使外部测试或调用方直接传入整型 JSON 映射也不会失手崩溃。

4.2 多视图像素比安全读取与单包插件注册配置

旧实现里在读取当前视图像素比时习惯直接调用 PlatformDispatcher.instance.views.single.devicePixelRatio。在桌面多窗口或无界面单测环境下,视图集合可能为空或不止一个视图,直接读取单元素属性会抛出 StateError。MethodChannelScreenRetriever 改为优先读取 implicitView,为空时再回退取首个可用视图,无视图时安全回退为 1.0。

此外,既然适配以单包形态直接合入社区仓库,构建配置和版本号也要对应对齐:我在根 pubspec.yaml 的环境字段中放宽为兼容 Dart 3.4.0 与 Flutter 3.22.0 及以上,将包版本从 0.4.0 提升至 0.5.0-ohos.1 并在 CHANGELOG.md 顶部明确标注破坏性变更,同时在鸿蒙平台配置块下声明 pluginClass: ScreenRetrieverPlugin,把尚未在本分支提供原生实现的 linux、macos 与 windows 平台声明从 pubspec.yaml 中移除,使包元数据与真实支持范围保持一致。这样接入工程只需像引用常规单包那样依赖主仓即可完成原生注册,不再需要拆出单独的鸿蒙子包,也无需配置任何 dependency_overrides。另外要老实说明的是,因为这次撤除了 nativeapi 依赖,而当前适配器只补齐了鸿蒙通道与端侧代码,原本依托原生 C++ 库的 Linux、macOS 和 Windows 桌面端实现并不在本篇验证与回归范围内。

4.3 降级结果不等于精确工作区

getAvailableArea() 返回完整矩形,是本次模拟器成功扣除 Dock 高度的唯一精确来源。同步宽高属性只有两个标量,无法表达顶部或左侧的占用偏移;宿主窗口自身的规避区又属于当前窗口局部属性,尤其不能在副屏查询时拿主窗口规避区冒充副屏工作区。

因此我把降级分支仅作为低版本或接口异常时的兼容性兜底,并在 HiLog 中打印命中来源字段。如果降级分支最终返回了整块屏幕尺寸,只能说明拿到了显示器分辨率,不能代表系统任务栏已被扣除;业务层发现工作区与整屏相等时应保留用户手动拖动窗口的能力。可用区变化通知按矩形签名做了去重,但尚未采集 Dock 动态伸缩动画或真机热切换过程,不对这两种动态场景做成功率承诺。

4.4 分清本地单测与单屏模拟器实测范围

仓库内共配备了 21 项自动化测试:其中包根目录 test 下的 12 项测试分两组——legacy_api_test.dart 中的 4 项验证模型 JSON 往返、整型坐标反序列化、平台委托以及 removeListener 取消流订阅;screen_retriever_ohos_test.dart 中的 8 项验证默认通道实例注册、方法通道调用、32 位整数与浮点混合字典归一化、事件通道派发以及鼠标采样微任务过期清理;示例工程测试目录下的 9 项测试验证贴边几何公式边界、窄工作区跳过贴边与尺寸钳制、窗口复位异常状态回滚与界面按钮交互。需要说明的是,单测中的多屏参数属于预设模拟输入,只证明 Dart 层协议解析正确,并未执行原生 ArkTS 侧的多屏硬件枚举。

实际运行证据限定在 MateBook Pro(HarmonyOS 7.0.0.107 / API 26)单屏模拟器。异构缩放双屏真机、负坐标扩展屏原点、物理显示器热插拔,以及 Linux、macOS、Windows 三端基于原桌面的回归运行均不在本次实测范围内。此外,当没有有效窗口内鼠标事件时,getCursorScreenPoint 会显式抛出 StateError(原生侧返回 CURSOR_UNAVAILABLE),不再默默返回容易与原点混淆的 (0, 0) 零点,业务代码应当捕获该异常提示用户当前无窗口内光标采样。

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

5.1 厘清插件与宿主应用的职责边界

本篇基于 oh-flutter/screen_retriever 的 ohos/screen_retriever(0.4.0)单包基线完成了鸿蒙电脑适配,解决了依赖 nativeapi 导致在 Dart 3.11.5 下无法解析、以及单屏自由窗口右下角贴边越界和底部 Dock 遮挡问题:插件负责将屏幕尺寸、可用工作区与窗口交互期光标坐标统一折算为逻辑像素返回,并在屏幕或可用区变化时发出重新查询通知;窗口的目标宽高、安全边距、移动时机与异常提示则由业务应用自行控制。

5.2 在自己的项目中使用

💡 在业务工程的 pubspec.yaml 中可直接引入社区仓库与 ohos/screen_retriever 目标分支(单包结构下无需再填 path 子路径,也无需配置 dependency_overrides):

dependencies:
  screen_retriever:
    git:
      url: https://atomgit.com/oh-flutter/screen_retriever.git
      ref: ohos/screen_retriever

如果读者在社区目标分支尚未同步全部提交时希望提前拉取包含完整剪藏贴边示例在内的同步版本,可先将 url 指向 Fork 复现仓 https://atomgit.com/abaoge/screen_retriever.git,并将 ref 设为 feat/ohos_screen_retriever_0.4.0。

打开鸿蒙宿主工程 ohos/entry/src/main/module.json5,确认 deviceTypes 中包含 "2in1"(支持以鸿蒙电脑原生自由多窗口形态运行,同时兼顾手机与平板可保留 "default"、"tablet"):

"deviceTypes": [
  "default",
  "tablet",
  "2in1"
]

在业务代码中导入标准入口 package:screen_retriever/screen_retriever.dart,即可直接沿用 Display、ScreenListener 与 screenRetriever 查询主屏工作区并换算目标窗口物理矩形:

import 'dart:ui';

import 'package:screen_retriever/screen_retriever.dart';

/// 计算主屏右下角贴边窗口的物理像素矩形。
Future<Rect> bottomRightWindowRectPx({
  Size panelVp = const Size(760, 520),
  double marginVp = 12,
}) async {
  if (!panelVp.width.isFinite ||
      !panelVp.height.isFinite ||
      panelVp.width <= 0 ||
      panelVp.height <= 0 ||
      !marginVp.isFinite ||
      marginVp < 0) {
    throw ArgumentError('Window size and margin must be finite and valid.');
  }
  final Display primary = await screenRetriever.getPrimaryDisplay();
  final double? scale = primary.scaleFactor?.toDouble();
  final Offset? origin = primary.visiblePosition;
  final Size? work = primary.visibleSize;
  // 缺少工作区或缩放比时明确失败,避免把未经校验的整屏当作安全区。
  if (scale == null ||
      !scale.isFinite ||
      scale <= 0 ||
      origin == null ||
      !origin.dx.isFinite ||
      !origin.dy.isFinite ||
      work == null ||
      !work.width.isFinite ||
      !work.height.isFinite ||
      work.width <= 0 ||
      work.height <= 0) {
    throw StateError('The display has no valid work area or scale factor.');
  }
  if (panelVp.width + 2 * marginVp > work.width ||
      panelVp.height + 2 * marginVp > work.height) {
    throw StateError('The panel does not fit in the work area.');
  }
  // 只在交给鸿蒙窗口接口之前换算一次;返回值全部是物理像素。
  return Rect.fromLTWH(
    ((origin.dx + work.width - panelVp.width - marginVp) * scale)
        .roundToDouble(),
    ((origin.dy + work.height - panelVp.height - marginVp) * scale)
        .roundToDouble(),
    (panelVp.width * scale).roundToDouble(),
    (panelVp.height * scale).roundToDouble(),
  );
}

该函数只计算并返回物理像素矩形,异常会向上抛出供页面捕获提示。已有鸿蒙窗口管理通道的应用,把返回矩形的左上角传给 moveWindowTo、宽高传给 resize 即可,切勿再重复乘一次缩放比。需要参考原生窗口移动写法的读者,可以查看适配分支仓库内的 示例宿主实现 与 完整同款 Example。若业务需要跟随分辨率或工作区变化自动重算贴边位置,在页面初始化时调用 screenRetriever.addListener(this),并在 dispose 中成对调用 screenRetriever.removeListener(this)。

5.3 使用时保留这几个判断

  1. 布局计算与原生窗口移动分清单位。screen_retriever 返回的尺寸、工作区和光标坐标均为逻辑像素(vp),而鸿蒙 @ohos.window 的 moveWindowTo 与 resize 接收物理像素(px),业务侧只在最终下发窗口位置前乘一次对应显示器的 scaleFactor。
  2. 在当前鼠标事件的同步阶段或首个异步点前读取光标坐标。getCursorScreenPoint 采样仅在当前窗口鼠标事件的微任务周期内有效,先等待异步任务或窗口移动后再调用会触发 StateError 异常,且不支持后台全局桌面光标监听。
  3. 区分已验证与未验证的硬件环境。本次适配在 MateBook Pro(HarmonyOS 7.0.0.107 / API 26)单屏模拟器完成验证;连接异构外接显示器的双屏真机与桌面其他平台建议在实际硬件上进一步核对。

小结

把屏幕尺寸统一折算为逻辑像素并接入系统可用工作区后,演示工具窗终于稳稳停在系统 Dock 正上方,底部归档按钮也恢复了正常点击。排查这类桌面窗口错位问题时,与其在业务布局里硬凑偏移常数,不如顺着插件返回值、缩放比和窗口管理服务的实际落点逐层核对,把跨端单位契约和监听生命周期一次理顺。

参考资料

  1. screen_retriever 上游包文档与跨端契约说明(pub.dev)
  2. leanflutter/screen_retriever 上游源码仓库(GitHub)
  3. HarmonyOS @ohos.display(屏幕属性与 getAvailableArea 可用区域接口)官方参考
  4. HarmonyOS @ohos.window(自由窗口移动缩放与系统规避区管理)官方参考
  5. 鸿蒙系统Flutter开源库社区(oh-flutter)

相关推荐

直播预告|码道能力全景 :工具、模式与智能体如何协同

同样是用 AI 写代码,为什么有人效率翻倍,有人却在反复返工?11月 17 日 19:00-20:30 ,本期直播围绕「码道能力全景 :工具、模式与智能体如何协同」展开,将从三个角度拆这个问题。能力、实战、规范三块拼齐,帮你判断什么场景该用、怎么用得更稳!

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

KMP/CMP 接入鸿蒙圆屏穿戴:表盘信息降级与 60 KB 内存账

本文介绍基于KMP/CMP架构的圆屏布局与内存降级库roundfit-kmp,通过纯Kotlin Multiplatform实现圆屏弦宽计算、内存预算与档位决策,统一ArkTS与原生端逻辑。在466px圆屏上,四档(glance/essential/compact/full)动态调整内容可见性,确保界面与内存估算一致。核心机制包括:逐高度计算可用宽度、跨N-API同步计划数据、固定坐标系下的弹性取舍。实验验证了预算、字号、档位对渲染结果的影响,实现“同一份计算,多端一致”的高效表盘适配。

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

React Native 鸿蒙圆屏穿戴实战:20 KB 预算下的消息一瞥

本文详解在 React Native OpenHarmony 环境下,以零 SVG/Canvas、无原生模块限制,仅用 View 的 borderRadius 与 overflow 实现 208px 进度弧的渲染方案。通过半圆裁剪与三角函数定位拼接弧形,结合四档适配(full → glance),严格控制 28KB 内存预算,基于槽位存活表动态隐藏非关键元素,实现手表端高效、可验证的渐进式界面降级。

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

Flutter 鸿蒙圆屏穿戴实战:让信息学会自己降级

在466px圆屏上,round_fit库通过弦宽公式动态计算每行可用宽度,结合几何约束、档位降级与内存预算(20KB起),实现手表端响应式布局。52项测试全通过,四页App在模拟器中完整运行,支持从full到glance四档降级,确保内容始终在安全圆内,且内存与显示效果精准可控。

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

Qt 鸿蒙平板适配实战:一份源码,两条构建链,一个布局契约

Qt for OpenHarmony 5.12.12 与桌面 Qt 6.11 共用同一份 QML 和 C++ 源码,通过包装层差异实现跨平台兼容:鸿蒙端使用 qmlRegisterType() 手动注册类型,桌面端依赖 qt_add_qml_module() 自动注册;旋转逻辑封装为静态纯函数,确保几何计算一致。布局基于窗口尺寸动态解析,支持横竖屏、多栏、侧轨/底栏切换,实测于华为 MOR-M1 真机运行稳定,测试通过率 100%。

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

Qt 鸿蒙端侧 OCR 实战:当系统 API 只给了 ArkTS 入口

本文介绍基于 Qt 与 OpenHarmony 的 OCR 桥接方案,解决 C++ 无法直接调用 textRecognition 的问题。通过在同进程内监听 127.0.0.1:52141,使用 HTTP/1.1 传输图片字节,由 ArkTS 侧执行识别并返回结果。项目实现轻量级桥接,支持长图分块处理,实测 3120×2080 图片识别耗时 443ms,验证了跨语言通信可行性。方案依赖系统权限与回环网络,未来可适配 NDK 接口开放。

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

KMP/CMP 接入鸿蒙平板适配:响应式工作台与窗口旋转实战

本文介绍鸿蒙PC端ArkUI与Compose Desktop跨平台布局适配方案,通过Kotlin/Native实现统一断点逻辑(resolveTabletLayout),避免双端规则漂移。布局决策基于窗口尺寸变化,不依赖设备型号或方向,由Kotlin侧唯一计算并以JSON形式传递至ArkUI。工程上采用多平台Gradle构建,共享代码库支持桌面、移动端及OHOS,原生桥接通过N-API与版本脚本控制符号导出,确保跨语言调用稳定。

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

Flutter 鸿蒙平板适配实战:约束是唯一的事实来源

该库基于纯 Dart 实现鸿蒙端自适应布局,核心为 TabletLayoutBuilder,仅依赖父级约束,通过 resolveTabletLayout 纯函数动态计算布局。支持多断点响应式设计,方向由宽高比推导,不依赖 MediaQuery.orientation,确保折叠屏、分屏等场景下状态保留。工作台双 Pane 常驻树上,仅切换可见性,实现零丢失预览与黄金对比测试。适配 1280×800/800×1280 预览及真实窗口(1100×643),兼容横竖屏、侧轨/底部导航切换,可发布为三方包

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

Electron 鸿蒙平板适配实战:把旋转变成一次纯函数计算

tablet-adaptive-electron 通过纯函数 planContentResize 实现跨平台窗口旋转,核心在于以内容区中心为锚点、结合工作区约束动态调整窗口大小与位置,避免因 setBounds 锚点偏差导致漂移。主进程与 renderer 共用断点契约,鸿蒙侧通过 ArkTS HAR 对齐适配,实现横竖屏无缝切换。验证覆盖断点、布局、IPC 等 70 项,支持 Electron 与 HarmonyOS PC 多端统一体验。

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

KMP/CMP 鸿蒙分屏拖拽:把网页文字拖进摘录卡

“纸边摘录”是基于鸿蒙跨端框架(KMP/CMP)实现的分屏笔记工具,通过系统级拖拽事件接收浏览器选中文字,经由UDMF数据传递与ArkTS/Kotlin桥接,将纯文本转为可备注的卡片。设计上区分拖入预览、落点判断与数据写入三阶段,确保仅在有效落点导入,并避免重复或空内容。核心亮点在于严格按纯文本类型接收、UTF-8字节安全桥接、卡片状态稳定绑定,实现高效、无干扰的阅读辅助体验。

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

KMP/CMP 鸿蒙平板适配:软键盘弹出后,怎么让备注框和提交按钮都能用

本文通过鸿蒙跨端示例,演示了在平板全屏与悬浮窗下,会议预约表单如何应对软键盘弹出导致的布局遮挡问题。采用KeyboardAvoidMode.RESIZE模式,由鸿蒙宿主动态压缩视口,Compose根据新约束重新布局,确保输入框获焦后自动滚入可见区域,确认按钮始终位于底部可触位置。关键在于:焦点变化与布局重测双触发滚动请求,避免因时序差导致内容被遮;将确认按钮置于滚动区外,保障提交操作连续性;同时验证全屏与悬浮窗两种形态下的可用性,确保用户在任意窗口尺寸下均可流畅完成填写与提交。

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

KMP/CMP 接入鸿蒙 DID:对账文件改了一个字节,原签名还能验过吗?

本文通过鸿蒙跨端项目“文件签印”演示基于DID与SM2签名的文件篡改检测机制。在真实设备与模拟器上,同一签名验证原件通过、仅修改金额首字节的副本失败,证明验签可精准识别微小改动。系统通过读取原始字节、复用公钥与签名,确保验证结果可信。关键设计包括:异步接口适配、输入复制防干扰、阶段日志追踪、避免文本解析偏差,并强调验签依赖原始字节而非语义内容。项目实现跨端安全验证闭环,不暴露私钥或用户标识,适用于对账等高敏感场景。

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

Electron 鸿蒙端侧 OCR 实战:把鸿蒙设备的眼睛借给桌面应用

该库通过 hdc 工具将图片传至鸿蒙设备,利用 Core Vision Kit 实现离线中文票据识别,成功绕过 Electron 无法调用 HarmonyOS 系统 OCR 的限制。识别结果以 JSON 形式回传,失败时自动降级至本地 Tesseract.js。核心机制基于 job id 管理文件传输与并发任务,确保安全隔离。实测显示设备端识别仅需 414ms,且支持模拟器与真实设备,具备高可靠性与可扩展性。

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

Cordova 鸿蒙平板适配实战:旋转屏幕,但不旋转页面状态

本文介绍 cordova-plugin-tablet-adaptive 插件在 ArkWeb 环境下的布局适配实现:基于纯 JS 与 ResizeObserver 动态测量容器尺寸,将布局逻辑封装为纯函数,通过方向锁探测与降级处理实现跨屏自适应。实测于 HarmonyOS PC(3120×2080),验证了窗口缩放下布局字段、状态与焦点的稳定迁移,确保无重载切换。插件无原生代码,仅依赖 DOM 测量,核心在于“以视口为准”的响应式设计,成功落地于 46 项测试

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

《机器人有点东西》启元机器人开发者直播季 第二期来啦!

带你揭秘机器人运动控制背后的技术原理,从第一条指令到第一个动作,聊聊运控开发的关键技术与实践经验!📅 直播时间:11 月 16 日 20:00-21:00。机器人运动控制的核心原理。从零开始的运控开发思路。运动调试与技术进阶经验。

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

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

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

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

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

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

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

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

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

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

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大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 10

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 94
上一篇: Flutter 适配 wearable_rotary 鸿蒙穿戴旋转表冠:圆屏长列表单手平滑浏览
下一篇: Flutter 修复 device_calendar 鸿蒙重复规则与服务链接:让周期会议日程准确展开并保留入会入口
AtomGit 代码君
AtomGit 代码君 企业官方账号 企业官方账号
博客等级 码龄6年 2万+粉丝 895原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值