---
title: "Flutter Liquid Glass：套件、Impeller、做法"
description: "Cupertino 尚無官方 Liquid Glass，這些 Flutter Liquid Glass 套件補上了：怎麼算繪、哪裡要 Impeller、選哪個。"
url: https://liquidglassdesign.com/zh-TW/blog/flutter-liquid-glass-packages
language: zh-Hant
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-Hans: https://liquidglassdesign.com/zh/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 widget 還沒更新，追蹤這件事的 issue 也還開著。現在想做出這種外觀，有兩條路：用建立在片段著色器上的套件自己畫玻璃（`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 設計功能」，也不會接受這方面的貢獻。2025 年 7 月，團隊補充說 Material 和 Cupertino 正在拆分成獨立的套件，而且「Cupertino 針對 iOS26 更新的所有新工作，都會放在新套件裡」。

這次拆分已經完成。`cupertino_ui` 已經上架 pub.dev，發布者是經過驗證的 `flutter.dev`，目前版本 1.1.6（2026 年 11 月 3 日）。到目前為止，它的變更記錄都是錯誤修正和小幅新增，沒有任何 Liquid Glass 相關的項目。如果官方支援真的來了，最可能就是落在這個套件裡，值得持續關注。

## 做出這種外觀的兩種方式

在 Flutter 裡自己畫玻璃，是讓著色器取樣 widget 背後的內容，在邊緣彎折，再加上霧面和色調。這在每個平台、任何 widget 樹裡都能用，所有參數也都由你自己設定。不過它終究只是 Apple 材質的近似，代價是 GPU 時間。

嵌入原生控制項，是在 Flutter 樹裡放進真正的 `UITabBar`、`UIToolbar` 或 `UISwitch` view。在 iOS 26 以上，你拿到的就是系統原生材質，包括 iOS 27 的細部調整和使用者的透明度設定。代價是：你只能用套件有包裝的控制項，platform view 本身有額外的合成負擔，而且不能在玻璃裡放任意的 Flutter 內容。

