# Build & Run

Xcode プロジェクトをソースからビルドし、iPhone や iPad でワンステップで起動します。自分で使うことも、AI エージェントに任せることもできます。

Build & Run を使うと、Xcode プロジェクトのソースから、デバイス上でアプリが動く状態まで、ワンステップで進められます。Inspector から使うことも、AI エージェントに使わせて、変更のたびに実機でテストさせることもできます。

## 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** と表示され、デバイス上でアプリが起動した状態になります。ビルドを中止するには **Stop** をクリックします。

ビルドに失敗した場合は、ボタンの下にあるログで原因を確認してください。

## 3. AI エージェントから Build & Run を使う
アプリのビルドと実行をエージェントに頼みます。たとえば：

* 「アプリをビルドして iPhone で実行し、ホーム画面が表示されるか確認して。」
* 「レイアウトのバグを直してから iPad で実行し、スクリーンショットを撮って。」

エージェントはアプリをビルド、インストール、起動したあと、アプリを操作してスクリーンショットを撮り、自分の作業を確認します。アプリがクラッシュした場合は、エージェントがクラッシュレポートを読めます。レポートにはコードの該当行が示されます。

{% hint style="info" %}
**Always Allow** を選択していない限り、エージェントがビルドと実行を行う前に、Device MCP があなたに確認します。[承認](approvals.md)を参照してください。
{% endhint %}

## 4. Wi-Fi 経由で使う
Xcode もネットワーク経由でデバイスにアクセスできれば、Build & Run は Wi-Fi 経由でも動作します。Wi-Fi 経由でのインストールに失敗した場合は、ケーブルを接続してもう一度試してください。ケーブルで接続していれば、ほかに必要なものはありません。