Flutter 3.47 在最近的 Google I/O China 发布会中悄然推出了多项重大更新，最引人注目的莫过于 Material 与 Cupertino 的正式解耦。对于日常开发者这代表着 UI 库将不再受限于 Flutter SDK 的发布节奏，可以按周级别进行独立迭代。只是这也给项目迁移与兼容性带来了不少痛点。

Material & Cupertino 分家了

现在可以通过独立包来使用 UI：

dependencies:
material_ui: ^1.0.0
cupertino_ui: ^1.0.0

从之前的写法来看，

import 'package:flutter/material.dart';import 'package:flutter/cupertino.dart';按理说，

再看改为。

import 'package:material_ui/material_ui.dart';import 'package:cupertino_ui/cupertino_ui.dart';

这样做的最大好处是 UI 包可以脱离 Flutter 的更新计划独立维护，避免每个季度都要同步更新的痛点。Flutter 计划让这些包以周级别 cadence 发布修复和新功能。

迁移工具一键完成

只需运行一次命令即可自动把旧导入替换为新包：

dart fix --apply --code=migrate_design_widgets

如果迁移工具在更新 pubspec.yaml 时遇到已知 Bug。可手动执行：

旧导入依旧可用，但你可能会碰到“混用”问题

如果项目中有模块仍旧引用旧的 'package:flutter/material.dart',那么你会得到两套不同实现的冲突。Flutter 为此提供了兼容桥梁：

MaterialUiCompatibilityBridge 使用示例

import 'package:material_ui/material_ui.dart';void main {
runApp);}
class MyApp extends StatelessWidget {
const MyApp;@override
Widget build {
return MaterialApp(
me的观点是。ThemeData(
colorScheme: ColorScheme.fromSeed),),builder: {
return MaterialUiCompatibilityBridge;},home: const HomeScreen,);}
}

X11 / iOS / macOS 更新细节与痛点

• XCode / iOS / macOS 最低支持版本提高至 iOS15、macOS10.x。
• UIScene 成为强制要求；未适配将直接导致启动失败。
• Intel Mac 停止适配；推荐仅建立 ARM64，
• CocoaPods Registry 将在未来某年进入只读模式；Swift Package Manager 正成为默认依赖管理器。
• Migrate SwiftPM 时第三方 SDK往往需要额外配置，导致迁移过程不顺畅。其实，
• 对于已有大量 CocoaPods 配置的项目。直接切换到 SPM 会出现编译错误或运行时崩溃，需要逐个手工调整 podspec 或切换到 SPM 支持的版本。

Migrating to Swift Package Manager

• Avoid hard-coded paths – use `Package.swift`’s dependency URLs.
• Add `--enable-swift-package-manager` flag early in CI pipelines.
• If encountering “missing symbols” from legacy CocoaPods pods,check if a SPM-compatible fork exists.

Impeller 默认渲染器 & 回退机制

• MacOS、Windows、Linux 全部默认启用 Impeller 渲染引擎；Web 已经全量使用 Impeller。
• 如果你的项目中包含自定义 OpenGL 渲染逻辑。需要额外配置回退，否则可能无法正常显示或报错。建议在 Info.plist 或 main.cpp 中显式禁用 Impeller：例如 `FLTEnableImpeller = false` 或 `project.set_impeller_switch` 等。
• Maw OS 支持 Wide Gamut Color。 可呈现更丰富色彩，但需要硬件支持并确认设备开启该功能。
下面讨论多窗口与 Flavor 支持带来的新机会与挑战。

Flutter 多窗口进阶

• ` 获取底层原生窗口指针。例如 Windows 的 HWND、macOS 的 NSWindow 或 Linux 的 GtkWindow，以便调用更高级原生 API。
**Flavor 打包示例**：
yaml flutter: 再看assets。- path: assets/flavor_a/images flavors: - flavor_a - path: assets/flavor_b/images flavors: - flavor_c bash flutter build windows --flavor flavor_a flutter build linux --flavor flavor_a

Web 上 Wasm Deferred Loading

• 提供实验性参数：--enable-wasm-deferred-loading
• 好处是把 Wasm 模块拆分为更小块，按需加载，提高首屏加载速度。
• 官方预计后续 flutter build web --release --wasm 将成为默认渲染方式。

Android 基线升级

项目	Flutter
Java	必须满足
Kotlin	要求最低版本
Gradle Plugin	要求最低版本
Gradle	要求最低版本

默认 Android API 参数已提高至 minSdkVersion = 24。对了修复了虚拟键盘 Shift 按下状态一直保持的问题，让键盘交互更稳定。

Accessibility 与文本选择改进

• Android 自动检测高对比度与颜色反转设置。
• Text.rich 内嵌 Span 按实际布局顺序排列至语义树，提高阅读体验。
• 文本选择手柄在移动端保持稳定，并可通过键盘快捷键关闭。
• 修复空滚动容器中 SelectableRegion 崩溃的问题。

手势与滚动调整

• 改进 Platform View 嵌入时手势传递机制，避免自动滚动触发冲突。
• EdgeDraggingAutoScroller 根据当前滚动视图的 设置决定是否触发自动滚动。

小工具 & 包更新

• ImageIcon 可保留原图颜色，不再强制按 Icon tint。

AnimatedCrossFade 可以显式指定 clipping behavior。

ImageStreamListener 可直接跟踪 image stream 错误。

GenUI Core 包已拆分为独立主要 package。可在 A2UI client‑side functions 中调用客户端函数，实现无需大模型就可以完成某些逻辑处理。

小结

Flutter 3.47 带来了从 UI 解耦到渲染引擎全链路升级的大幅变革，使得开发者能够更灵活地维护 UI 包、利用新的桌面窗口特性还有加速 Web 应用首次加载。只是这些变革一样带来了迁移成本——特别是对已有大量第三方插件、CocoaPods/SwiftPM 混合使用还有自定义渲染逻辑的项目而言。需要仔细规划并逐步测试，以确保平滑过渡并避免兼容性错误。