Como Publicar App Ionic na App Store e Google Play

1. Ionic + Capacitor — como funciona

Ionic é um framework para criar apps móveis com tecnologias web (Angular, React ou Vue). Desde a versão 4, o Ionic usa o Capacitor como bridge nativa — substituindo o antigo Cordova.

O Capacitor pega seu app web (HTML/CSS/JS compilado) e o empacota em um projeto Xcode (iOS) e um projeto Android Studio (Android). A partir desse ponto, o processo de publicação é idêntico ao de um app nativo — você usa o Xcode para publicar no iOS e o Android Studio para o Android.

2. Pré-requisitos

• Node.js instalado com Ionic CLI: npm install -g @ionic/cli
• Capacitor CLI: incluído no projeto Ionic moderno
• Mac com Xcode para builds iOS
• Android Studio para builds Android
• Conta Apple Developer ($99/ano) e Google Play ($25) ativas

3. Gerar o build web

Antes de sincronizar com o Capacitor, gere o build de produção do app web:

ionic build --prod

Isso compila o app Angular/React/Vue para a pasta www/ com otimizações de produção ativas. Certifique-se de que o build termina sem erros antes de continuar.

4. Sincronizar com Capacitor

Após o build web, sincronize o conteúdo com os projetos nativos:

npx cap sync

O comando cap sync faz duas coisas: copia o build web para as pastas dos projetos nativos e atualiza os plugins do Capacitor instalados. Sempre rode cap sync após mudanças no código web ou após instalar/atualizar plugins.

5. Publicar na App Store (iOS)

6. Publicar no Google Play (Android)

7. Ionic Appflow — alternativa CI/CD

O Ionic Appflow é o serviço de CI/CD da Ionic que compila e distribui apps na nuvem — similar ao EAS Build do Expo. Com ele, você não precisa de Mac para builds iOS (o Appflow usa Macs na nuvem).

O plano gratuito é limitado. Planos pagos começam em ~$49/mês. Para equipes que precisam de builds frequentes e automação, pode valer o custo. Para publicação avulsa, o fluxo manual pelo Xcode é mais simples.

8. Problemas comuns

• Plugin Capacitor não funciona em produção: verifique se rodou cap sync após instalar o plugin e se o pod install foi executado (iOS).
• App em branco após build: o caminho de base (base href) do app web pode estar incorreto para o contexto do Capacitor. Verifique a configuração do capacitor.config.ts.
• Splash screen presa: o plugin de splash screen pode não estar configurado corretamente. Verifique a documentação do @capacitor/splash-screen.
• Ícone não aparece: os ícones precisam ser gerados em múltiplos tamanhos via npx capacitor-assets generate ou configurados manualmente no Xcode/Android Studio.