作品集裡 Amine Kaddari 的 [Liquid Glass Music Player](https://liquidglassdesign.com/gallery/liquid-glass-music-player) 是很好的檢驗。一塊玻璃控制面板浮在照片網格上，照片在面板邊緣彎折，還看得到色邊，播放按鈕則是小小的玻璃圓形。這需要能取樣背景的著色器套件。原生的 `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` 是最完整的 widget 套組：`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 的著色器，用在 Skia、網頁和密集的清單上，不會折射透鏡背後的任意內容。`GlassQuality.minimal` 只是單純的 `BackdropFilter`，沒有自訂著色器。

```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 說要把 `brightnessResolver: Theme.maybeBrightnessOf` 傳給 `wrap`，玻璃才會跟著你的 `ThemeMode` 變化。

### liquid_glass_renderer

whynotmake.it 的 `liquid_glass_renderer` 是比較底層的選擇：提供形狀、圖層和混合群組，控制項要你自己在上面做。1.0 版完全重寫，附 iOS 27 預設集；到目前為止發布過的所有版本，包括 0.2.x 系列，都是 dev 預發行版。

- 完整的玻璃效果需要 Impeller 加上 Flutter GPU API，README 形容後者「仍在預覽階段」。開啟方式是加上 `--enable-flutter-gpu`，或在 `Info.plist` 裡加 `FLTEnableFlutterGPU`、在 `AndroidManifest.xml` 裡加一筆 `EnableFlutterGPU` meta-data。
- 無法使用完整玻璃效果的地方（Skia、網頁、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-TW/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` 的背景算繪成快照，再用片段著色器折射。作者在 Android（Impeller 跑在 Vulkan 上）、iOS 模擬器和 Chrome 上測試過。它是個新的小套件：版本 0.1.3（2026 年 10 月），MIT 授權，需要 Flutter 3.44 以上。

### oc_liquid_glass

`oc_liquid_glass` 用 GPU 片段著色器畫玻璃水滴。它只能在 Impeller 平台上使用（pub.dev 頁面列的是 Android、iOS 和 macOS），一組最多只能放四個形狀，最後一次發布是 2026 年 6 月（0.3.0）。

### 原生控制項：cupertino_native 與 adaptive_platform_ui

Serverpod 的 `cupertino_native` 透過 platform view 嵌入真正的 UIKit 和 AppKit 控制項：滑桿、切換開關、segmented control、按鈕、SF Symbol 圖示、彈出式選單和標籤頁列。README 稱它為概念驗證，最後一次發布（0.1.1）是 2025 年 9 月。

`adaptive_platform_ui` 比較活躍（1.0.2，2026 年 10 月，MIT 授權）。它在 iOS 26 以上算繪原生的 iOS 26 `UIToolbar`、`UITabBar` 和 `UIButton`，在較舊的 iOS 上用傳統的 Cupertino widget，在 Android 上則用 Material。

### 資源頁上的早期實驗

我們資源頁裡的 [Flutter liquid glass](https://liquidglassdesign.com/resources/flutter-liquid-glass) 連到 Colby Maloy 的 repo，內容是 2025 年 6 月一次「在 Flutter 中實作 liquid glass 規格的嘗試」。當成小型著色器範例來讀很值得，但它從 2025 年 6 月之後就沒再更新，GitHub 也偵測不到授權，所以別把它當成相依套件放進正式產品。

## Impeller、Android 與網頁

會折射即時背景的套件都依賴 Impeller，所以先確認你的 App 在哪些地方跑在 Impeller 上。根據 Flutter 的 Impeller 文件，iOS 上唯一的算繪引擎就是 Impeller。在 Android 上，API 29 以上且支援 Vulkan 的裝置預設使用 Impeller，其他裝置則退回舊的 OpenGL 算繪引擎。macOS、Windows 和 Linux 從 Flutter 3.47 起預設開啟。網頁仍然使用 Skia。

實際該做的事：

- 找一台不支援 Vulkan 的 Android 裝置，或 API 28 以下的裝置來測試，看看備援等級的效果。`liquid_glass_widgets` 為這種情況另外附了一個 GLES 著色器。
- 在網頁上，`liquid_glass_renderer` 會退回 `FakeGlass`，`liquid_glass_widgets` 則退回較輕量的著色器。`figma_glass` 在網頁上確實會折射，因為它處理的是你交給它的背景快照。如果網頁版很重要，我們的[網頁效能與備援指南](https://liquidglassdesign.com/zh-TW/blog/liquid-glass-web-performance-fallbacks)也適用於 Flutter web。
- 在第一塊玻璃出現之前，用 `LiquidGlass.precache()` 或 `LiquidGlassWidgets.initialize()` 先載入著色器。renderer 的 README 提到，不這麼做的話，第一塊玻璃會有一兩個影格畫成 `FakeGlass`。

## renderer 文件裡的效能原則

`liquid_glass_renderer` 的 README 這樣總結成本模型：「成本的單位是背景副本，並非玻璃 widget。」在 Impeller 上，每個獨立的 `BackdropFilter` 都會複製它背後的 render pass，通常就是整個螢幕。它的建議大多也適用於任何以 `BackdropFilter` 為基礎的套件：

- 並列的形狀放進同一個圖層，這樣有五個玻璃按鈕的標籤頁列只需要一份背景副本。
- 圖層盡量小。成本會隨玻璃覆蓋的面積增加。
- 不要每個影格都對混合群組的幾何形狀做動畫。移動一個形狀，整個群組就會重新算繪。
- 陰影要少、要小。
- 很小的模糊不一定比較省。Impeller 要到大約 5.8 個裝置像素以上才會開始降採樣。

MAni Ghafouri 的 [Liquid Glass Camera Toolbar](https://liquidglassdesign.com/gallery/liquid-glass-camera-toolbar) 是符合這些原則的好版面：一個圓形縮圖、一個膠囊形 segmented control（裡面是已選取的「Cinematic」鏡頭），以及一個圓形翻轉按鈕。三者放進同一個圖層，整條工具列只要一份背景副本。

![相機工具列，有一個圓形自拍縮圖、一個以黃色顯示 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`，但沒有「減少透明度」的旗標，所以框架沒辦法讓你讀到這個 iOS 設定。`liquid_glass_widgets` 把「增加對比」（`MediaQuery.highContrastOf`）對應到它的減少透明度模式，並提供 `GlassAccessibilityScope(reduceTransparency: true)` 讓你手動切換。用其他套件的話，就把實心樣式接到 `highContrast` 和 App 內的設定上。原生的 platform view 控制項是例外：它們會自己跟著系統設定走。

想了解這種材質本身的背景，請看我們的 [Liquid Glass 是什麼](https://liquidglassdesign.com/zh-TW/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
