博客

Liquid Glass Design开发阅读约 8 分钟

Flutter Liquid Glass:可用的包、Impeller 和几种实现思路

Cupertino 还没有官方 Liquid Glass。这些 Flutter Liquid Glass 包怎么渲染、哪里需要 Impeller、该选哪个。

Flutter Liquid Glass:可用的包、Impeller 和几种实现思路
本文目录
  1. 有官方的 Cupertino 支持吗?
  2. 实现这种外观的两种方式
  3. Flutter Liquid Glass 包
  4. liquidglasswidgets
  5. liquidglassrenderer
  6. figma_glass
  7. ocliquidglass
  8. 原生控件:cupertinonative 和 adaptiveplatform_ui
  9. 我们资源页上的早期实验
  10. Impeller、Android 和 web
  11. renderer 文档里的性能规则
  12. 该用哪个
  13. 参考来源

Flutter 目前还没有官方的 Liquid Glass。Cupertino 组件没有更新,跟踪这件事的 issue 也还开着。现在想要这种外观,有两条路:用基于 fragment shader 的包自己画玻璃(liquid_glass_widgets、liquid_glass_renderer、figma_glass、oc_liquid_glass),或者在 iOS 上用 platform view 嵌入 Apple 真正的系统控件(cupertino_native、adaptive_platform_ui)。

版本号和下载量取自 2026 年 11 月 14 日的 pub.dev 和 GitHub。

有官方的 Cupertino 支持吗?

Flutter issue #170310「Support for iOS 26 'Liquid Glass' Design in Cupertino Widgets」在 2025 年 6 月提出,到现在还开着,标签是 P3,有 700 多个表情回应。2025 年 6 月,Flutter 团队表示「目前没有在 Cupertino 库里开发 Apple 26 新 UI 设计的功能」(not developing the new Apple'26 UI design features in the Cupertino library right now),也不会接受这方面的贡献。2025 年 7 月他们又补充说,Material 和 Cupertino 正在拆成独立的包,并且「Cupertino 针对 iOS 26 的所有新工作都会放在新包里做」(all new work for iOS26 updates in Cupertino will happen in the new packages)。

拆分已经完成了。cupertino_ui 已经上了 pub.dev,发布者是经过认证的 flutter.dev,版本 1.1.6(2026 年 11 月 3 日)。到目前为止,它的 changelog 都是 bug 修复和小的新增,没有 Liquid Glass 相关的条目。如果官方支持真的来了,多半会落在这个包里,值得关注。

实现这种外观的两种方式

在 Flutter 里画玻璃,就是用 shader 采样组件后面的内容,在边缘把它扭弯,再加磨砂和染色。这种做法在所有平台、任何组件树里都能用,参数也全由你自己定。但它终究是对 Apple 材质的近似,代价是 GPU 时间。

嵌入原生控件,就是在 Flutter 组件树里托管真正的 UITabBar、UIToolbar 或 UISwitch 视图。在 iOS 26 及以后,你拿到的就是系统材质本身,包括 iOS 27 的改进和用户的透明度设置。代价是:你只能用包里封装好的那几种控件,platform view 有自己的合成开销,而且玻璃里面放不了任意的 Flutter 内容。

我们画廊里 Amine Kaddari 的 Liquid Glass Music Player 是个很好的检验。一块玻璃控制面板浮在照片网格上,照片在面板边缘处弯折,能看到明显的色边,播放按钮是一个个小玻璃圆。这需要一个能采样 backdrop 的 shader 包。原生 UIToolbar 给不了这种自定义面板。

透明玻璃播放面板带播放控制按钮,浮在照片网格上,面板边缘处的照片弯折并带彩虹色边
Liquid Glass Music Player by Amine Kaddari。 在图库中查看

Flutter Liquid Glass 包

liquid_glass_widgets

Sebastian Degenaar 的 liquid_glass_widgets 是最完整的一套组件:GlassScaffold、GlassAppBar、GlassTabBar、GlassSwitch、GlassSlider、GlassSegmentedControl、菜单、sheet 等等,提供 ios27 和 ios26 两种风格。当前版本 1.17.3(2026 年 11 月 13 日),MIT 许可证,需要 Flutter 3.41 或更新,除了 Flutter SDK 没有其他依赖。pub.dev 上显示最近 30 天下载量约 147,000。

