Neste guia
"Instala no meu celular, mas não no do testador." "A atualização falha com erro de assinatura." Muitos desses problemas têm a mesma origem: o mesmo app pode ser assinado com chaves diferentes, dependendo de como a build chega ao aparelho.
Os três tipos de build
Build local. Você compila e instala a partir do seu computador, geralmente assinada com uma chave de depuração ou com a sua própria chave. Ninguém mais consegue atualizá-la, a menos que tenha a mesma assinatura.
Pacote assinado com a chave de upload. Você assina o App Bundle com a sua chave de upload e envia ao Google Play. Segundo a Central de Ajuda do Play Console sobre o Play App Signing, a chave de upload fica com você e serve para o Google verificar sua identidade.
Build entregue pelo Play. Com o Play App Signing, o Google guarda a chave de assinatura do app e assina com ela os APKs que entrega aos usuários. Ou seja, a build que um testador recebe pelo Google Play é assinada com uma chave diferente do arquivo que você enviou. (Fonte: Central de Ajuda do Play Console, acessada em 2026-10-23.)
O que isso quebra, por sintoma
- "App não instalado" ou conflito de assinatura ao atualizar. A cópia instalada foi assinada com uma chave e a nova, com outra. Um caso típico: o testador instalou seu APK local e depois tenta a versão de teste do Play, ou o inverso. O Android não atualiza entre assinaturas diferentes.
- Correção: desinstale a cópia existente e instale de novo a partir de uma única fonte. Diga aos testadores qual fonte usar e avise que os dados do app são perdidos na desinstalação.
- Um provedor de login ou uma API recusa o app. Serviços que verificam a impressão digital do certificado de assinatura do app podem conhecer só a chave local ou a de upload. Builds entregues pelo Play carregam o certificado da chave de assinatura do Play App Signing, então registre também esse. Confira na documentação atual de cada provedor onde encontrar e registrar as impressões digitais.
- Comportamento diferente entre a build de depuração e a do testador. Builds de depuração costumam diferir das de release em mais do que a chave, como redução de código e logs. Teste a build de release que o Play entrega.
- Preocupação com a chave perdida. Segundo a mesma página de ajuda, se você perder ou suspeitar que sua chave de upload foi comprometida, não fica sem saída: cria uma nova e solicita a redefinição no Play Console. Guarde a chave de upload com segurança de qualquer forma.
Uma regra prática para builds de teste
- Escolha um caminho de distribuição por grupo de testadores: ou a faixa de teste do Play, ou o APK direto, nunca os dois.
- Antes de uma rodada de teste, peça aos testadores que removam cópias antigas instaladas por outro caminho.
- Confira a impressão digital que seus serviços esperam e compare com a build que os testadores de fato recebem.
- Teste a build entregue pelo Play pelo menos uma vez antes do lançamento, não só a sua build local.
O que dizer aos testadores
Um aviso curto basta: "Instale só pelo link de convite. Se você instalou uma versão anterior de outro lugar, desinstale antes."
De volta ao hub de testes de apps Android. Relacionados: teste de idioma e região e teste de câmera e mídia.
A AppReviewX oferece feedback privado e estruturado e grupos de teste para o Google Play (12 testadores, 14 dias seguidos, para apps Android). 1 feedback = 1 crédito. Comece grátis.
Confira a página do Google indicada antes de confiar nos detalhes; o tratamento das chaves pode mudar.