Build iOS Apps 插件保姆级教程:小白从 0 到 1 做一个 iOS 工具

这篇教程的目标很明确：用 Codex + Build iOS Apps 插件，从零做一个 SwiftUI 姨妈记录 App。

官方对 Build iOS Apps 的定位是：让 Codex 帮你搭建、构建和调试 iPhone / iPad 的 SwiftUI App，并尽量保持 xcodebuild / Tuist 这种命令行优先的构建流程。

一、你需要准备什么

先准备这些东西：

Codex App 官方支持 macOS 和 Windows，不过做 iOS 原生 App 时，实际构建还是建议在 Mac + Xcode 环境里完成；官方 iOS 用例也强调通过 xcodebuild 保持 CLI-first 构建循环。

推荐一个自用的 GPT 官方直冲网站（正规稳定）：cnmgpt.com

Codex 登录遭遇手机验证？解决手机验证的两种最新方案

二、安装 Codex

方式一：用 Codex App

打开 Codex App 后登录你的 ChatGPT 账号，然后选择一个项目文件夹。官方说明，Codex App 是一个桌面端工作台，可以选择项目文件夹，让 Codex 在本机工作。

方式二：用 Codex CLI

Mac 终端执行：brew install --cask codex或者：npm install -g @openai/codex

然后运行：codex

官方 Codex CLI 仓库也给出了 npm、Homebrew 等安装方式。

三、安装 Build iOS Apps 插件

Codex App 里安装

打开 Codex App：安装 Build iOS Apps 插件。

官方插件文档说明，Codex App 里可以打开 Plugins 目录，浏览并安装 OpenAI curated 插件。安装后，新开一个 thread，然后在提示词里让 Codex 使用这个插件即可。

Codex CLI 里安装

进入 Codex：codex

然后输入：/plugins

搜索：Build iOS Apps

安装后确认启用。官方文档说明，CLI 里可以通过 /plugins 打开插件列表，安装、卸载插件，也可以按 Space 切换启用状态。

四、检查 Xcode 环境

终端输入：xcodebuild -version 

再输入：xcrun simctl list devices available

如果能看到 Xcode 版本和模拟器列表，说明基础环境基本没问题。

如果 xcodebuild 报错，先打开一次 Xcode，把首次启动组件安装完。

五、案例目标：做一个周期记录 App

我们这次做的 App 名字叫：CycleNote

CycleNote：一个极简周期记录 App可以记录月经开始日期、结束日期、症状、心情、周期预测和提醒。

这个案例很适合 Build iOS Apps 插件，它具备几个特点：

• 不需要后端；
• 不需要登录；
• 可以先用本地存储；
• 页面结构清晰；
• 适合 SwiftUI；
• 后续可以继续扩展隐私锁、提醒、统计图表。

核心功能：

注意：这个 App 只是做个人记录和提醒，不做医疗诊断。如果周期长期异常，应该建议用户咨询医生。

六、新建项目文件夹

终端执行：

mkdir CycleNotecd CycleNotecodex

或者在 Codex App 里创建项目

进入 Codex 后，直接投喂下面这段提示词。

七、第一段提示词：让 Codex 生成 App

使用 @Build iOS Apps 从零创建一个 iOS SwiftUI App。项目名称：CycleNoteApp 类型：一个极简、隐私优先的周期记录 App，类似姨妈记录工具。目标：做一个本地运行的 iPhone / iPad App。不接后端，不需要登录，不上传用户数据。所有记录先使用本地存储保存。核心功能：1. 首页 Dashboard- 显示 App 名称 CycleNote- 显示当前周期状态- 显示距离下次预计开始日期还有几天- 显示最近一次记录的开始日期和结束日期- 提供「新增记录」按钮- 使用 SwiftUI NavigationStack2. 新增周期记录- 选择开始日期- 选择结束日期，可为空- 选择流量：少量 / 中等 / 较多- 选择症状：腹痛、头痛、疲劳、痘痘、情绪波动、腰酸- 选择心情：开心、平静、焦虑、低落、易怒- 添加备注- 保存到本地3. 历史记录- 列表展示所有周期记录- 显示开始日期、结束日期、持续天数- 支持删除记录- 支持进入详情页查看4. 周期预测- 默认周期长度为 28 天- 如果用户有历史记录，则根据最近 3 次开始日期计算平均周期- 预测下次开始日期- 预测结果只作为参考，不作为医疗建议5. 设置页- 设置默认周期长度，默认 28 天- 设置默认经期长度，默认 5 天- 是否开启提醒- 是否开启隐私模式- 使用 UserDefaults 保存设置6. 隐私设计- 不需要账号- 不接入网络请求- 不上传数据- 首页不要直接显示过于敏感的文字- 隐私模式开启后，用「周期记录」代替更敏感的表达技术要求：- SwiftUI- iOS 17+- 不使用第三方依赖- 使用 UserDefaults 或 Codable 本地保存数据- 文件结构清晰- 拆分 Views、Models、Services- 适配 iPhone 和 iPad- UI 风格极简、干净、官方、柔和构建要求：- 保持 CLI-first- 使用 xcodebuild 构建- 创建 scripts/build_and_run.sh- 脚本需要能构建并启动 iOS Simulator- 告诉我使用的 scheme、simulator、验证命令交付内容：1. 完整 SwiftUI 项目2. 文件结构说明3. 关键数据模型说明4. build_and_run.sh5. 如何在 Xcode 打开6. 如何在模拟器运行7. 后续如何继续加功能

