SwiftUI 專家技能
操作規則
- 在每次任務開始時查閱
references/latest-apis.md,以避免使用已棄用的 API - 優先使用原生 SwiftUI API,而非 UIKit/AppKit 橋接,除非橋接是必要的
- 專注於正確性與效能;不要強制特定架構(MVVM、VIPER 等)
- 鼓勵將商業邏輯與檢視分離以提升可測試性,但不強制規定方式
- 遵循 Apple 的人機介面指南與 API 設計模式
- 僅在使用者明確要求時才採用 Liquid Glass(請參閱
references/liquid-glass.md) - 將效能最佳化建議作為建議,而非要求
- 使用
#available搭配合理的後備方案來處理版本特定 API
任務工作流程
審查現有的 SwiftUI 程式碼
- 閱讀待審查的程式碼,並識別應用的主題
- 標記已棄用的 API(與
references/latest-apis.md比對) - 為每個相關主題執行下方的主題路由器
- 驗證 iOS 26+ 功能的
#available保護與後備路徑
改進現有的 SwiftUI 程式碼
- 根據主題路由器的主題稽核現有實作
- 將已棄用的 API 替換為
references/latest-apis.md中的現代等效項 - 重構熱點路徑以減少不必要的狀態更新
- 將複雜的檢視主體提取為獨立的子檢視
- 建議在遇到
UIImage(data:)時進行圖片降採樣(可選最佳化,請參閱references/image-optimization.md)
實作新的 SwiftUI 功能
- 首先設計資料流:識別擁有的狀態與注入的狀態
- 建構最適合差異比較的檢視(及早提取子檢視)
- 套用正確的動畫模式(隱含與明確動畫、轉場)
- 對所有可點擊元素使用
Button;加入無障礙分組與標籤 - 使用
#available保護版本特定 API,並提供後備方案
主題路由器
針對與目前任務相關的每個主題,查閱對應的參考檔案:
| 主題 | 參考資料 |
|---|---|
| 狀態管理 | references/state-management.md |
| 檢視組合 | references/view-structure.md |
| 效能 | references/performance-patterns.md |
| 列表與 ForEach | references/list-patterns.md |
| 版面配置 | references/layout-best-practices.md |
| Sheet 與導航 | references/sheet-navigation-patterns.md |
| ScrollView | references/scroll-patterns.md |
| 動畫(基礎) | references/animation-basics.md |
| 動畫(轉場) | references/animation-transitions.md |
| 動畫(進階) | references/animation-advanced.md |
| 無障礙 | references/accessibility-patterns.md |
| Swift Charts | references/charts.md |
| 圖表無障礙 | references/charts-accessibility.md |
| 圖片最佳化 | references/image-optimization.md |
| Liquid Glass(iOS 26+) | references/liquid-glass.md |
| macOS 場景 | references/macos-scenes.md |
| macOS 視窗樣式 | references/macos-window-styling.md |
| macOS 檢視 | references/macos-views.md |
| 已棄用 API 查詢 | references/latest-apis.md |
正確性檢查清單
這些是嚴格規則——違反即視為錯誤:
-
@State屬性是private的 - 僅在子檢視修改父檢視狀態時使用
@Binding - 傳入的值絕不宣告為
@State或@StateObject(它們會忽略更新) -
@StateObject用於檢視擁有的物件;@ObservedObject用於注入的物件 - iOS 17+:
@State搭配@Observable;@Bindable用於需要繫結的注入 observable -
ForEach使用穩定的識別(動態內容絕不使用.indices) - 每個
ForEach元素的檢視數量固定 -
.animation(_:value:)一定包含value參數 - iOS 26+ API 使用
#available保護並提供後備方案 - 使用圖表類型的檔案中加入
import Charts
參考資料
references/latest-apis.md-- 每個任務都先讀取此檔案。 從已棄用到現代的 API 轉換(iOS 15+ 到 iOS 26+)references/state-management.md-- 屬性包裝器、資料流、@Observable遷移references/view-structure.md-- 檢視提取、容器模式、@ViewBuilderreferences/performance-patterns.md-- 熱點路徑最佳化、更新控制、_logChanges()references/list-patterns.md-- ForEach 識別、Table(iOS 16+)、行內篩選陷阱references/layout-best-practices.md-- 版面配置模式、GeometryReader 替代方案references/accessibility-patterns.md-- VoiceOver、Dynamic Type、分組、特質references/animation-basics.md-- 隱含/明確動畫、時序、效能references/animation-transitions.md-- 檢視轉場、matchedGeometryEffect、Animatablereferences/animation-advanced.md-- 階段/關鍵影格動畫(iOS 17+)、@Animatable巨集(iOS 26+)references/charts.md-- Swift Charts 標記、座標軸、選取、樣式、Chart3D(iOS 26+)references/charts-accessibility.md-- Charts VoiceOver、Audio Graph、後備策略references/sheet-navigation-patterns.md-- Sheet、NavigationSplitView、Inspectorreferences/scroll-patterns.md-- ScrollViewReader、程式化滾動references/image-optimization.md-- AsyncImage、降採樣、快取references/liquid-glass.md-- iOS 26+ Liquid Glass 效果與後備模式references/macos-scenes.md-- Settings、MenuBarExtra、WindowGroup、多視窗references/macos-window-styling.md-- 工具列樣式、視窗大小、Commandsreferences/macos-views.md-- HSplitView、Table、PasteButton、AppKit 互通