# Build & Run

Xcode 프로젝트를 소스에서 빌드해 iPhone이나 iPad에서 한 번에 실행합니다. 직접 사용하거나 AI 에이전트에게 맡길 수 있습니다.

Build & Run은 Xcode 프로젝트를 소스에서 빌드해 기기에서 실행하기까지 한 번에 처리합니다. Inspector에서 직접 사용하거나, AI 에이전트가 이 기능으로 모든 변경 사항을 실제 기기에서 테스트하게 할 수 있습니다.

## 1. 요구 사항
* Mac에 설치된 **Xcode**
* 기기용으로 빌드되고 **자동 서명**(automatic signing)이 켜져 있는 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로 설치하는 데 실패하면 케이블을 연결하고 다시 시도하세요. 케이블로 연결하면 따로 필요한 것은 없습니다.