官方推荐 iOS 项目使用 Codex 时保持 CLI-first，也就是让构建流程尽量通过 xcodebuild 这类命令完成，而不是完全依赖 Xcode 图形界面。

八、让 Codex 先构建，不要急着加功能

项目生成后，马上发第二段：

先不要继续加功能。请检查当前 CycleNote 项目是否能成功构建。要求：1. 使用 xcodebuild 做最小构建验证2. 如果失败，读取完整报错3. 只修复导致构建失败的最小问题4. 修复后再次运行构建5. 最后告诉我：   - 成功使用的 scheme   - 成功使用的 simulator   - 最终构建命令   - 是否能启动到模拟器

这一步非常重要。

不要一上来连续让它加 10 个功能。正确做法是：

先生成 -> 先构建 -> 构建通过 -> 再优化 UI -> 再加功能

九、推荐项目结构

可以要求 Codex 最终整理成这种结构：

CycleNote/├── CycleNote.xcodeproj├── CycleNote/│   ├── CycleNoteApp.swift│   ├── Models/│   │   ├── CycleRecord.swift│   │   ├── CycleSettings.swift│   │   └── Symptom.swift│   ├── Services/│   │   ├── CycleStorageService.swift│   │   ├── CyclePredictionService.swift│   │   └── ReminderService.swift│   ├── Views/│   │   ├── DashboardView.swift│   │   ├── AddRecordView.swift│   │   ├── HistoryView.swift│   │   ├── RecordDetailView.swift│   │   ├── SettingsView.swift│   │   └── Components/│   │       ├── StatusCard.swift│   │       ├── SymptomChip.swift│   │       └── MoodSelector.swift│   └── Assets.xcassets└── scripts/    └── build_and_run.sh

这样后续继续加功能时，不会所有代码都堆在一个 ContentView.swift 里。

Build iOS Apps 相关能力里也包含 SwiftUI 重构方向，适合把过大的 SwiftUI 页面拆成更小的子视图，并保持原有行为不变。

十、核心数据模型设计

你可以让 Codex 使用类似这种模型：

structCycleRecord: Identifiable, Codable{let id: UUIDvar startDate: Datevar endDate: Date?var flowLevel: FlowLevelvar symptoms: [Symptom]var mood: Moodvar note: Stringvar createdAt: Date}

枚举可以这样设计：

enumFlowLevel: String, Codable, CaseIterable{case light = "少量"case medium = "中等"case heavy = "较多"}enumSymptom: String, Codable, CaseIterable{case cramps = "腹痛"case headache = "头痛"case fatigue = "疲劳"case acne = "痘痘"case moodSwing = "情绪波动"case backPain = "腰酸"}enumMood: String, Codable, CaseIterable{case happy = "开心"case calm = "平静"case anxious = "焦虑"case sad = "低落"case irritable = "易怒"}

设置模型：

structCycleSettings: Codable{var defaultCycleLength: Int = 28var defaultPeriodLength: Int = 5var reminderEnabled: Bool = falsevar privacyModeEnabled: Bool = true}

十一、周期预测逻辑

这个 App 的预测逻辑不要做复杂。

新手版本可以这样：

如果没有历史记录：使用默认周期长度 28 天如果有 1 条历史记录：最近开始日期 + 默认周期长度如果有 2-3 条以上历史记录：计算最近几次开始日期之间的间隔取平均值得到预计下次开始日期

给 Codex 的提示词：

请完善 CyclePredictionService。要求：1. 如果没有记录，返回 nil2. 如果只有一条记录，使用该记录 startDate + 默认周期长度3. 如果有多条记录，取最近 3 次开始日期4. 计算相邻开始日期之间的天数差5. 取平均周期长度6. 用最近一次 startDate + 平均周期长度 得到预计下次开始日期7. 所有预测结果只作为参考8. 完成后运行 xcodebuild 构建验证

十二、优化 UI 的提示词

