Códigos de versão no Android explicados

Dois números, duas funções

Todo app Android traz dois valores de versão. Eles parecem parecidos na página de download, mas o Android trata cada um de um jeito diferente.

• versionName — o rótulo amigável para humanos, como 2.24.18.79 ou 5.0 beta. Ele é exibido para os usuários e pode ser qualquer texto.
• versionCode — um número inteiro, como 242418079. O Android usa esse valor para decidir se um arquivo é mais novo ou mais antigo do que o que já está instalado.

Por que às vezes a atualização não instala

1. 1
   Downgrade bloqueadoO Android não instala um versionCode menor por cima de um maior. Para voltar, desinstale primeiro (fazendo backup dos dados).
2. 2
   Assinatura diferenteUma atualização precisa estar assinada com a mesma chave do app instalado. Se a assinatura não bate, o arquivo veio de outro desenvolvedor — pare e confira a origem.
3. 3
   Versão mínima do AndroidSe o app exige uma versão mais recente do Android do que a do seu celular, o instalador mostra “App not compatible”.
4. 4
   Arquitetura erradaAlgumas builds são feitas só para arm64-v8a ou armeabi-v7a. Celulares mais antigos, de 32 bits, não conseguem executar builds apenas de 64 bits.

Como escolher a build certa

Comece conferindo seu aparelho

Abra Settings → About phone para ver a sua versão do Android. A maioria dos celulares vendidos desde 2019 é 64-bit (arm64-v8a), e uma build universal roda em praticamente tudo.

Depois, compare com a página do app

• Prefira a versão mais recente, a menos que você tenha um motivo para voltar atrás
• Confira o requisito de minimum Android na página do app
• Escolha uma build universal ou arm64-v8a se houver várias opções
• Compare o tamanho do arquivo com versões anteriores — um salto enorme sem explicação é sinal de alerta

Voltando para uma versão mais antiga

Às vezes, uma versão nova quebra um recurso do qual você depende. Para voltar, faça backup dos dados do app, desinstale a versão atual e depois instale o APK antigo da lista Older versions. Desative a atualização automática desse app na Play Store, ou ele pode atualizar de novo durante a noite.