---
title: "Flutter Liquid Glass：可用的包、Impeller 和几种实现思路"
description: "Cupertino 还没有官方 Liquid Glass。这些 Flutter Liquid Glass 包怎么渲染、哪里需要 Impeller、该选哪个。"
url: https://liquidglassdesign.com/zh/blog/flutter-liquid-glass-packages
language: zh-Hans
published: 2026-11-18
updated: 2026-11-18
author: "Liquid Glass Design"
tags: ["代码"]
translations:
  en: https://liquidglassdesign.com/blog/flutter-liquid-glass-packages.md
  zh-Hant: https://liquidglassdesign.com/zh-TW/blog/flutter-liquid-glass-packages.md
  ja: https://liquidglassdesign.com/ja/blog/flutter-liquid-glass-packages.md
  hi: https://liquidglassdesign.com/hi/blog/flutter-liquid-glass-packages.md
---

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

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

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](https://liquidglassdesign.com/gallery/liquid-glass-music-player) 是个很好的检验。一块玻璃控制面板浮在照片网格上，照片在面板边缘处弯折，能看到明显的色边，播放按钮是一个个小玻璃圆。这需要一个能采样 backdrop 的 shader 包。原生 `UIToolbar` 给不了这种自定义面板。

![透明玻璃播放面板带播放控制按钮，浮在照片网格上，面板边缘处的照片弯折并带彩虹色边](https://cdn.liquidglassdesign.com/gallery/21ecd13d-8a84-8054-a147-ff0c529749e5.png)

*Liquid Glass Music Player by Amine Kaddari。* [在图库中查看](https://liquidglassdesign.com/gallery/liquid-glass-music-player)
## 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 指南](https://liquidglassdesign.com/zh/blog/swiftui-liquid-glass)讲过后者。

### figma_glass

Parth Bhensdadiya 的 `figma_glass` 和 Figma 的 Glass 面板一一对应：light angle、light、refraction、depth、dispersion、frost 和 splay 都是同名、同取值范围的字段。如果你们的设计师在 Figma 里调玻璃参数（想熟悉这些控制项，[Glass effect playground](https://liquidglassdesign.com/resources/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](https://liquidglassdesign.com/resources/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 很重要，我们的 [网页性能与回退指南](https://liquidglassdesign.com/zh/blog/liquid-glass-web-performance-fallbacks) 对 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](https://liquidglassdesign.com/gallery/liquid-glass-camera-toolbar) 就是一个符合这些规则的好布局：一个圆形缩略图，一个胶囊形分段控件（选中的「Cinematic」镜头在里面），再加一个圆形翻转按钮。把三者放进一个图层，整条工具栏只花一次 backdrop 拷贝。

![相机工具栏：圆形自拍缩略图，透明胶囊控件里黄色的 Cinematic 字样，以及一个圆形翻转按钮](https://cdn.liquidglassdesign.com/gallery/296cd13d-8a84-8065-9b1d-f50b8d9fb531.jpg)

*Liquid Glass Camera Toolbar by MAni Ghafouri。* [在图库中查看](https://liquidglassdesign.com/gallery/liquid-glass-camera-toolbar)
## 该用哪个

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 介绍文章](https://liquidglassdesign.com/zh/what-is-liquid-glass)。

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

## 参考来源

- https://github.com/flutter/flutter/issues/170310
- https://github.com/flutter/flutter/issues/101479
- https://pub.dev/packages/cupertino_ui
- https://github.com/flutter/packages/blob/main/packages/cupertino_ui/CHANGELOG.md
- https://pub.dev/packages/liquid_glass_widgets
- https://github.com/sdegenaar/liquid_glass_widgets
- https://pub.dev/packages/liquid_glass_renderer
- https://github.com/whynotmake-it/flutter_liquid_glass/tree/main/packages/liquid_glass_renderer
- https://pub.dev/packages/figma_glass
- https://github.com/parthbhensdadiya226/figma_glass
- https://pub.dev/packages/oc_liquid_glass
- https://pub.dev/packages/cupertino_native
- https://pub.dev/packages/adaptive_platform_ui
- https://github.com/colbymaloy/flutter_liquid_glass
- https://docs.flutter.dev/perf/impeller
- https://api.flutter.dev/flutter/dart-ui/AccessibilityFeatures-class.html
- https://docs.flutter.dev/release/archive
