当前位置：首页>鸿蒙APP>【重磅】Flutter 鸿蒙 3.41.10-ohos-1.0.0版本正式发布!

【重磅】Flutter 鸿蒙 3.41.10-ohos-1.0.0版本正式发布!

2026-10-11 06:54:30

【重磅】Flutter 鸿蒙 3.41.10-ohos-1.0.0版本正式发布!

Flutter鸿蒙的官方也太低调了，默默的把3.41.10-ohos-1.0.0版本拉出来了：

官方的社区动态却迟迟没有发！

虽然我是知道官方做了很多工作的，付出的也非常多，发版本这种事情，@CPF-Flutter 就得高调啊！

新特性这块，上次基本剧透了 Flutter 鸿蒙 3.41 版本即将发布：社区适配周期缩短近一半，这个速度值得点赞！

本次给大家整理了一份问题修复清单，大伙可以查查看，之前遇到的问题是否已经在这个版本修复了：

一、弹窗 / 路由 / 分栏交互 7 项

#	修复项	Commit	详细描述
1	分栏功能中，当栈顶是弹窗时，不要拦截 pop 函数	`08b3b8ef`	分栏模式下 SDK 会拦截主页的移除操作，但此前当路由栈顶是弹窗时也会误拦截 pop，导致弹窗无法正常关闭；现改为栈顶为弹窗时放行 pop。
2	修复一定深度的主页调用 popUntil 问题 + 模态弹窗无法关闭问题	`77d56c55`	当路由栈中主页处于一定深度时，`popUntil` 行为异常，且模态弹窗（Modal）无法关闭；两项问题一并修复。
3	解决重复 builder + 键盘无法重新聚焦 + 强制 pop 不能返回 + observe 多个监听问题	`038492f4`	一次提交修复四个路由/导航相关的连带问题：页面重复 build、键盘收起后无法再次聚焦、强制 pop 无法返回、NavigatorObserver 多监听场景异常。
4	切换分栏实现方案，支持 router 路由方式下的分栏	`1a5c594c`	分栏（SplitView）实现方案重写，切换到基于路由栈管理的方式，使使用 `router` 路由（如 go_router）的应用也能正确启用分栏。
5	防止 SplitViewContainer 在 build 期间调用 setState	`fb507c89`	分栏容器组件此前会在 build 生命周期内触发 `setState`，引发 Flutter 框架异常警告；已改为安全的时机更新。
6	分栏起始页显示图标	`2a440fb2`	分栏启动页的图标显示修复。
7	修复分栏模式下开启无障碍阅读左分栏无法响应的问题	`a7cd6076`	开启屏幕阅读（无障碍）后，分栏左侧栏收不到响应事件，左分栏交互失效；已修复。

二、窗口 / 多窗 / 显示 6 项

#	修复项	Commit	详细描述
8	fix: 窗口最小化后恢复时的白屏问题	`1806476a`	应用窗口最小化再恢复到前台时出现白屏，现已正确恢复渲染。
9	fix: 三折屏自由窗多窗口模式下的安全区避让问题	`72ff6a50`	三折叠屏在自由多窗口形态下，页面内容未正确避让安全区（可能被挖孔/圆角遮挡）；已按多窗模式正确计算避让区域。
10	修复 DPI 重复重定向到同一页面的问题	`d43a57de`	DPI（Device Preview / 多设备适配）场景下会重复跳转、重定向到同一页面；已修复。
11	修复 DPI 与 Dart 自适应行为冲突的问题	`881c3cbf`	平台侧 DPI 处理与 Dart 侧自适应布局逻辑相互冲突导致显示异常；已协调两者行为。
12	解决预加载场景渲染异常问题	`4d21a81c`	使用引擎预加载（FlutterEnginePreload.preloadEngine）后界面渲染异常；配套根因修复见第九节 `43c4e884`。
13	FlutterView.ets 增加 isActive 状态判断	`2f99b761`	原生侧 FlutterView 分发事件前增加 isActive 判断，避免视图未激活时仍调用鸿蒙原生事件逻辑引发异常。

三、输入 / 鼠标键盘 4 项

#	修复项	Commit	详细描述
14	修复 Shift + 左方向键只能选中一个字符的问题	`72446b12`	键盘外设场景下，Shift+← 连续选择文本时只能选中一个字符，无法扩展选区；已修复。
15	修复鼠标滚轮步长值过小的问题	`80018378`	鼠标滚轮滚动一格产生的滚动量过小，操作体感异常；已修正步长。
16	修复鼠标左右键按键异常	`9be32bd2`	鼠标左键/右键事件在鸿蒙侧的处理异常（如误判按键类型）；已修复。
17	修复首次双击控件跳转到绿框位置的问题	`30ae1f15`	无障碍/焦点场景下首次双击控件会跳到绿色焦点框位置而非控件本身；已修复。

