Índice
1. Xamarin vs. .NET MAUI
O Xamarin Forms está em fim de vida — a Microsoft encerrou o suporte oficial em maio de 2024. O sucessor oficial é o .NET MAUI (Multi-platform App UI), que usa a mesma linguagem C# mas com arquitetura modernizada.
O processo de publicação é similar para ambos: gerar um build de Release no Visual Studio e distribuir para as lojas via Xcode (iOS) ou diretamente via Android. Este guia cobre os dois, com foco no .NET MAUI para projetos novos.
⚠️ Se você tem um app em Xamarin Forms ainda em produção, migre para .NET MAUI o quanto antes — apps com dependências do Xamarin Forms podem deixar de funcionar em versões futuras do iOS e Android.
2. Pré-requisitos
- Visual Studio 2022 (Mac ou Windows) com workload .NET MAUI instalado.
- Mac com Xcode — para builds iOS. No Windows, é necessário usar um Mac em rede (Mac Build Host) ou usar um serviço de CI/CD na nuvem.
- Conta Apple Developer ($99/ano) para iOS.
- Conta Google Play Developer ($25) para Android.
3. Publicar na App Store (iOS)
Arquivo → Publicar → App Store
No Visual Studio for Mac: com o projeto selecionado, vá em Build → Archive for Publishing. Após o archive, vá em Publish to App Store. Configure a identidade de signing, selecione a conta Apple Developer e clique em Upload para enviar ao App Store Connect.
Usando Mac em rede
No Visual Studio Windows, configure o Mac Build Host em Tools → iOS → Pair to Mac. Após parear, o processo de archive e upload acontece no Mac em segundo plano — você controla pelo Visual Studio no Windows. Requer o Xcode instalado e configurado no Mac.
4. Publicar no Google Play (Android)
Mudar para configuração Release
No Visual Studio, mude a configuração de "Debug" para "Release" na barra de ferramentas. Selecione a plataforma "Android".
Archive e Sign
Vá em Build → Archive for Publishing. Após gerar o archive, o Visual Studio abre o Gerenciador de Arquivos. Clique em "Distribute..." → "Google Play" → configure a keystore → gere o AAB.
Upload no Play Console
Faça upload do AAB gerado no Google Play Console. A partir daqui, o processo é idêntico ao de qualquer app Android.
5. Signing iOS no Visual Studio
Para configurar o signing iOS no Visual Studio, acesse as propriedades do projeto iOS → iOS Bundle Signing. Selecione o esquema de signing (Automático é recomendado) e o Provisioning Profile correto. O Visual Studio se integra com as credenciais configuradas no Xcode do Mac em rede.
6. Signing Android no Visual Studio
No Visual Studio, vá em Propriedades do projeto Android → Android Package Signing. Você pode criar uma nova keystore diretamente pelo Visual Studio ou usar uma existente. As credenciais ficam salvas para builds futuros.
✓ Guarde o arquivo .keystore e as senhas em local seguro — sem eles, não é possível atualizar o app no Google Play. Veja nossa página sobre Keystore Android.
7. Problemas comuns
- Mac Build Host não conecta: verifique se o SSH está habilitado no Mac (Preferências → Compartilhamento → Login Remoto) e se o firewall não está bloqueando a conexão.
- Erro de provisioning profile no Visual Studio: abra o Xcode no Mac e configure o signing lá primeiro — o Visual Studio usa as credenciais do Xcode.
- App crasha em Release mas não em Debug (Android): problema de linker — ajuste as opções de linker nas propriedades do projeto Android.
- Build demora muito: builds de Release com AOT (Ahead of Time compilation) ativa são significativamente mais lentos. Desative AOT durante o desenvolvimento, ative apenas para publicação.
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