For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主要導覽
Codex

Codex use case

採用 Liquid Glass

使用 Codex,透過 iOS 26 API 和 Xcode 26,將現有 SwiftUI 應用程式遷移至 Liquid Glass。

Difficulty 進階
Time horizon 1 小時

使用 Codex 與 Build iOS Apps 外掛程式,稽核現有 iPhone 和 iPad UI,以原生 Liquid Glass 取代自訂模糊效果或材質堆疊,並透過 iOS 26 可用性檢查及模擬器驗證確保遷移安全。

最適合

  • 需要實際可行的 iOS 26 Liquid Glass 遷移計畫,而非含糊重新設計需求說明的現有 SwiftUI 應用程式
  • 希望 Codex 稽核自訂卡片、面板、分頁列、工具列與操作按鈕,再逐段實作遷移的團隊
  • 仍支援較舊 iOS 版本,且需要透過 `#available(iOS 26, *)` 提供後備方案,而非單向改寫視覺設計的應用程式

Contents

    ← 所有使用案例

    採用 Liquid Glass

    使用 Codex,透過 iOS 26 API 和 Xcode 26,將現有 SwiftUI 應用程式遷移至 Liquid Glass。

    使用 Codex 與 Build iOS Apps 外掛程式,稽核現有 iPhone 和 iPad UI,以原生 Liquid Glass 取代自訂模糊效果或材質堆疊,並透過 iOS 26 可用性檢查及模擬器驗證確保遷移安全。

    進階
    1 小時

    使用 Codex 與 Build iOS Apps 外掛程式,稽核現有 iPhone 和 iPad UI,以原生 Liquid Glass 取代自訂模糊效果或材質堆疊,並透過 iOS 26 可用性檢查及模擬器驗證確保遷移安全。

    進階
    1 小時

    最適合

    • 需要實際可行的 iOS 26 Liquid Glass 遷移計畫,而非含糊重新設計需求說明的現有 SwiftUI 應用程式
    • 希望 Codex 稽核自訂卡片、面板、分頁列、工具列與操作按鈕,再逐段實作遷移的團隊
    • 仍支援較舊 iOS 版本,且需要透過 `#available(iOS 26, *)` 提供後備方案,而非單向改寫視覺設計的應用程式

    技能與外掛程式

    • 使用 SwiftUI Liquid Glass、SwiftUI UI 模式和模擬器偵錯技能,讓 iOS 畫面現代化、採用原生玻璃效果,並在 iOS 26 模擬器上驗證結果。
    Skill Why use it
    Build iOS Apps 使用 SwiftUI Liquid Glass、SwiftUI UI 模式和模擬器偵錯技能,讓 iOS 畫面現代化、採用原生玻璃效果,並在 iOS 26 模擬器上驗證結果。

    起始提示詞

    使用 Build iOS Apps 外掛程式及其 SwiftUI Liquid Glass 技能,將這個應用程式中一個使用頻繁的流程遷移至 Liquid Glass。 限制條件: - 將此視為 iOS 26 + Xcode 26 遷移,但需透過 `#available(iOS 26, *)` 為較早的部署目標保留非玻璃效果的後備方案。 - 先稽核此流程。指出哪些自訂背景、模糊效果堆疊、標籤、按鈕、面板和工具列應改用原生 Liquid Glass,也指出哪些介面應維持無裝飾的內容呈現。 - 優先使用系統控制項,以及 `glassEffect`、`GlassEffectContainer`、`glassEffectID`、`.buttonStyle(.glass)` 和 `.buttonStyle(.glassProminent)` 等原生 API,而非自訂模糊效果。只有在確實能改善流程的形變轉場中,才將 `glassEffectID` 與 `@Namespace` 搭配使用。 - 在套用配置與視覺修飾器後,再套用 `glassEffect`;維持形狀一致,並僅對確實會回應觸控的控制項使用 `.interactive()`。 - 使用 XcodeBuildMCP 在 iOS 26 模擬器上建置並執行,擷取已遷移流程的螢幕截圖,並明確說明所使用的 scheme、模擬器與檢查項目。 交付項目: - 該流程的精簡遷移計畫 - 已實作的 Liquid Glass 遷移片段 - iOS 26 之前裝置的後備行為 - 使用的模擬器驗證步驟與螢幕截圖
    使用 Build iOS Apps 外掛程式及其 SwiftUI Liquid Glass 技能,將這個應用程式中一個使用頻繁的流程遷移至 Liquid Glass。 限制條件: - 將此視為 iOS 26 + Xcode 26 遷移,但需透過 `#available(iOS 26, *)` 為較早的部署目標保留非玻璃效果的後備方案。 - 先稽核此流程。指出哪些自訂背景、模糊效果堆疊、標籤、按鈕、面板和工具列應改用原生 Liquid Glass,也指出哪些介面應維持無裝飾的內容呈現。 - 優先使用系統控制項,以及 `glassEffect`、`GlassEffectContainer`、`glassEffectID`、`.buttonStyle(.glass)` 和 `.buttonStyle(.glassProminent)` 等原生 API,而非自訂模糊效果。只有在確實能改善流程的形變轉場中,才將 `glassEffectID` 與 `@Namespace` 搭配使用。 - 在套用配置與視覺修飾器後,再套用 `glassEffect`;維持形狀一致,並僅對確實會回應觸控的控制項使用 `.interactive()`。 - 使用 XcodeBuildMCP 在 iOS 26 模擬器上建置並執行,擷取已遷移流程的螢幕截圖,並明確說明所使用的 scheme、模擬器與檢查項目。 交付項目: - 該流程的精簡遷移計畫 - 已實作的 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, *) 控管新的玻璃效果專用 API,並保留在舊裝置上仍清晰易讀的後備路徑。

    善用 iOS 外掛程式

    如果想讓 Codex 將 SwiftUI UI 變更與模擬器驗證結合,請使用 Build iOS Apps 外掛程式。進行 Liquid Glass 遷移時,較有效的做法是要求 Codex 先稽核一個流程、遷移少數幾個介面,在 iOS 26 模擬器上啟動成果並擷取螢幕截圖,再擴大範圍。

    這個外掛程式內含 SwiftUI Liquid Glass 技能,其中有一組簡單的預設做法,值得納入提示詞:

    • 優先使用原生 glassEffectGlassEffectContainer、玻璃效果按鈕樣式及 glassEffectID 轉場,而不是自訂模糊效果檢視。
    • 在配置和視覺修飾器之後套用 .glassEffect(...),讓材質包覆實際想要的最終形狀。
    • 當多個介面元素一同出現時,請以 GlassEffectContainer 包裹相關的玻璃效果元素。
    • 只有按鈕、標籤及確實會回應觸控的控制項才使用 .interactive()
    • 整項功能中的圓角形狀、色調與間距應保持一致,不要混用零散的玻璃效果設計。
    • 為 iOS 26 之前的部署目標保留非玻璃效果的後備方案。

    若要進一步瞭解如何安裝外掛程式和技能,請參閱我們的 外掛程式技能 文件。

    觀看 WWDC 講座

    在要求 Codex 重構實際的正式產品流程之前,以下 WWDC25 講座是不錯的參考資料:

    先要求遷移計畫,再實作一個片段

    讓 Codex 將「哪裡應該出現玻璃效果?」與「現在就寫出所有程式碼」分開處理,Liquid Glass 遷移通常會更順利。請先要求快速稽核,再讓智慧體實作一個可獨立完成的片段,並以模擬器驗證。

    實用技巧

    不要對所有元素套用玻璃效果

    Liquid Glass 應在內容上方建立清楚的控制層,而不是把每張卡片都變成發光面板。請 Codex 移除與系統材質衝突的裝飾背景,在易讀性最重要的地方保留無裝飾的內容,並僅在需要語意強調或凸顯主要操作時使用色調。

    從一個使用頻繁的流程著手

    分頁根畫面、詳細資料畫面、面板、搜尋介面或新手引導流程,通常比一次遷移整個應用程式更適合作為第一個目標。這能讓審查更容易,也能釐清哪些 Liquid Glass 設計決策應轉化為可重複使用的元件模式。

    仔細審查後備行為

    如果部署目標低於 iOS 26,請 Codex 同時呈現後備實作與 Liquid Glass 版本。這個審查步驟能找出非預期的 API 可用性迴歸問題,避免發佈只能在最新模擬器上運作的遷移成果。

    Tech stack

    Need

    Liquid Glass UI API

    Default options

    SwiftUI ,搭配 glassEffectGlassEffectContainer 及玻璃效果按鈕樣式

    Why it's needed

    這些是技能應優先採用的原生 API,可讓 Codex 移除自訂模糊圖層,而不是重新打造材質系統。

    Need

    平台基準

    Default options

    iOS 26 和 Xcode 26

    Why it's needed

    Liquid Glass 隨 iOS 26 SDK 推出。Codex 應使用 Xcode 26 編譯,並為支援較早的作業系統版本加入明確的後備方案。

    Need

    模擬器驗證

    Default options

    XcodeBuildMCP

    Why it's needed

    進行視覺遷移時,建置、啟動、擷取螢幕截圖和檢查日誌都很重要,尤其是在檢視多種狀態與裝置尺寸時。

    Need Default options Why it's needed
    Liquid Glass UI API SwiftUI ,搭配 glassEffect GlassEffectContainer 及玻璃效果按鈕樣式 這些是技能應優先採用的原生 API,可讓 Codex 移除自訂模糊圖層,而不是重新打造材質系統。
    平台基準 iOS 26 和 Xcode 26 Liquid Glass 隨 iOS 26 SDK 推出。Codex 應使用 Xcode 26 編譯,並為支援較早的作業系統版本加入明確的後備方案。
    模擬器驗證 XcodeBuildMCP 進行視覺遷移時,建置、啟動、擷取螢幕截圖和檢查日誌都很重要,尤其是在檢視多種狀態與裝置尺寸時。

    相關使用案例