Como Publicar App Capacitor (Ionic) na App Store e Google Play

Como o Capacitor funciona

O Capacitor é o runtime nativo desenvolvido pela Ionic que empacota seu app web (Angular, React, Vue, HTML puro) dentro de um WebView nativo. O resultado é um projeto iOS nativo (Xcode) e um projeto Android nativo (Android Studio) — que são essencialmente wrappers do seu conteúdo web com acesso a APIs nativas.

Para publicar, você usa exatamente as mesmas ferramentas de um app nativo: Xcode para iOS e Android Studio para Android.

Pré-requisitos

Gerar o build web e sincronizar

Antes de qualquer coisa, gere o build de produção do seu app web e sincronize com os projetos nativos:

# Build do web app (ex: Angular)
npm run build

# Sincronizar com projetos nativos
npx cap sync

O cap sync copia os arquivos da pasta www/ (ou dist/) para os projetos nativos iOS e Android. Sempre execute isso antes de gerar o build final.

Publicar na App Store (iOS)

1. Abrir projeto no Xcode: npx cap open ios
2. Configurar signing: Em Target → Signing & Capabilities, selecione seu team e ative Automatically manage signing
3. Verificar Bundle ID: Deve corresponder ao cadastrado no App Store Connect
4. Incrementar versão: Atualize Version e Build em Target → General
5. Gerar Archive: Product → Archive (com destino "Any iOS Device")
6. Distribuir: No Organizer, clique em Distribute App → App Store Connect

Publicar na Google Play (Android)

1. Abrir projeto no Android Studio: npx cap open android
2. Configurar versionCode e versionName no android/app/build.gradle
3. Gerar o bundle de release: Build → Generate Signed Bundle/APK → Android App Bundle (.aab)
4. Assinar com sua keystore (crie uma se não tiver — nunca a perca)
5. Upload no Google Play Console: Crie ou edite uma versão em Produção (ou teste interno) e faça upload do .aab

Dicas e erros comuns

Esquecer de rodar cap sync antes do build

O erro mais frequente. Sempre execute npx cap sync após qualquer alteração no código web.

Ícones e splash screen

Use o pacote @capacitor/assets para gerar automaticamente todos os tamanhos de ícone e splash screen exigidos pelas lojas.

npm install @capacitor/assets --save-dev
npx capacitor-assets generate

Permissões no iOS

Qualquer permissão do sistema (câmera, localização, etc.) deve ter uma string de descrição em inglês no Info.plist. Rejeições por falta dessa descrição são comuns.