English
主导航
Codex

Codex 用例

在 iOS 模拟器中调试

使用 Codex 和 XcodeBuildMCP 在 iOS 模拟器中驱动你的应用,捕获证据,并迭代修复。

难度 高级
时间周期 1h

使用 Codex 发现正确的 Xcode scheme 和模拟器,启动应用,检查 UI 树,点击、输入、滑动,捕获截图和日志,在需要时附加 LLDB,并将模糊的错误报告转化为经过验证的小型修复。

适用场景

  • 仅在模拟器中特定点击、滚动或表单输入路径之后才会出现的 UI 错误
  • 崩溃、挂起或导航中断,Codex 需要在编辑代码之前获取日志、截图、视图层次结构状态和调试器回溯信息
  • 希望 Codex 负责完整的“复现-修复-验证”循环,而不是让人类手动点击每个状态的团队

目录

    ← 所有用例

    在 iOS 模拟器中调试

    使用 Codex 和 XcodeBuildMCP 在 iOS 模拟器中驱动你的应用,捕获证据,并迭代修复。

    使用 Codex 发现正确的 Xcode scheme 和模拟器,启动应用,检查 UI 树,点击、输入、滑动,捕获截图和日志,在需要时附加 LLDB,并将模糊的错误报告转化为经过验证的小型修复。

    高级
    1h

    使用 Codex 发现正确的 Xcode scheme 和模拟器,启动应用,检查 UI 树,点击、输入、滑动,捕获截图和日志,在需要时附加 LLDB,并将模糊的错误报告转化为经过验证的小型修复。

    高级
    1h

    适用场景

    • 仅在模拟器中特定点击、滚动或表单输入路径之后才会出现的 UI 错误
    • 崩溃、挂起或导航中断,Codex 需要在编辑代码之前获取日志、截图、视图层次结构状态和调试器回溯信息
    • 希望 Codex 负责完整的“复现-修复-验证”循环,而不是让人类手动点击每个状态的团队

    技能与插件

    • 使用 iOS 调试器代理和 XcodeBuildMCP 在模拟器上构建、启动、检查和驱动应用,然后在 Codex 缩小错误范围的同时捕获日志、截图和堆栈跟踪。
    技能 为什么使用它
    构建 iOS 应用 使用 iOS 调试器代理和 XcodeBuildMCP 在模拟器上构建、启动、检查和驱动应用,然后在 Codex 缩小错误范围的同时捕获日志、截图和堆栈跟踪。

    起始提示词

    使用“构建 iOS 应用”插件和 XcodeBuildMCP 直接在模拟器中重现此错误,诊断根本原因并实施小型修复。错误报告:[描述预期行为、实际错误以及任何已知的屏幕或账户设置。] 约束: - 首先检查是否已选择项目、scheme 和模拟器。如果未选择,请发现正确的 Xcode 项目或工作区,选择应用 scheme,挑选一个模拟器,并在会话的其余部分复用该设置。 - 在模拟器中构建并启动应用,然后在开始交互之前通过 UI 快照或截图确认正确的屏幕是否可见。 - 通过在模拟器中点击、输入、滚动和滑动,自行驱动确切的复现路径。优先使用辅助功能标签或 ID 而非原始坐标,并在布局发生变化时于下一个操作之前重新读取 UI 层次结构。 - 在调试时捕获证据:用于视觉状态的截图,故障发生前后的模拟器日志,以及当错误看起来像崩溃或挂起时的 LLDB 堆栈帧或变量。 - 如果模拟器尚未启动,请启动一个并告诉我你选择了哪个设备和操作系统。如果需要凭据或特殊的测试夹具,请暂停并仅询问缺失的输入。 - 进行解决该错误的最小代码更改,然后重新运行模拟器流程,并确切地告诉我你是如何验证该修复的。交付内容: - Codex 执行的复现步骤 - 解释该错误的关键截图、日志或堆栈详情 - 代码修复及其生效的原因 - 用于最终验证的模拟器和 scheme
    使用“构建 iOS 应用”插件和 XcodeBuildMCP 直接在模拟器中重现此错误,诊断根本原因并实施小型修复。错误报告:[描述预期行为、实际错误以及任何已知的屏幕或账户设置。] 约束: - 首先检查是否已选择项目、scheme 和模拟器。如果未选择,请发现正确的 Xcode 项目或工作区,选择应用 scheme,挑选一个模拟器,并在会话的其余部分复用该设置。 - 在模拟器中构建并启动应用,然后在开始交互之前通过 UI 快照或截图确认正确的屏幕是否可见。 - 通过在模拟器中点击、输入、滚动和滑动,自行驱动确切的复现路径。优先使用辅助功能标签或 ID 而非原始坐标,并在布局发生变化时于下一个操作之前重新读取 UI 层次结构。 - 在调试时捕获证据:用于视觉状态的截图,故障发生前后的模拟器日志,以及当错误看起来像崩溃或挂起时的 LLDB 堆栈帧或变量。 - 如果模拟器尚未启动,请启动一个并告诉我你选择了哪个设备和操作系统。如果需要凭据或特殊的测试夹具,请暂停并仅询问缺失的输入。 - 进行解决该错误的最小代码更改,然后重新运行模拟器流程,并确切地告诉我你是如何验证该修复的。交付内容: - Codex 执行的复现步骤 - 解释该错误的关键截图、日志或堆栈详情 - 代码修复及其生效的原因 - 用于最终验证的模拟器和 scheme

    将完整的模拟器循环交由 Codex 处理

    当 Codex 负责整个循环时,此用例效果最佳:选择正确的应用目标,在模拟器中启动应用,检查当前屏幕,执行复现步骤,收集日志和截图,在需要时检查堆栈跟踪,修补代码,并重新运行相同的路径以证明错误已被消除。

    使用 Build iOS Apps 插件 当你希望该循环保持自主智能体状态时。它的 iOS 调试器工作流围绕 XcodeBuildMCP 构建,这意味着 Codex 可以与已启动的模拟器进行交互,并收集人类通常手动收集的相同证据。

    当 XcodeBuildMCP 配置了模拟器自动化、UI 自动化、调试和日志记录工作流时,Codex 便能拥有完整的“复现-调试-验证”循环。如果 Codex 尚未选择项目、scheme 和模拟器,请要求它首先发现这些信息,并在会话的其余部分复用该设置。

    发挥 XcodeBuildMCP 的能力

    这些是可以提示 Codex 使用的实用功能组:

    • 项目和模拟器发现:检查 Codex 是否已知道要使用的应用目标和模拟器,发现 Xcode 项目或工作区,枚举 scheme,查找或启动模拟器,并保持该设置在未来的构建/运行步骤中稳定不变。
    • 构建和启动控制:构建活动的应用目标,安装并启动模拟器构建版本,在需要时重新启动并捕获日志,以及在 Codex 需要检查特定于应用的运行时日志时解析应用包 ID。
    • UI 检查和交互:读取屏幕上的辅助功能层次结构,截取屏幕截图,点击控件,在字段中输入,滚动列表,以及执行边缘滑动或其他模拟器手势。
    • 日志和调试器状态:流式传输模拟器日志,将 LLDB 附加到正在运行的应用,设置断点,检查堆栈帧和局部变量,以及在崩溃或挂起需要更深入检查时运行调试器命令。

    关键习惯是要求 Codex 在点击之前检查视图树。XcodeBuildMCP 公开了辅助功能层次结构及坐标,因此 Codex 可以优先使用稳定的标签或元素 ID,而不是猜测原始屏幕位置。

    将模糊的错误转化为可重现的脚本

    当你给出一个具体的错误和一个预期结果,然后让 Codex 自主驱动应用并收集证据时,iOS 调试器技能最为有效。如果需要登录、深度链接或测试夹具,请说明一次,并要求 Codex 仅在缺失的输入阻碍进度时才暂停。

    实用技巧

    要求提供证据,而不仅仅是修复

    请求 Codex 用来解释错误的确切模拟器、scheme、截图、日志片段和堆栈详情。这使得最终的补丁比“我认为这应该能修复它”更容易审查。

    优先使用辅助功能标签而不是坐标

    如果 Codex 必须通过坐标点击是因为某个控件没有稳定的标签或辅助功能标识符,请要求它指出这一点。这通常是一个信号,表明错误修复还应包含一个小幅的 UI 可测试性改进。

    每次运行只处理一个错误

    模拟器驱动的调试循环非常强大,但当一个提示只针对一个故障模式时,它仍然更容易让人信任。要求 Codex 在扩展到相邻问题之前完成一个“复现-修复-验证”循环。

    技术栈

    需求

    模拟器自动化

    默认选项

    XcodeBuildMCP

    为何需要它

    当前的工具表面涵盖了模拟器设置、构建和启动、UI 快照、点击、输入、手势、截图、日志捕获和调试器附加。

    需求

    智能体工作流

    为何需要它

    该插件的 iOS 调试器代理为 Codex 提供了一个清晰的、以模拟器为中心的循环,用于重现错误、收集证据并在每次更改后验证修复。

    需求

    应用可观测性

    默认选项

    Logger, OSLog、LLDB 和模拟器截图

    为何需要它

    Codex 可以使用日志和调试器状态来解释哪里出了问题,然后保存截图以证明修复前后的确切 UI 状态。

    需求 默认选项 为何需要它
    模拟器自动化 XcodeBuildMCP 当前的工具表面涵盖了模拟器设置、构建和启动、UI 快照、点击、输入、手势、截图、日志捕获和调试器附加。
    智能体工作流 Build iOS Apps 插件 该插件的 iOS 调试器代理为 Codex 提供了一个清晰的、以模拟器为中心的循环,用于重现错误、收集证据并在每次更改后验证修复。
    应用可观测性 Logger , OSLog 、LLDB 和模拟器截图 Codex 可以使用日志和调试器状态来解释哪里出了问题,然后保存截图以证明修复前后的确切 UI 状态。

    相关用例