构建通过后，再让它打磨 UI。

继续优化 CycleNote 的 UI。设计方向：极简、柔和、官方、干净，不要广告感。页面要求：1. 首页使用大卡片展示当前周期状态2. 使用柔和背景和圆角卡片3. 用 SF Symbols 做图标4. 新增记录页使用分组表单5. 症状和心情用 Chip 标签选择6. 历史记录页使用简洁列表7. 设置页保持系统原生风格8. iPhone 单列布局9. iPad 自适应双列布局隐私要求：1. 首页标题默认显示 CycleNote2. 隐私模式开启时，不直接显示敏感词3. 通知提醒文案也保持克制，例如「今天记得记录状态」完成后运行 xcodebuild 最小构建验证。

十三、增加提醒功能

提醒功能可以后面再加，不要第一版就做。

提示词：

给 CycleNote 增加本地提醒功能。要求：1. 使用 UserNotifications2. 设置页里增加提醒开关3. 用户开启提醒时请求通知权限4. 根据预计下次开始日期，提前 1 天发送提醒5. 通知文案保持隐私友好，不要出现敏感词6. 如果没有预测日期，不创建提醒7. 不接入网络8. 完成后运行构建验证提醒文案示例：标题：CycleNote内容：今天记得记录一下身体状态

十四、增加隐私锁功能

后续可以加入 Face ID / Touch ID。

提示词：

给 CycleNote 增加隐私锁功能。要求：1. 使用 LocalAuthentication2. 设置页增加「隐私锁」开关3. 开启后，进入 App 时需要 Face ID / Touch ID 验证4. 验证失败时显示隐私保护占位页5. 不影响已有数据6. 不上传任何信息7. 完成后运行 xcodebuild 构建验证

这个功能很适合周期记录类 App，因为数据比较私密。

十五、增加统计页

第一版跑通后，可以继续加统计页。

提示词：

给 CycleNote 增加 StatisticsView。功能：1. 显示平均周期长度2. 显示平均经期长度3. 显示最近 3 次记录4. 显示最常见症状5. 显示最常见心情6. 数据不足时显示空状态提示7. 不使用第三方图表库8. 使用 SwiftUI 原生组件实现简洁统计卡片完成后：1. 首页增加统计入口2. 保持现有功能不变3. 运行 xcodebuild 构建验证

十六、完整操作流程

整套流程可以这样写进文章：

第 1 步：准备 Mac + Xcode第 2 步：安装 Codex第 3 步：安装 Build iOS Apps 插件第 4 步：创建 CycleNote 文件夹第 5 步：用提示词生成 SwiftUI 项目第 6 步：让 Codex 创建 build_and_run.sh第 7 步：先用 xcodebuild 构建验证第 8 步：构建通过后优化 UI第 9 步：加入周期预测第 10 步：加入提醒功能第 11 步：加入隐私锁第 12 步：加入统计页第 13 步：模拟器跑通第 14 步：真机测试第 15 步：最后再考虑 TestFlight 或 App Store

十七、常见报错处理

1. 找不到 scheme

报错类似：

The project named "CycleNote" does not contain a scheme named "CycleNote"

给 Codex 发：

xcodebuild 提示找不到 scheme。请运行 xcodebuild -list 检查当前可用 scheme。然后修正 scripts/build_and_run.sh 里的 scheme 名称。修复后重新构建。

2. 找不到模拟器

报错类似：

Unable to find a destination matching the provided destination specifier

给 Codex 发：

当前构建命令找不到指定模拟器。请运行 xcrun simctl list devices available。选择一个当前可用的 iPhone simulator。然后更新 build_and_run.sh 里的 destination。最后重新构建。

3. SwiftUI 编译失败

给 Codex 发：

当前 SwiftUI 编译失败。请读取 xcodebuild 的完整错误日志。只修复导致编译失败的最小问题。不要顺手重构其它代码。修复后再次运行同一个构建命令。

4. 页面越来越乱

给 Codex 发：

请重构当前 SwiftUI 项目。目标：1. 把过大的 View 拆成小组件2. 把业务逻辑从 View 中抽离3. 保持功能不变4. 不引入第三方库5. 重构后运行 xcodebuild 构建验证6. 总结每个文件的职责

SwiftUI 项目变大后，拆分视图和稳定状态管理很重要，OpenAI 的 SwiftUI refactor 用例也强调了把长页面拆成专门 section views、移出副作用、稳定状态和保持行为不变。

十八、最后

Build iOS Apps 插件不是一键生成 App Store 成品的神器。

它真正适合的是：让 Codex 按照 iOS 原生开发流程，帮你完成项目搭建、页面实现、构建验证、模拟器调试和后续重构。