Resumo
Escolha as chaves de assinatura corretas, registre certificados SHA-256 adicionais e resolva divergências sem expor chaves privadas.
Para quem: Responsáveis por releases Android que encontram mensagens de chave qualificada, chave adicional ou divergência ao registrar um pacote existente.
Etapas do lançamento
- Liste o artefato entregue por cada canal de distribuição ativo.
- Extraia a impressão pública SHA-256 e identifique se é chave de assinatura do app, chave de upload, antiga ou específica do canal.
- Selecione uma chave qualificada ou use a análise oficial e adicione toda chave legítima que assina uma versão distribuída.
- Conclua a prova de propriedade e consulte novamente o par exato de pacote e certificado.
Informações-chave
Não troque uma chave de produção porque ela não aparece como qualificada. Confirme o artefato e a função da chave, preserve a continuidade das atualizações e use a solicitação ou análise oficial.
Orientação detalhada
Registre o certificado que assina o app instalado
Comece pelo artefato que o usuário instala. Na Assinatura de apps do Google Play, o Google assina APKs entregues com a chave de assinatura do app; a chave de upload apenas autentica o envio. Builds de site ou outras lojas podem usar certificados próprios.
Extraia o SHA-256 de cada APK distribuído e marque seu canal. Registrar um alias conhecido do keystore não basta quando essa chave não assina o app instalado.
- APK entregue pelo Play: certificado de assinatura do app.
- Envio ao Play: certificado de upload com função diferente.
- Outro canal: inspecione o APK de produção daquele canal.
apksigner verify --print-certs app-release.apkEscolha a chave qualificada ou a análise
Para um pacote existente, o console pode mostrar chaves ligadas ao histórico. Selecione a que corresponde à versão instalada. Se a chave de produção correta não estiver qualificada, descarte primeiro chave de upload ou debug e use o caminho de solicitação para explicar a distribuição.
Para um pacote novo, mantenha conta, nome do pacote e certificado juntos no registro do release. Não crie outra chave apenas para fazer um item aparecer na lista.
- Comparar impressões SHA-256, não aliases.
- Guardar evidências de releases antigos e de cada canal.
- Preservar a chave que mantém a continuidade das atualizações.
Adicione todas as chaves legítimas de distribuição
Um pacote pode ter mais de uma chave legítima quando há canais distintos ou históricos aprovados. Adicione cada certificado público pelo fluxo oficial de chaves adicionais e identifique impressão, canal e responsável.
Se o console pedir prova de propriedade, conclua o desafio com a chave correspondente. A prova pode envolver um APK assinado e adi-registration.properties; nunca exige o upload da chave privada.
- Adicionar apenas chaves de artefatos realmente distribuídos.
- Manter chaves privadas no sistema de assinatura existente.
- Esperar o processamento do console antes de consultar novamente.
Separe erro de registro de erro de upload no Play
A divergência de registro indica um certificado diferente no pacote. A mensagem do Play de App Bundle assinado com chave errada trata da chave de upload ou da Assinatura de apps. O mesmo pacote pode apresentar as duas, mas as correções são diferentes.
Use pacote e certificado público para validar o registro. Use as páginas de certificado e upload do Play Console para diagnosticar um AAB rejeitado. Trocar qualquer chave antes de identificar a camada dificulta a recuperação.
- Consulta de registro: pacote e certificado público.
- Rejeição do AAB: certificado de upload esperado.
- Identidade instalada pelo Play: certificado de assinatura do app.
Informe o nome de produção e, para conferir a assinatura, o SHA-256 do certificado do APK entregue aos usuários. A consulta não substitui a análise da loja.
Verificar status →Perguntas frequentes
Um pacote Android pode ter várias chaves de assinatura?
Sim. Chaves legítimas adicionais podem ser registradas quando representam canais reais ou um histórico aprovado. Anote qual artefato e canal pertencem a cada impressão SHA-256.
Qual chave devo usar com a Assinatura de apps do Google Play?
Para a identidade do app entregue pelo Play, use o certificado da chave de assinatura do app. A chave de upload autentica o envio do bundle e pode ser diferente.
E se minha chave de produção não estiver qualificada?
Confirme se ela assina o artefato instalado e não é chave de upload ou debug. Depois use a solicitação ou análise oficial com as evidências pedidas sobre a distribuição.
Preciso enviar minha chave privada?
Não. O registro usa a impressão do certificado público. A prova pode exigir um APK assinado pela chave correspondente, mas a chave privada permanece no keystore ou serviço de assinatura.
Por que o Play diz que meu App Bundle usa a chave errada?
Essa mensagem normalmente diz respeito ao certificado de upload esperado pelo Play, e não ao certificado registrado na verificação Android. Investigue no Play Console antes de alterar qualquer chave.
Fontes e revisão
Última revisão: