# Build & Run

一步从源代码构建 Xcode 项目并在 iPhone 或 iPad 上启动，可以自己操作，也可以交给 AI Agent。

Build & Run 一步就能把 Xcode 项目从源代码变成设备上运行的 App。你可以在 Inspector 中使用它，也可以让 AI Agent 用它在真机上测试每一处改动。

## 1. 要求
* Mac 上已安装 **Xcode**。
* 一个可以为设备构建的 Xcode 项目或工作区，并已打开**自动签名**。
* [Device MCP Pro](../license.md)。

## 2. 在 Inspector 中使用 Build & Run
1. 显示 Inspector（<kbd>⌥⌘0</kbd>），然后点击 **Build & Run** 标签页。
2. 点击 **Choose…**，选择项目文件夹、`.xcodeproj` 或 `.xcworkspace`。
3. 选择一个 **Scheme**，或保留 **Automatic**。
4. 选择 **Debug** 或 **Release**。
5. 点击 **Build & Run**。

按钮会实时显示每个步骤：打开项目、构建、安装和启动。完成后会显示 **Succeeded** 及耗时，此时 App 已在设备上运行。点击 **Stop** 可取消构建。

如果构建失败，请查看按钮下方的日志了解原因。

## 3. 通过 AI Agent 使用 Build & Run
让 Agent 构建并运行你的 App，例如：

* “构建 App，在我的 iPhone 上运行，检查首页是否能正常加载。”
* “修复这个布局 Bug，然后在 iPad 上运行并截图。”

Agent 会构建、安装并启动 App，然后逐一轻点各个界面并截图，检查自己的工作成果。如果 App 崩溃，Agent 可以读取崩溃报告，报告会指向你代码中的具体行。

{% hint style="info" %}
Agent 构建并运行前，Device MCP 会先询问你，除非你选择了 **Always Allow**。请参阅[操作审批](approvals.md)。
{% endhint %}

## 4. 通过 Wi-Fi
Build & Run 也支持 Wi-Fi，前提是 Xcode 同样能通过网络访问该设备。如果通过 Wi-Fi 安装失败，请连接数据线后重试。使用数据线时无需任何额外设置。