如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
Codex

Codex 應用案例

導入 Liquid Glass

使用 Codex 搭配 iOS 26 API 和 Xcode 26,將現有的 SwiftUI 應用程式移轉至 Liquid Glass。

難度 Advanced
任務時間跨度 1h

使用 Codex 和 Build iOS Apps 外掛程式檢視現有的 iPhone 與 iPad 介面,以原生 Liquid Glass 取代自訂的模糊效果或堆疊的材質圖層。透過 iOS 26 API 可用性檢查與模擬器驗證,降低移轉風險。

最適合的對象

  • 準備為現有 SwiftUI 應用程式導入 iOS 26 Liquid Glass,需要將概略的改版方向化為具體移轉計畫的團隊
  • 希望由 Codex 先檢視自訂卡片、彈出面板、標籤列、工具列與動作按鈕,再分段完成移轉的團隊
  • 仍須支援舊版 iOS 的應用程式,需要透過 `#available(iOS 26, *)` 為舊版保留替代介面,避免改版後只能使用新介面

目錄

    ← 所有應用案例

    導入 Liquid Glass

    使用 Codex 搭配 iOS 26 API 和 Xcode 26,將現有的 SwiftUI 應用程式移轉至 Liquid Glass。

    使用 Codex 和 Build iOS Apps 外掛程式檢視現有的 iPhone 與 iPad 介面,以原生 Liquid Glass 取代自訂的模糊效果或堆疊的材質圖層。透過 iOS 26 API 可用性檢查與模擬器驗證,降低移轉風險。

    Advanced
    1h

    使用 Codex 和 Build iOS Apps 外掛程式檢視現有的 iPhone 與 iPad 介面,以原生 Liquid Glass 取代自訂的模糊效果或堆疊的材質圖層。透過 iOS 26 API 可用性檢查與模擬器驗證,降低移轉風險。

    Advanced
    1h

    最適合的對象

    • 準備為現有 SwiftUI 應用程式導入 iOS 26 Liquid Glass,需要將概略的改版方向化為具體移轉計畫的團隊
    • 希望由 Codex 先檢視自訂卡片、彈出面板、標籤列、工具列與動作按鈕,再分段完成移轉的團隊
    • 仍須支援舊版 iOS 的應用程式,需要透過 `#available(iOS 26, *)` 為舊版保留替代介面,避免改版後只能使用新介面

    技能與外掛程式

    • 運用 SwiftUI Liquid Glass、SwiftUI 介面設計模式與模擬器除錯技能,為 iOS 畫面導入原生玻璃效果,並在 iOS 26 模擬器上驗證更新後的介面。
    技能 使用理由
    Build iOS Apps 運用 SwiftUI Liquid Glass、SwiftUI 介面設計模式與模擬器除錯技能,為 iOS 畫面導入原生玻璃效果,並在 iOS 26 模擬器上驗證更新後的介面。

    入門提示詞

    請使用 Build iOS Apps 外掛程式及其 SwiftUI Liquid Glass 技能,將這個應用程式中一個使用頻率高的操作流程移轉至 Liquid Glass。 移轉要求: - 以 iOS 26 和 Xcode 26 為移轉基準,並使用 `#available(iOS 26, *)` 為較早的部署目標保留不含玻璃效果的介面。 - 先檢視整個流程,列出哪些自訂背景、堆疊的模糊圖層、膠囊標籤、按鈕、彈出面板與工具列應改用原生 Liquid Glass,以及哪些區域應維持一般內容的呈現方式。 - 優先使用系統控制項與原生 API,例如 `glassEffect`、`GlassEffectContainer`、`glassEffectID`、`.buttonStyle(.glass)` 和 `.buttonStyle(.glassProminent)`,以減少自訂模糊效果的使用。只有在元素之間的變形轉場確實能改善操作流程時,才搭配使用 `glassEffectID` 與 `@Namespace`。 - 先套用版面配置與視覺修飾器,再套用 `glassEffect`。維持形狀一致,並只在會回應觸控的控制項上使用 `.interactive()`。 - 使用 XcodeBuildMCP 建置應用程式,在 iOS 26 模擬器上執行,並擷取移轉後的流程畫面。請列明使用的建置方案、模擬器及實際執行的檢查項目。 交付內容: - 這個流程的簡要移轉計畫 - 已完成 Liquid Glass 移轉的流程片段 - 替代介面在執行 iOS 26 之前版本的裝置上的運作方式 - 實際執行的模擬器驗證步驟,以及驗證時使用的螢幕截圖
    請使用 Build iOS Apps 外掛程式及其 SwiftUI Liquid Glass 技能,將這個應用程式中一個使用頻率高的操作流程移轉至 Liquid Glass。 移轉要求: - 以 iOS 26 和 Xcode 26 為移轉基準,並使用 `#available(iOS 26, *)` 為較早的部署目標保留不含玻璃效果的介面。 - 先檢視整個流程,列出哪些自訂背景、堆疊的模糊圖層、膠囊標籤、按鈕、彈出面板與工具列應改用原生 Liquid Glass,以及哪些區域應維持一般內容的呈現方式。 - 優先使用系統控制項與原生 API,例如 `glassEffect`、`GlassEffectContainer`、`glassEffectID`、`.buttonStyle(.glass)` 和 `.buttonStyle(.glassProminent)`,以減少自訂模糊效果的使用。只有在元素之間的變形轉場確實能改善操作流程時,才搭配使用 `glassEffectID` 與 `@Namespace`。 - 先套用版面配置與視覺修飾器,再套用 `glassEffect`。維持形狀一致,並只在會回應觸控的控制項上使用 `.interactive()`。 - 使用 XcodeBuildMCP 建置應用程式,在 iOS 26 模擬器上執行,並擷取移轉後的流程畫面。請列明使用的建置方案、模擬器及實際執行的檢查項目。 交付內容: - 這個流程的簡要移轉計畫 - 已完成 Liquid Glass 移轉的流程片段 - 替代介面在執行 iOS 26 之前版本的裝置上的運作方式 - 實際執行的模擬器驗證步驟,以及驗證時使用的螢幕截圖

    以 iOS 26 為移轉起點

    導入 Liquid Glass 時,先從移轉至 iOS 26 和 Xcode 26 著手。使用 iOS 26 SDK 重新建置應用程式,看看標準 SwiftUI 控制項會自動呈現哪些效果,再請 Codex 重新設計那些看起來仍然過於扁平、厚重,或與系統介面不協調的自訂元件。

    如果應用程式仍支援舊版 iOS,請一開始就明確說明這項限制。Build iOS Apps 外掛程式中的 SwiftUI Liquid Glass 技能應使用 #available(iOS 26, *) 檢查系統版本,只在 iOS 26 或更新版本上呼叫玻璃效果專用的新 API,並保留替代實作,讓介面在舊裝置上依然清楚易讀。

    使用 iOS 外掛程式

    如果希望 Codex 修改 SwiftUI 介面並在模擬器上驗證結果,可以使用 Build iOS Apps 外掛程式。導入 Liquid Glass 時,可以先請 Codex 檢視一個操作流程,挑選其中幾個介面元素進行移轉,再於 iOS 26 模擬器上啟動應用程式並擷取畫面,之後再擴大範圍。

    這個外掛程式內含 SwiftUI Liquid Glass 技能。撰寫提示詞時,可以沿用這項技能的幾項預設做法:

    • 優先使用原生 glassEffect、GlassEffectContainer、玻璃按鈕樣式及 glassEffectID 轉場效果,減少使用自訂模糊視圖。
    • 先套用版面配置與視覺修飾器,再套用 .glassEffect(...),讓材質貼合你想要的最終形狀。
    • 多個玻璃元素同時出現時,使用 GlassEffectContainer 將相關元素包在一起。
    • 只對確實會回應觸控的按鈕、標籤按鈕及其他控制項使用 .interactive()。
    • 同一功能中的邊角形狀、著色與間距應保持一致,避免為個別元素混搭不同的玻璃效果。
    • 若支援 iOS 26 以前的版本,請保留不使用玻璃效果的替代實作。

    如需瞭解如何安裝外掛程式和技能,請參閱外掛程式與技能文件。

    觀看 WWDC 議程影片

    在請 Codex 重構正式環境中的操作流程前,可以先參考以下 WWDC25 議程影片:

    先請 Codex 規劃移轉,再實作其中一部分

    將「哪些地方適合使用玻璃效果?」和「現在就寫出所有程式碼」分成兩個階段,能讓 Codex 更順利地完成 Liquid Glass 移轉。先請智慧體快速檢視現有介面,再讓它實作其中一個可獨立完成的部分,並在模擬器上驗證。

    實用技巧

    選擇性地套用玻璃效果

    Liquid Glass 應讓使用者清楚辨識內容上方的控制層。若每張卡片都變成發光面板,這種層次就難以分辨。請 Codex 移除與系統材質不協調的裝飾性背景,在最重視可讀性的地方讓內容維持簡潔,並只在需要強調特定含義或凸顯主要操作時使用著色效果。

    從一個常用流程開始

    首次移轉時,從一個分頁的根畫面、詳細資訊畫面、彈出式面板、搜尋介面或初次使用引導流程著手,通常比一次移轉整個應用程式更合適。這樣更容易檢視成果,也能看出哪些 Liquid Glass 設計做法值得整理成可重複使用的元件模式。

    仔細檢視舊版系統上的替代行為

    如果最低部署版本早於 iOS 26,請 Codex 並列呈現替代實作與 Liquid Glass 版本,方便比對。透過這項檢查,你可以發現誤用新版 API 所造成的相容性問題,避免發布只能在最新版模擬器上運作的移轉成果。

    技術堆疊

    需求

    Liquid Glass 介面 API

    預設選項

    SwiftUI 的 glassEffect、GlassEffectContainer 與玻璃效果按鈕樣式

    為何需要

    這項技能應優先使用這些原生 API,讓 Codex 能移除自訂模糊圖層,省去自行實作材質系統的工作。

    需求

    平台版本基準

    預設選項

    iOS 26 和 Xcode 26

    為何需要

    iOS 26 SDK 開始提供 Liquid Glass。Codex 應使用 Xcode 26 編譯,並為舊版作業系統明確實作替代方案。

    需求

    模擬器驗證

    預設選項

    XcodeBuildMCP

    為何需要

    移轉介面時,建置並啟動應用程式、擷取畫面及檢查執行記錄都很重要,尤其是在檢視不同狀態與裝置尺寸下的畫面時。

    需求 預設選項 為何需要
    Liquid Glass 介面 API SwiftUI 的 glassEffect 、 GlassEffectContainer 與玻璃效果按鈕樣式 這項技能應優先使用這些原生 API,讓 Codex 能移除自訂模糊圖層,省去自行實作材質系統的工作。
    平台版本基準 iOS 26 和 Xcode 26 iOS 26 SDK 開始提供 Liquid Glass。Codex 應使用 Xcode 26 編譯,並為舊版作業系統明確實作替代方案。
    模擬器驗證 XcodeBuildMCP 移轉介面時,建置並啟動應用程式、擷取畫面及檢查執行記錄都很重要,尤其是在檢視不同狀態與裝置尺寸下的畫面時。

    相關應用案例