Índice
1. Archive cinza / desativado no menu
O item Product → Archive aparece cinza (não clicável) na maioria das vezes por dois motivos: o destino de build é um simulador, ou o scheme selecionado não é um scheme de app (é um scheme de framework ou biblioteca). Esses são os casos mais comuns — veja a solução nos próximos tópicos.
2. Destino selecionado é simulador
Esta é a causa número um de Archive desativado. Quando o destino selecionado no Xcode é um simulador (ex: "iPhone 15 Pro (Simulator)"), o Archive fica indisponível — você só consegue fazer archive para dispositivos reais ou "Any iOS Device (arm64)".
Mudar o destino para dispositivo
Na barra superior do Xcode, clique no seletor de destino (ao lado do nome do scheme). Selecione "Any iOS Device (arm64)" — ou conecte um iPhone físico e selecione-o. O menu Archive ficará disponível imediatamente.
3. Scheme errado selecionado
Se o projeto tem múltiplos targets (app + extensões + frameworks), o scheme selecionado precisa ser o scheme do app principal — não o de um framework ou extensão isolada. Schemes de frameworks não geram archives de distribuição.
Selecionar o scheme correto
Clique no nome do scheme na barra superior do Xcode. Selecione o scheme que corresponde ao target principal do app (geralmente com o nome do app, sem sufixos como "Tests", "Widget" ou "Extension"). Verifique também que o scheme está configurado para Archive: Product → Scheme → Edit Scheme → Archive → Build Configuration deve estar como "Release".
4. Erros de compilação bloqueando o archive
O Archive só é possível se o projeto compila sem erros. Se há erros de compilação, o Xcode não deixa prosseguir para o archive.
Resolver todos os erros primeiro
Antes de tentar archive, faça Product → Build (⌘B) e corrija todos os erros vermelhos no painel de Issues (não apenas warnings). Erros em dependências de terceiros geralmente requerem atualização de pods ou packages.
5. Problemas de signing
Erros de signing durante o archive ("No signing certificate", "Provisioning profile not found") acontecem quando os certificados estão ausentes, expirados ou incompatíveis com o perfil selecionado.
Usar Automatic Signing
Em Xcode → Target → Signing & Capabilities, marque "Automatically manage signing" e selecione seu time (Apple ID com conta de desenvolvedor). O Xcode vai criar ou renovar os certificados e perfis necessários automaticamente. Se o erro persistir, vá em Xcode → Settings → Accounts e faça "Download Manual Profiles".
6. Conflito com CocoaPods
Projetos React Native e alguns projetos nativos que usam CocoaPods frequentemente têm problemas de archive causados por configurações incorretas dos pods.
Abrir o .xcworkspace, não o .xcodeproj
Projetos com CocoaPods precisam ser abertos pelo arquivo .xcworkspace — não o .xcodeproj. Se você abriu o arquivo errado, feche o Xcode, abra o .xcworkspace e tente archive novamente. Se necessário, rode pod install no terminal antes de abrir o Xcode.
7. Framework incompatível (arm64 / x86_64)
Frameworks compilados apenas para simulador (x86_64) causam falha de archive porque o archive de distribuição requer arm64. Isso é comum em SDKs antigos ou frameworks internos não atualizados.
Excluir arquiteturas de simulador
Em Build Settings do target → Excluded Architectures → para o tipo de build "Release", adicione x86_64. Isso instrui o Xcode a ignorar binários de simulador durante o archive. Alternativamente, atualize o SDK para uma versão que inclua XCFrameworks (o formato moderno que suporta ambas as arquiteturas corretamente).
8. Checklist completo antes de gerar archive
- Destino selecionado: Any iOS Device (arm64)
- Scheme: nome do app principal, configuração Archive em Release
- Build sem erros: ⌘B compila sem erros vermelhos
- Signing: Automatic Signing ativo com conta válida
- Bundle ID: idêntico ao App ID no portal Apple
- Versão e build number: incrementados em relação ao último upload
- CocoaPods: abrindo o
.xcworkspace(não o.xcodeproj) - Xcode atualizado: versão mais recente disponível na Mac App Store
✓ Após gerar o archive com sucesso, ele aparece no Xcode Organizer (Window → Organizer). De lá você distribui para o App Store Connect com um clique em "Distribute App".
Quer que a gente publique por você?
App Store e Google Play em até 7 dias. A partir de R$1.800.
Solicitar publicação