四、无障碍 3 项

#	修复项	Commit	详细描述
18	修复 OHOS 侧 SetSemanticsTreeEnabled 未生效问题	`2118f990`	框架侧设置语义树开关后原生侧未生效；已修复（该项自 0.0.1 起列入清单）。
19	修复 setApplicationLocale 原生侧接收失败	`01d6713d`	Dart 侧设置应用语言时原生侧接收不到；已修复（0.0.1 起列入）。
20	fix TextField accessibility read content	`2836cd1f`	屏幕阅读器朗读 TextField 时读出的内容不正确；已修复。

五、PlatformView / 插件 6 项

#	修复项	Commit	详细描述
21	Fix OHOS platform view active touch cancellation	`9a62d0c0`	提交说明原文：追踪处于激活状态的 platform-view 触摸，在销毁视图前显式发送 cancel 事件；并清空（drain）cancel 之后残留的旧触摸数据包，避免已销毁的 WebView 宿主继续收到过期的手势状态。
22	[OHOS] Fix PlatformView detach lifecycle	`b9c5187c`	PlatformView 从视图树分离时的生命周期处理不正确；已修复。
23	[OHOS] Avoid throwing from detached PlatformView render	`bbabff3c`	已 detach 的 PlatformView 若仍被渲染会抛异常导致崩溃；现改为安全处理。
24	Fix OHOS plugin registration error（其一）	`66123910`	插件在鸿蒙平台注册失败的问题；已修复。
25	Fix OHOS plugin registration error（其二）	`ec32c187`	插件注册的另一处错误修复（0.0.1 起列入）。
26	Fix OHOS native asset hook OS compatibility	`77dd6dcb`	native asset 构建钩子在鸿蒙平台的 OS 识别/兼容性问题；已修复。

六、系统通道 / 通信 3 项

#	修复项	Commit	详细描述
27	fix NavigationChannel crash	`46f7cca8`	系统 NavigationChannel 通道处理时发生崩溃；已修复。
28	EventChannel.endOfStream() 未在 Dart 侧触发 onDone	`920a1ae8`	原生侧调用 `endOfStream()` 后，Dart 侧的 Stream 不触发 `onDone` 回调，导致流无法正常结束；已修复。
29	解决 windowstage 可能已销毁的崩溃	`d531b580`	引擎持有 WindowStage 引用时窗口可能已销毁，继续访问即崩溃；现增加有效性判断。

七、渲染 / 色彩 / 性能 6 项

#	修复项	Commit	详细描述
30	sRGB 渲染成 P3 / CPU 计算 / 阴影颗粒感	`6912ef42`	一项提交修复三个渲染问题：sRGB 图片被按 P3 色彩空间渲染导致偏色、CPU 上执行的渲染计算、阴影渲染出现颗粒噪点。
31	宽色域合并（wide color gamut merging）的错误信息	`e92ed397`	宽色域图像合并路径报错信息不正确；已修正。
32	fix green border not update	`682b989a`	（无障碍/焦点）绿框指示未随状态更新；已修复。
33	性能雷达滑动丢帧上报字段值问题	`97bfa3ba`	性能雷达工具上报滑动丢帧数据时字段值错误；已修正。
34	取消 UI 线程检测卡死	`98b22b3d`	移除 UI 线程卡死检测逻辑，避免误判/干扰。
35	[CP-stable] 动画 PNG 帧像素缓冲区大小计算检查溢出	`42d3d75a`	自上游 stable cherry-pick（#185621）：动画 PNG 帧的 pixel buffer 大小计算增加溢出检查。

八、状态栏 / 配置 / 工具链 3 项

#	修复项	Commit	详细描述
36	未设置 statusBarIconBrightness 时状态栏图标变灰	`244b61c3`	应用未配置状态栏图标亮度时，状态栏图标错误地显示为灰色；已修复。
37	配置项值为空字符串时识别为无效值	`a6872f88`	鸿蒙侧配置文件中值为空字符串的配置项此前被当作有效值处理；现识别为无效。
38	plugin_ffi 动态库在 Windows 上加载失败	`ed4b0f66`	在 Windows 主机上开发鸿蒙应用时，plugin_ffi 的动态库加载失败；已修复（配合本版本新增的 Windows x86 开发支持）。

感兴趣的小伙伴记得关注我，关注社区动态！

“AI再牛，技术不能丢”

本文来自网友投稿或网络内容，如有侵犯您的权益请联系我们删除，联系邮箱：596563534@qq.com 。

最新文章

随机文章