Índice
1. Pré-requisitos
- Flutter SDK instalado e atualizado (
flutter upgrade). - Conta Google Play Developer ($25 vitalício).
- Java/JDK instalado para usar o keytool (geração de keystore).
- App cadastrado no Google Play Console com o package name definido.
2. Configurar pubspec.yaml
Antes de gerar o build, confirme que o pubspec.yaml está com a versão correta:
version: 1.0.0+1
O número antes do "+" é o versionName (visível ao usuário) e o número após o "+" é o versionCode (incremental, interno). O versionCode precisa ser maior que o do último upload no Play Console.
3. Criar e configurar a keystore
Gerar a keystore
keytool -genkey -v -keystore ~/meu-app.jks -keyalg RSA -keysize 2048 -validity 10000 -alias meu-alias
Guarde o arquivo .jks em local seguro com backup. Veja nossa página sobre Keystore Android para boas práticas de armazenamento.
Criar o arquivo key.properties
Crie o arquivo android/key.properties com o conteúdo:
storePassword=SENHA_DA_KEYSTORE
keyPassword=SENHA_DO_ALIAS
keyAlias=meu-alias
storeFile=/caminho/para/meu-app.jks
Adicione key.properties ao .gitignore para não versionar senhas.
4. Configurar o build.gradle
No arquivo android/app/build.gradle, adicione antes do bloco android {}:
def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
Dentro do bloco android {}, adicione o bloco signingConfigs e configure o buildTypes.release para usar signingConfigs.release.
A documentação oficial do Flutter em docs.flutter.dev/deployment/android tem o trecho de código completo e atualizado para copiar.
5. Gerar o AAB
Com a keystore configurada, rode no terminal (na raiz do projeto Flutter):
flutter build appbundle --release
O arquivo AAB será gerado em build/app/outputs/bundle/release/app-release.aab. Esse é o arquivo que você vai fazer upload no Play Console.
✓ Use flutter build appbundle (AAB) — não flutter build apk — para publicar no Google Play. O AAB é o formato padrão exigido pelo Google desde 2021 e gera apps menores para os usuários.
6. Upload no Play Console
- Acesse Google Play Console → seu app → Production → Create new release.
- Faça upload do
app-release.aab. - Preencha as Release notes (o que há de novo nessa versão).
- Clique em "Review release" → "Start rollout to Production".
Se é a primeira publicação, o app precisará passar pela revisão completa (3-7 dias). Atualizações costumam ser aprovadas em horas.
7. Problemas comuns
- key.properties não encontrado: verifique o caminho no build.gradle — deve ser relativo à pasta raiz do projeto Android.
- Senha incorreta de keystore: verifique se há espaços ou caracteres especiais nas senhas do key.properties.
- versionCode menor que o upload anterior: incremente o número após "+" no pubspec.yaml.
- App crashes em release: verifique as regras de ProGuard para as dependências que usa. Adicione regras específicas em
android/app/proguard-rules.pro.
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