# Build & Run

Compile seu projeto Xcode a partir do código-fonte e execute-o no iPhone ou iPad em uma etapa, você mesmo ou pelo seu agente de IA.

O Build & Run leva seu projeto Xcode do código-fonte a um app rodando no dispositivo em uma única etapa. Use-o pelo Inspector ou deixe seu agente de IA usá-lo para testar cada alteração em hardware real.

## 1. Requisitos
* **Xcode** instalado no Mac.
* Um projeto ou workspace do Xcode que compile para dispositivo, com **assinatura automática** ativada.
* [Device MCP Pro](../license.md).

## 2. Build & Run pelo Inspector
1. Mostre o Inspector (<kbd>⌥⌘0</kbd>) e clique na aba **Build & Run**.
2. Clique em **Choose…** e selecione a pasta do projeto, o `.xcodeproj` ou o `.xcworkspace`.
3. Escolha um **Scheme** ou deixe em **Automatic**.
4. Escolha **Debug** ou **Release**.
5. Clique em **Build & Run**.

O botão mostra cada etapa à medida que acontece: abertura do projeto, compilação, instalação e inicialização. Quando termina, você vê **Succeeded** com o tempo que levou, e o app está rodando no dispositivo. Clique em **Stop** para cancelar um build.

Se o build falhar, leia o log abaixo do botão para ver o motivo.

## 3. Build & Run pelo seu agente de IA
Peça ao seu agente para compilar e executar seu app, por exemplo:

* *"Compile o app, execute no meu iPhone e verifique se a tela inicial carrega."*
* *"Corrija o bug de layout, depois execute no iPad e faça uma captura de tela."*

Seu agente compila, instala e abre o app, depois navega por ele com toques e faz capturas de tela para conferir o próprio trabalho. Se o app fechar inesperadamente, o agente pode ler o relatório de falhas, que aponta as linhas do seu código.

{% hint style="info" %}
O Device MCP pede sua aprovação antes de um agente compilar e executar, a menos que você tenha escolhido **Always Allow**. Veja [Aprovações](approvals.md).
{% endhint %}

## 4. Por Wi-Fi
O Build & Run também funciona por Wi-Fi, desde que o Xcode também consiga acessar o dispositivo pela rede. Se a instalação por Wi-Fi falhar, conecte o cabo e tente de novo. Com cabo, não é preciso mais nada.