它会按平台选择质量档位。GlassQuality.premium 在 Impeller 上做完整的折射和色散。GlassQuality.standard 是一个更轻的单 pass shader,用在 Skia、web 和密集列表上,不会折射透镜后面的任意内容。GlassQuality.minimal 就是普通的 BackdropFilter,没有自定义 shader。

Dart
import 'package:flutter/cupertino.dart';
import 'package:liquid_glass_widgets/liquid_glass_widgets.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await LiquidGlassWidgets.initialize();
  runApp(LiquidGlassWidgets.wrap(child: const MyApp()));
}

如果你用的是 MaterialApp,README 建议给 wrap 传入 brightnessResolver: Theme.maybeBrightnessOf,这样玻璃会跟随你的 ThemeMode。

liquid_glass_renderer

whynotmake.it 的 liquid_glass_renderer 更底层:提供形状、图层和混合组,控件要你自己在上面搭。1.0 版是完全重写的,带 iOS 27 预设。到目前为止发布的所有版本,包括 0.2.x 系列,都是 dev 预发布版。

  • 完整的玻璃效果需要 Impeller 加上 Flutter GPU API,README 说后者「仍处于预览阶段」(still in preview)。开启方式是加 --enable-flutter-gpu,或者在 Info.plist 里加 FLTEnableFlutterGPU,并在 AndroidManifest.xml 里加一条 EnableFlutterGPU meta-data。
  • 在用不了完整玻璃的地方(Skia、web、关掉 Flutter GPU 时),图层会切换到 FakeGlass,保留磨砂、染色和边缘反光,去掉折射。
  • 它在 iOS、Android 和 macOS 上测试过,许可证是 Apache 2.0。

加依赖之前先看 SDK 约束。1.0.0-dev.2 声明需要 Flutter 3.47 或更新,但 Dart 限定为 >=3.13.0 <3.14.0。2026 年 11 月 11 日发布的稳定版 Flutter 3.50.0 带的是 Dart 3.14.0,所以在当前稳定版上,这个 dev 版本解析不了依赖,要等包放宽这个范围。

Dart
Stack(
  children: [
    const Positioned.fill(child: MyContent()),
    Center(
      child: LiquidGlassLayer(
        settings: LiquidGlassSettings.ios27Regular(brightness: brightness),
        child: const LiquidGlass(
          shape: LiquidRoundedSuperellipse(borderRadius: 28),
          child: SizedBox(width: 220, height: 56),
        ),
      ),
    ),
  ],
)

玻璃采样的是它后面的像素,所以内容和玻璃要放进同一个 Stack。LiquidGlassBlendGroup 会合并相邻的形状,和 SwiftUI 的 GlassEffectContainer 很像,我们的 SwiftUI Liquid Glass 指南讲过后者。

figma_glass

Parth Bhensdadiya 的 figma_glass 和 Figma 的 Glass 面板一一对应:light angle、light、refraction、depth、dispersion、frost 和 splay 都是同名、同取值范围的字段。如果你们的设计师在 Figma 里调玻璃参数(想熟悉这些控制项,Glass effect playground 是个好去处),你可以直接把他们的数值搬过来。它把你传给 GlassBackground 的背景渲染成一张快照,再用 fragment shader 折射这张快照。作者在 Android(Impeller on Vulkan)、iOS 模拟器和 Chrome 上测试过。它很新,也很小:版本 0.1.3(2026 年 10 月),MIT 许可证,需要 Flutter 3.44 或更新。

oc_liquid_glass

oc_liquid_glass 用 GPU fragment shader 画玻璃水滴。它只在 Impeller 平台上工作(pub.dev 页面上列的是 Android、iOS 和 macOS),一个组最多四个形状,最近一次发布是 2026 年 6 月(0.3.0)。

原生控件:cupertino_native 和 adaptive_platform_ui

Serverpod 的 cupertino_native 用 platform view 托管真正的 UIKit 和 AppKit 控件:滑块、开关、分段控件、按钮、SF Symbol 图标、弹出菜单和 tab bar。它的 README 说这是一个概念验证,最近一次发布(0.1.1)是 2025 年 9 月。

adaptive_platform_ui 更活跃(1.0.2,2026 年 10 月,MIT 许可证)。在 iOS 26 及以后,它渲染原生的 iOS 26 UIToolbar、UITabBar 和 UIButton;在旧版 iOS 上用经典的 Cupertino 组件;在 Android 上用 Material。

我们资源页上的早期实验

