部落格

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 與網頁
  11. renderer 文件裡的效能原則
  12. 該用哪一個
  13. 參考資料

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 做不出這種自訂面板。

透明玻璃播放器面板上有播放控制按鈕,背後是照片網格,照片在面板邊緣彎折並泛出彩虹色邊
Liquid Glass Music Player by Amine Kaddari。 在作品集中查看

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 指南有介紹。

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」鏡頭),以及一個圓形翻轉按鈕。三者放進同一個圖層,整條工具列只要一份背景副本。

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

想了解這種材質本身的背景,請看我們的 Liquid Glass 是什麼說明文章。

版本、設定與數據核對於 2026 年 11 月 14 日。

參考資料

分享這篇文章

每週更新,精選新參考

精選 Liquid Glass 作品,每一個都附上實作方式。

一週一封,英文內容,一鍵取消訂閱。