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 和 XcodeBuildMCP 在 iOS 模拟器中操作您的应用、采集证据,并通过反复迭代完成修复。

Difficulty 高级
Time horizon 1 小时

使用 Codex 找到正确的 Xcode 方案和模拟器,启动应用,检查 UI 树,执行点按、输入和轻扫操作,采集截图和日志,在需要时附加 LLDB,并将模糊的错误报告转化为一项经过验证的小幅修复。

最适合

  • 仅在模拟器中执行特定的点按、滚动或表单填写路径后才会出现的 UI 错误
  • Codex 需要先获取日志、截图、视图层次结构状态和调试器回溯,再编辑代码的崩溃、卡死或导航失效问题
  • 希望由 Codex 负责复现—修复—验证循环,而不是让人手动点击并遍历每种状态的团队

Contents

    ← 全部使用场景

    在 iOS 模拟器中调试

    使用 Codex 和 XcodeBuildMCP 在 iOS 模拟器中操作您的应用、采集证据,并通过反复迭代完成修复。

    使用 Codex 找到正确的 Xcode 方案和模拟器,启动应用,检查 UI 树,执行点按、输入和轻扫操作,采集截图和日志,在需要时附加 LLDB,并将模糊的错误报告转化为一项经过验证的小幅修复。

    高级
    1 小时

    使用 Codex 找到正确的 Xcode 方案和模拟器,启动应用,检查 UI 树,执行点按、输入和轻扫操作,采集截图和日志,在需要时附加 LLDB,并将模糊的错误报告转化为一项经过验证的小幅修复。

    高级
    1 小时

    最适合

    • 仅在模拟器中执行特定的点按、滚动或表单填写路径后才会出现的 UI 错误
    • Codex 需要先获取日志、截图、视图层次结构状态和调试器回溯,再编辑代码的崩溃、卡死或导航失效问题
    • 希望由 Codex 负责复现—修复—验证循环,而不是让人手动点击并遍历每种状态的团队

    技能与插件

    • 使用 iOS 调试器智能体,通过 XcodeBuildMCP 在模拟器中构建、启动、检查和操作应用,然后在 Codex 逐步定位错误的同时采集日志、截图和堆栈跟踪。
    Skill Why use it
    Build iOS Apps 使用 iOS 调试器智能体,通过 XcodeBuildMCP 在模拟器中构建、启动、检查和操作应用,然后在 Codex 逐步定位错误的同时采集日志、截图和堆栈跟踪。

    入门提示

    使用 Build iOS Apps 插件和 XcodeBuildMCP 直接在模拟器中复现此错误,诊断根本原因,并实施一项小幅修复。 错误报告: [Describe the expected behavior, the actual bug, and any known screen or account setup.] 约束: - 先检查是否已经选择项目、方案和模拟器。如未选择,请找到正确的 Xcode 项目或工作空间,选择应用方案和模拟器,并在会话剩余期间复用该设置。 - 在模拟器中构建并启动应用,然后在开始交互前通过 UI 快照或截图确认显示的是正确屏幕。 - 请自行在模拟器中执行点按、输入、滚动和轻扫操作,完成确切的复现路径。优先使用辅助功能标签或 ID,而非原始坐标;布局变化后,请重新读取 UI 层次结构,再执行下一操作。 - 调试时采集证据:用截图记录视觉状态,采集故障发生前后的模拟器日志;若错误疑似崩溃或卡死,还应获取 LLDB 堆栈帧或变量。 - 如果模拟器尚未启动,请启动一个,并告诉我选择了哪种设备和操作系统。如果需要凭据或特殊测试夹具,请暂停,并且只询问缺少的输入。 - 进行能解决该错误的最小幅度代码更改,然后重新执行模拟器流程,并准确说明如何验证修复。 交付内容: - Codex 执行的复现步骤 - 用于解释错误的关键截图、日志或堆栈详情 - 代码修复及其生效原因 - 最终验证使用的模拟器和方案
    使用 Build iOS Apps 插件和 XcodeBuildMCP 直接在模拟器中复现此错误,诊断根本原因,并实施一项小幅修复。 错误报告: [Describe the expected behavior, the actual bug, and any known screen or account setup.] 约束: - 先检查是否已经选择项目、方案和模拟器。如未选择,请找到正确的 Xcode 项目或工作空间,选择应用方案和模拟器,并在会话剩余期间复用该设置。 - 在模拟器中构建并启动应用,然后在开始交互前通过 UI 快照或截图确认显示的是正确屏幕。 - 请自行在模拟器中执行点按、输入、滚动和轻扫操作,完成确切的复现路径。优先使用辅助功能标签或 ID,而非原始坐标;布局变化后,请重新读取 UI 层次结构,再执行下一操作。 - 调试时采集证据:用截图记录视觉状态,采集故障发生前后的模拟器日志;若错误疑似崩溃或卡死,还应获取 LLDB 堆栈帧或变量。 - 如果模拟器尚未启动,请启动一个,并告诉我选择了哪种设备和操作系统。如果需要凭据或特殊测试夹具,请暂停,并且只询问缺少的输入。 - 进行能解决该错误的最小幅度代码更改,然后重新执行模拟器流程,并准确说明如何验证修复。 交付内容: - Codex 执行的复现步骤 - 用于解释错误的关键截图、日志或堆栈详情 - 代码修复及其生效原因 - 最终验证使用的模拟器和方案

    让 Codex 负责完整的模拟器调试循环

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

    如果您希望该循环一直由智能体自主执行,请使用 Build iOS Apps 插件。它的 iOS 调试器工作流基于 XcodeBuildMCP 构建,因此 Codex 可以与已启动的模拟器交互,并收集通常需要人工手动获取的同类证据。

    为 XcodeBuildMCP 配置模拟器自动化、UI 自动化、调试和日志记录工作流后,Codex 就能负责完整的复现—调试—验证循环。如果 Codex 尚未选择项目、方案和模拟器,请先让它找到合适的项目、方案和模拟器,并在会话剩余期间复用该设置。

    充分利用 XcodeBuildMCP 的功能

    您可以在提示中要求 Codex 使用以下几类实用功能:

    • 项目和模拟器发现:检查 Codex 是否已知道应使用哪个应用目标和模拟器,找到 Xcode 项目或工作空间,列出方案,找到或启动模拟器,并让该设置保持不变,以便用于后续构建和运行步骤。
    • 构建和启动控制:构建当前应用目标,安装并启动面向模拟器的构建版本,需要时启用日志采集并重新启动应用;如果 Codex 需要检查应用专属的运行时日志,则确定应用的捆绑包 ID。
    • UI 检查和交互:读取屏幕上的辅助功能层次结构、截图、点按控件、在字段中输入文本、滚动列表,以及执行边缘轻扫或其他模拟器手势。
    • 日志和调试器状态:流式传输模拟器日志,将 LLDB 附加到正在运行的应用,设置断点,检查堆栈帧和局部变量,并在崩溃或卡死需要深入检查时运行调试器命令。

    关键是让 Codex 在点按前检查视图树。XcodeBuildMCP 会提供辅助功能层次结构和坐标,因此 Codex 可以优先使用稳定的标签或元素 ID,而不是猜测屏幕上的原始坐标。

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

    当您的提示给出一个具体错误和一个预期结果,并让 Codex 自主操作应用和收集证据时,iOS 调试器技能的效果最好。如果需要登录、深层链接或测试夹具,请一次说明清楚,并要求 Codex 仅在缺少相关输入导致无法继续时暂停。

    实用技巧

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

    请 Codex 提供用于解释错误的具体模拟器和方案,以及截图、日志片段和堆栈详情。这样一来,最终补丁会比仅凭一句“我觉得这样应该能修好”更易于审查。

    优先使用辅助功能标签,而非坐标

    如果控件缺少稳定的标签或辅助功能标识符,导致 Codex 不得不按坐标点按,请让它明确指出这一点。这通常表明,错误修复还应包含一项小幅的 UI 可测试性改进。

    每次运行只处理一个错误

    由模拟器驱动的调试循环功能强大,但每个提示只针对一种故障模式时,您仍会更容易相信其结果。请让 Codex 完成一轮复现—修复—验证循环,再扩展到相关问题。

    Tech stack

    Need

    模拟器自动化

    Default options

    XcodeBuildMCP

    Why it's needed

    当前工具提供的功能涵盖模拟器设置、构建和启动、UI 快照、点按、文本输入、手势、截图、日志采集和调试器附加。

    Need

    智能体工作流

    Default options

    Build iOS Apps 插件

    Why it's needed

    该插件的 iOS 调试器智能体为 Codex 提供了一套清晰的模拟器优先流程,用于复现错误、收集证据,并在每次更改后验证修复。

    Need

    应用可观测性

    Default options

    LoggerOSLog、LLDB 和模拟器截图

    Why it's needed

    Codex 可以使用日志和调试器状态来解释故障原因,然后保存截图,证明修复前后的确切 UI 状态。

    Need Default options Why it's needed
    模拟器自动化 XcodeBuildMCP 当前工具提供的功能涵盖模拟器设置、构建和启动、UI 快照、点按、文本输入、手势、截图、日志采集和调试器附加。
    智能体工作流 Build iOS Apps 插件 该插件的 iOS 调试器智能体为 Codex 提供了一套清晰的模拟器优先流程,用于复现错误、收集证据,并在每次更改后验证修复。
    应用可观测性 Logger OSLog 、LLDB 和模拟器截图 Codex 可以使用日志和调试器状态来解释故障原因,然后保存截图,证明修复前后的确切 UI 状态。

    相关使用场景