需求
UI 架构
默认选项
在 SwiftUI 中优先采用 MV,使用 @State 和 @Environment 管理状态和依赖,并将界面拆分为职责明确的小型 View 类型
为什么需要
在引入新的视图模型层之前,先让 Codex 简化视图树和状态传递方式,通常能让大型界面更易于维护。
.md 即可查看该页面的 Markdown 版本。
Codex 使用场景
使用 Codex 将过大的 SwiftUI 界面拆分为小型子视图,同时保持行为和布局不变。
使用 Codex 和 Build iOS Apps 插件,将过长的 SwiftUI 视图按区域拆分为独立的子视图,把副作用移出 body,并让状态管理和 Observation 的使用更稳定。重构时优先采用 MV,避免引入不必要的视图模型。
使用 Codex 将过大的 SwiftUI 界面拆分为小型子视图,同时保持行为和布局不变。
使用 Codex 和 Build iOS Apps 插件,将过长的 SwiftUI 视图按区域拆分为独立的子视图,把副作用移出 body,并让状态管理和 Observation 的使用更稳定。重构时优先采用 MV,避免引入不必要的视图模型。
使用 Codex 和 Build iOS Apps 插件,将过长的 SwiftUI 视图按区域拆分为独立的子视图,把副作用移出 body,并让状态管理和 Observation 的使用更稳定。重构时优先采用 MV,避免引入不必要的视图模型。
相关链接
| 技能 | 使用理由 |
|---|---|
| Build iOS Apps | 在 Codex 修改大型 SwiftUI 界面时,使用 SwiftUI 视图重构技能提取职责明确的子视图,保持数据流稳定,简化 Observation 的用法,并保留界面的原有行为。 |
当一个 SwiftUI 文件越来越长,整个界面的代码都挤在一起,连小改动都让您担心出错时,就适合做这类重构。无需重新设计功能或引入新架构。请 Codex 在保持行为和布局的前提下,将界面拆分成小型子视图,并明确数据如何在视图之间传递,让后续改动更容易审查。
这类重构可以使用 Build iOS Apps 插件。其中的 SwiftUI 视图重构技能有明确的取舍:默认优先采用 MV 而非 MVVM,将业务逻辑放在服务或模型中,优先使用视图自身的状态和环境依赖,仅在功能确实需要时才保留视图模型。
先指定一个具体的界面文件,请 Codex 在改善代码结构的同时保持原有行为。您可以将以下重构规则直接写入提示词:
init、body、视图辅助代码和辅助方法,方便从上到下浏览。View 类型,通过少量明确的输入参数、@Binding 和回调传递所需的数据与操作。some View 的辅助计算属性,并保持每个属性简短。避免把一个庞大的界面改写成一长串返回视图片段的私有计算属性。body,并将业务逻辑移入服务或模型。if/else 分支切换整个界面。@Observable 模型的视图应使用 @State 存储该模型。仅在需要兼容目标系统版本时才使用旧式可观察对象属性包装器。重构后应验证界面行为是否保持一致。每次提取一个有实际意义的部分后,请 Codex 选择并执行能验证该界面的最小范围检查,例如构建、预览、测试或在模拟器中运行。随后,让 Codex 总结结构上有哪些变化,以及哪些方面有意保持了原样。
如果界面过于庞大,请 Codex 先将各个区域提取为独立视图,再考虑是否引入新的抽象层。视图树变得更短、结构更清晰后,往往就无需再添加视图模型。
优先传入 let 常量、@Binding 和用途单一的回调,避免将父视图使用的整个模型传给每个子视图。这样既方便单独预览提取出的各个区域,也能减少它们无意间又依赖整个界面的可能。
为便于确认重构是否安全,请 Codex 明确列出哪些方面保持了原样,包括业务规则、导航行为、数据持久化方式、分析数据的含义以及用户看到的布局。这样可以大幅缩短代码审查时间。
需求
默认选项
为什么需要
需求
UI 架构
默认选项
在 SwiftUI 中优先采用 MV,使用 @State 和 @Environment 管理状态和依赖,并将界面拆分为职责明确的小型 View 类型
为什么需要
在引入新的视图模型层之前,先让 Codex 简化视图树和状态传递方式,通常能让大型界面更易于维护。
需求
重构流程
默认选项
为什么需要
插件中的 SwiftUI 视图重构技能为 Codex 提供了明确的规则,指导它在保留原有行为的同时提取子视图、使用 Observation 并整理涉及副作用的代码。
需求
验证
默认选项
xcodebuild、预览和有针对性的 UI 检查
为什么需要
与一次性重写相比,每次提取子视图后都做一次小范围构建或在模拟器中检查,更容易确认重构保留了原有行为。
| 需求 | 默认选项 | 为什么需要 |
|---|---|---|
| UI 架构 | 在 SwiftUI 中优先采用 MV,使用 @State 和 @Environment 管理状态和依赖,并将界面拆分为职责明确的小型 View 类型 | 在引入新的视图模型层之前,先让 Codex 简化视图树和状态传递方式,通常能让大型界面更易于维护。 |
| 重构流程 | Build iOS Apps 插件 | 插件中的 SwiftUI 视图重构技能为 Codex 提供了明确的规则,指导它在保留原有行为的同时提取子视图、使用 Observation 并整理涉及副作用的代码。 |
| 验证 | xcodebuild 、预览和有针对性的 UI 检查 | 与一次性重写相比,每次提取子视图后都做一次小范围构建或在模拟器中检查,更容易确认重构保留了原有行为。 |
使用 Codex 和 Build iOS Apps 插件,确定应用应通过 App Intents...
使用 Codex 和 Build iOS Apps 插件检查现有的 iPhone 和 iPad 界面,用原生 Liquid Glass 替换自定义模糊效果或叠加的材质层。通过 iOS...
让 Codex 找到合适的 Xcode 方案和模拟器,启动应用并检查 UI 层级结构。Codex 可以模拟轻点、输入和轻扫操作,截屏并收集日志,必要时还可以附加 LLDB...