我们资源里的 Flutter liquid glass 条目链接的是 Colby Maloy 的仓库,那是 2025 年 6 月的一次「在 Flutter 里实现 liquid glass 规范的尝试」(attempt at implementing liquid glass specifications in flutter)。作为一个小型 shader 示例值得一读,但它从 2025 年 6 月以后就没更新过,GitHub 也没检测到许可证,所以别把它当依赖用在正式产品里。

Impeller、Android 和 web

折射实时 backdrop 的那些包都依赖 Impeller,所以要先弄清楚你的 app 在哪些地方跑在 Impeller 上。根据 Flutter 的 Impeller 文档,iOS 上只有 Impeller 这一个渲染器。Android 上,API 29 及以上且支持 Vulkan 的设备默认用它,其他设备退回到旧的 OpenGL 渲染器。macOS、Windows 和 Linux 从 Flutter 3.47 起默认开启。web 仍然用 Skia。

实际操作中:

  • 找一台不支持 Vulkan 的 Android 设备,或者 API 28 及以下的设备测一下,看看你的回退档位。liquid_glass_widgets 为这种情况单独提供了一个 GLES shader。
  • 在 web 上,liquid_glass_renderer 会退回到 FakeGlass,liquid_glass_widgets 会退回到它那个更轻的 shader。figma_glass 在 web 上确实能折射,因为它处理的是你交给它的背景快照。如果 web 很重要,我们的 网页性能与回退指南 对 Flutter web 同样适用。
  • 在第一块玻璃出现之前加载好 shader,用 LiquidGlass.precache() 或 LiquidGlassWidgets.initialize()。renderer 的 README 提到,不这么做的话,第一块玻璃会有一两帧画成 FakeGlass。

renderer 文档里的性能规则

liquid_glass_renderer 的 README 用一句话概括了开销模型:「开销的单位是 backdrop 拷贝,不是玻璃组件。」(The unit of cost is the backdrop copy, not the glass widget.)在 Impeller 上,每个独立的 BackdropFilter 都会拷贝它后面的 render pass,通常是整个屏幕。它的大部分建议对任何基于 BackdropFilter 的包都适用:

  • 把同级的形状放进一个图层,这样一条带五个玻璃按钮的 tab bar 只算一次 backdrop 拷贝。
  • 图层要小。开销随玻璃覆盖的面积增长。
  • 别每帧都给混合组的几何做动画。移动一个形状,整个组都要重新渲染。
  • 阴影要少、要小。
  • 很小的模糊不一定更省。Impeller 大约要超过 5.8 个设备像素才开始降采样。

MAni Ghafouri 的 Liquid Glass Camera Toolbar 就是一个符合这些规则的好布局:一个圆形缩略图,一个胶囊形分段控件(选中的「Cinematic」镜头在里面),再加一个圆形翻转按钮。把三者放进一个图层,整条工具栏只花一次 backdrop 拷贝。

相机工具栏:圆形自拍缩略图,透明胶囊控件里黄色的 Cinematic 字样,以及一个圆形翻转按钮
Liquid Glass Camera Toolbar by MAni Ghafouri。 在图库中查看

该用哪个

  1. 想在所有平台上用现成的 iOS 27 风格控件:liquid_glass_widgets。
  2. 要搭一套自定义的玻璃设计系统,并且能接受预发布版:liquid_glass_renderer,等它的 Dart 约束和你的 SDK 对得上再用。
  3. 设计师在 Figma 里定义玻璃参数,你希望直接沿用他们的数值:figma_glass。
  4. app 以 iOS 为主,想要和系统完全一致的栏,包括 iOS 27 的行为和用户的透明度设置:栏和按钮用 adaptive_platform_ui,其他地方用 Flutter 内容。

不管选哪个,无障碍回退都得自己规划。Flutter 的 AccessibilityFeatures 有 highContrast、reduceMotion 和 disableAnimations,但没有 Reduce Transparency 标志,所以框架没办法让你读到这个 iOS 设置。liquid_glass_widgets 把 Increase Contrast(MediaQuery.highContrastOf)映射到它的降低透明度模式,还提供 GlassAccessibilityScope(reduceTransparency: true) 作为手动开关。用其他包的话,把一套不透明的样式接到 highContrast 和一个 app 内设置上。原生 platform view 控件是例外,它们会自己跟随系统设置。

想了解这种材质本身的背景,可以看我们的 Liquid Glass 介绍文章。

版本、设置和数据核对于 2026 年 11 月 14 日。

参考来源

分享这篇文章

每周更新,精选新参考

精选 Liquid Glass 作品,每一个都附上实现方式。

一周一封,英文内容,一键退订。