Liquid Glass Design開發閱讀約 8 分鐘
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 是很好的檢驗。一塊玻璃控制面板浮在照片網格上,照片在面板邊緣彎折,還看得到色邊,播放按鈕則是小小的玻璃圓形。這需要能取樣背景的著色器套件。原生的 UIToolbar 做不出這種自訂面板。

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,沒有自訂著色器。
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裡加一筆EnableFlutterGPUmeta-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 版本會無法完成相依性解析。
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 的背景算繪成快照,再用片段著色器折射。作者在 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 連到 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在網頁上確實會折射,因為它處理的是你交給它的背景快照。如果網頁版很重要,我們的網頁效能與備援指南也適用於 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 是符合這些原則的好版面:一個圓形縮圖、一個膠囊形 segmented control(裡面是已選取的「Cinematic」鏡頭),以及一個圓形翻轉按鈕。三者放進同一個圖層,整條工具列只要一份背景副本。

該用哪一個
- 想在每個平台都用現成的 iOS 27 風格控制項:
liquid_glass_widgets。 - 正在做自訂的玻璃設計系統,也能接受預發行版:
liquid_glass_renderer,前提是它的 Dart 限制要和你的 SDK 對得上。 - 設計師在 Figma 裡定義玻璃,你希望直接沿用他們的數字:
figma_glass。 - 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 是什麼說明文章。
版本、設定與數據核對於 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