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

构建 iOS 应用

使用 Codex 搭建、构建和调试面向 iPhone 和 iPad 的 SwiftUI 应用。

Difficulty 高级
Time horizon 1 小时

使用 Codex 搭建 iOS SwiftUI 项目,通过 xcodebuild 或 Tuist 让构建循环以 CLI 为主;随着任务深入,再添加 XcodeBuildMCP 或针对特定任务的 SwiftUI 技能。

最适合

  • 希望让 Codex 从零搭建应用和构建循环的全新 iOS SwiftUI 应用项目
  • 必须让 Codex 使用方案、模拟器输出、屏幕截图或 UI 自动化才能完成任务的现有 iPhone 和 iPad 项目
  • 希望让长时间运行的 iOS UI 任务始终由智能体自主执行、以 CLI 为主,而不是依赖 Xcode GUI 的团队

Contents

    ← 全部使用场景

    构建 iOS 应用

    使用 Codex 搭建、构建和调试面向 iPhone 和 iPad 的 SwiftUI 应用。

    使用 Codex 搭建 iOS SwiftUI 项目,通过 xcodebuild 或 Tuist 让构建循环以 CLI 为主;随着任务深入,再添加 XcodeBuildMCP 或针对特定任务的 SwiftUI 技能。

    高级
    1 小时

    使用 Codex 搭建 iOS SwiftUI 项目,通过 xcodebuild 或 Tuist 让构建循环以 CLI 为主;随着任务深入,再添加 XcodeBuildMCP 或针对特定任务的 SwiftUI 技能。

    高级
    1 小时

    最适合

    • 希望让 Codex 从零搭建应用和构建循环的全新 iOS SwiftUI 应用项目
    • 必须让 Codex 使用方案、模拟器输出、屏幕截图或 UI 自动化才能完成任务的现有 iPhone 和 iPad 项目
    • 希望让长时间运行的 iOS UI 任务始终由智能体自主执行、以 CLI 为主,而不是依赖 Xcode GUI 的团队

    技能与插件

    • 构建或重构 SwiftUI 界面,采用 Liquid Glass 等现代 iOS 模式,审查运行时性能,并通过基于 XcodeBuildMCP 的工作流在模拟器中调试应用。
    Skill Why use it
    Build iOS Apps 构建或重构 SwiftUI 界面,采用 Liquid Glass 等现代 iOS 模式,审查运行时性能,并通过基于 XcodeBuildMCP 的工作流在模拟器中调试应用。

    入门提示

    搭建一个入门级 SwiftUI 应用,并添加一个构建和启动脚本,以便我在本地环境中将其接入 `Build` 操作。 限制条件: - 坚持以 CLI 为主。优先使用 Apple 的 `xcodebuild`;如果采用更简洁的设置会更合适,也可以使用 Tuist。 - 如果此代码仓库已包含完整的 Xcode 项目,请使用 XcodeBuildMCP 列出目标、选择正确的方案、构建并启动应用,并在迭代过程中截取屏幕截图。 - 复用已有的模型、导航模式和共享实用工具。 - 除非我明确要求实现多个 Apple 平台共享的版本,否则应用应专注于 iPhone 和 iPad。 - 每次更改后都使用精简且可靠的验证循环;仅当范围较小的检查通过后,再扩展到更全面的构建。 - 请说明此任务是按全新项目从零搭建,还是按现有项目修改来处理的。 交付内容: - 搭建好的应用框架或所请求的功能部分 - 一个包含确切命令的小型构建和启动脚本 - 实际执行的、范围最小的相关验证步骤 - 使用的确切方案、模拟器和检查
    搭建一个入门级 SwiftUI 应用,并添加一个构建和启动脚本,以便我在本地环境中将其接入 `Build` 操作。 限制条件: - 坚持以 CLI 为主。优先使用 Apple 的 `xcodebuild`;如果采用更简洁的设置会更合适,也可以使用 Tuist。 - 如果此代码仓库已包含完整的 Xcode 项目,请使用 XcodeBuildMCP 列出目标、选择正确的方案、构建并启动应用,并在迭代过程中截取屏幕截图。 - 复用已有的模型、导航模式和共享实用工具。 - 除非我明确要求实现多个 Apple 平台共享的版本,否则应用应专注于 iPhone 和 iPad。 - 每次更改后都使用精简且可靠的验证循环;仅当范围较小的检查通过后,再扩展到更全面的构建。 - 请说明此任务是按全新项目从零搭建,还是按现有项目修改来处理的。 交付内容: - 搭建好的应用框架或所请求的功能部分 - 一个包含确切命令的小型构建和启动脚本 - 实际执行的、范围最小的相关验证步骤 - 使用的确切方案、模拟器和检查

    搭建应用和构建循环

    对于全新开发,先直接使用提示词。请 Codex 搭建一个入门级 iOS SwiftUI 应用,并编写一个可接入 Build 操作的小型构建和启动脚本;该操作位于 本地环境

    保持构建循环以 CLI 为主。Apple 的 xcodebuild 可以列出方案,并从终端执行构建、测试、归档、build-for-testingtest-without-building 操作,让 Codex 留在智能体工作闭环中,而不必频繁切换至 Xcode GUI。

    如果您想要更简洁的项目生成工具,并且能够接受第三方工具,那么 Tuist 是很好的下一步选择。它无需 GUI 即可生成和构建 Xcode 项目,同时仍可让 Codex 从终端构建并启动应用。

    进入完整的 Xcode 项目并需要更深入的自动化时,请使用 XcodeBuildMCP。当方案、目标、模拟器控制、屏幕截图、日志和 UI 交互变得非常重要,仅靠普通 Shell 命令已无法满足需求时,正适合使用它。

    善用技能

    首次实现时,通常不需要技能或 MCP 服务器。等任务需要专门能力,或您希望将更完善的 SwiftUI 规范融入执行过程时,再添加技能。

    • SwiftUI 专家 是一项优秀的通用 SwiftUI 技能,已内置许多最佳实践。

    • SwiftUI Pro 是一项覆盖面广的 SwiftUI 审查技能,涵盖现代 API、可维护性、辅助功能和性能。

    • Liquid Glass 专家 可帮助 Codex 采用新的 iOS 26 Liquid Glass API,并调整自定义组件,使其符合最新的系统设计。

    • SwiftUI 性能 适用于功能运行缓慢或 SwiftUI 视图更新路径可疑的情况。它会扫描常见的 SwiftUI 错误,并生成按优先级排列的报告,说明应修复哪些问题,以及哪些修复能带来最大收益。

    • Swift 并发专家 可在晦涩的错误和编译器警告开始阻碍您进行所需更改时提供帮助。使用 GPT-5.6 Terra 时,您可能不太需要它;但当 Swift 并发诊断信息过多且杂乱时,它仍然很有用。

    • SwiftUI 视图重构 有助于控制文件大小,并让整个代码仓库中的 SwiftUI 代码更加一致。

    • SwiftUI 模式 可帮助您随着应用不断发展,采用可预测的 @Observable@Environment 架构模式。

    如需详细了解如何安装和使用技能,请参阅我们的 技能文档

    迭代

    初版可用后,或者如果您从现有项目开始,就可以开始迭代 UI 或行为。

    在这一步,请明确说明您希望更改什么,以及希望如何更改。

    请在提示词中明确交代:Codex 处理的是全新代码仓库还是现有 Xcode 项目,必须继续支持哪些 iOS 设备或部署目标,以及您期望采用哪种验证循环。

    提示词示例

    例如,如果您想向现有应用添加功能,可以让 Codex 进行如下更改:

    为这个 SwiftUI 应用添加新手引导流程。 限制条件: - 复用现有模型、导航模式和共享实用工具。 - 使用 XcodeBuildMCP 列出正确的目标或方案,构建并启动应用;如果需要进行视觉验证,请截取屏幕截图。 - 除非我明确要求使用共享的 iOS/macOS 抽象,否则实现应专注于 iPhone 和 iPad。 - 请准确说明您使用了哪个方案、模拟器以及哪些检查。 完成这部分功能,通过范围最小且相关的构建或运行循环进行验证,并总结所做的更改。

    实用技巧

    从基础开始

    对于全新开发,先直接使用提示词。请 Codex 搭建一个入门级 SwiftUI 应用,并编写一个可接入 Build 操作的小型构建和启动脚本;该操作位于 本地环境。首次实现时,通常不需要任何技能或 MCP 服务器。

    使用精简且可靠的验证循环

    每次更改后,让 Codex 运行范围最小、但确实能验证此次改动所涉及契约的命令。之后再扩展到更全面的构建。这样既能让 Codex 保持高效,又不会把每次编辑都当成必须完整构建应用。

    让构建循环以 CLI 为先

    让构建循环以 CLI 为先。Apple 的 xcodebuild 工具可以在终端中列出方案,并执行构建、测试、归档、build-for-testingtest-without-building 操作,让 Codex 留在智能体循环中,而不必来回切换到 Xcode 图形界面。

    善用 XcodeBuildMCP

    一旦您在完整的 Xcode 项目中工作并需要更深入的自动化,就应使用 XcodeBuildMCP。此时,您会需要处理方案、目标、模拟器控制、截图、日志和 UI 交互,单靠普通的 shell 命令已无法满足所有需求。

    Tech stack

    Need

    UI 框架

    Default options

    SwiftUI

    Why it's needed

    这是在保持 UI 代码可读的同时,为 iPhone 和 iPad 制作视图、导航和共享状态原型的最快方式。

    Need

    构建工具

    Default options

    xcodebuild 或 Tuist

    Why it's needed

    两者都能在终端中维持原生构建循环,无需依赖 Xcode GUI。

    Need

    项目自动化

    Default options

    XcodeBuildMCP

    Why it's needed

    当您需要 Codex 检查方案和目标、启动应用、截取屏幕截图,并在不脱离智能体工作闭环的情况下持续迭代时,这是一个非常合适的选择。

    Need

    分发工具

    Default options

    App Store Connect CLI

    Why it's needed

    让您的智能体全程参与,并将应用构建版本直接发送到 App Store。

    Need Default options Why it's needed
    UI 框架 SwiftUI 这是在保持 UI 代码可读的同时,为 iPhone 和 iPad 制作视图、导航和共享状态原型的最快方式。
    构建工具 xcodebuild 或 Tuist 两者都能在终端中维持原生构建循环,无需依赖 Xcode GUI。
    项目自动化 XcodeBuildMCP 当您需要 Codex 检查方案和目标、启动应用、截取屏幕截图,并在不脱离智能体工作闭环的情况下持续迭代时,这是一个非常合适的选择。
    分发工具 App Store Connect CLI 让您的智能体全程参与,并将应用构建版本直接发送到 App Store。

    相关使用场景