Como Rodar Seu App Flutter no iPhone via USB (Passo a Passo Simples)

Quer testar seu app Flutter direto no iPhone via cabo USB? Perfeito! 😄 Neste artigo, você vai aprender como fazer isso de forma prática, mesmo que seja sua primeira vez usando o Xcode.

Vamos direto ao ponto? Bora lá! 💡

🔧 Passo 1 – Abra o Projeto Flutter no Xcode

Antes de qualquer coisa, você precisa abrir o projeto Flutter no Xcode, mas atenção para não abrir o arquivo errado.

No seu Mac, vá até a pasta do seu projeto Flutter.
Entre na subpasta ios/.
Abra o arquivo Runner.xcworkspace (não abra o Runner.xcodeproj!).

Dica: o .xcworkspace é usado porque o Flutter usa CocoaPods, e esse arquivo é o que garante que tudo esteja integrado corretamente no iOS.

🔌 Passo 2 – Conecte seu iPhone via USB

Agora conecte seu iPhone ao Mac com um cabo USB.

Se aparecer uma mensagem no iPhone perguntando se você confia no computador, toque em "Confiar" e digite o código de desbloqueio.
Isso é necessário para permitir que o Xcode instale o app no seu dispositivo.

📱 Passo 3 – Escolha seu iPhone no Xcode

Com o Xcode aberto:

Olhe no canto superior da janela, próximo ao botão "Play" (ícone de ▶️).
Clique no menu suspenso de dispositivos.
Selecione seu iPhone real (não escolha um simulador!).

✅ Passo 4 – Configure a Assinatura do App (Signing)

Para o app rodar no iPhone, você precisa configurar a assinatura com sua conta Apple.

Na lateral do Xcode, clique no ícone azul do projeto chamado Runner.
Vá em Targets > Runner > Signing & Capabilities.
Em "Team", selecione sua conta Apple.

Se você ainda não adicionou sua conta, clique em "Add Account..." e entre com seu Apple ID.
O campo Bundle Identifier precisa ser único. Você pode usar algo como com.seunome.nomeapp.

Exemplo: com.joaosilva.elitequiz

📲 Passo 5 – Autorize o Desenvolvimento no iPhone

Às vezes, aparece um aviso dizendo que o dispositivo não está registrado para desenvolvimento:

Clique para registrar o iPhone.
Se for necessário, o Xcode vai criar um certificado gratuito de desenvolvedor – confirme e prossiga.

▶️ Passo 6 – Compile e Rode o App!

Agora sim! Tudo pronto para rodar seu app:

Clique no botão Play (▶️) no Xcode.
Aguarde a compilação e instalação no seu iPhone.

⚠️ A primeira vez pode demorar um pouco, especialmente se for um projeto grande. Tenha paciência!

🚀 Conclusão

E pronto! Agora seu app Flutter está rodando direto no seu iPhone via cabo USB. Isso é super útil para testar funcionalidades reais, como câmera, GPS ou push notifications.

Se tiver problemas com certificados ou configuração de conta, não hesite em pedir ajuda – essa parte costuma gerar dúvidas mesmo. 😅