KappS Base de conhecimento · Blog

Google Play App Signing em 2026: chaves de upload, redefinições de chave perdida e upgrades de chave

Blog Guia

Todo app no Google Play é assinado duas vezes: uma por você, antes do upload, e outra pelo Google, antes de o arquivo chegar ao dispositivo do usuário. A chave por trás dessa segunda assinatura — a chave de assinatura do app — é a única peça de um app que não pode ser substituída reenviando um bundle, e desde 2026 grande parte dela vive na infraestrutura de chaves do próprio Google. Este guia cobre o que o Play App Signing faz, como os três tipos de chave diferem, como apps novos e existentes se inscrevem, quais fingerprints seus provedores de API realmente precisam, o que fazer quando uma chave de upload é perdida e como as atualizações da chave de assinatura do app são aplicadas entre as versões do Android.


Por que a chave de assinatura importa mais do que a conta

Contas de desenvolvedor podem ser renomeadas, reverificadas, transferidas entre proprietários e migradas para organizações. Chaves de assinatura não. O Android decide se uma atualização é legítima verificando se o novo APK está assinado com a mesma chave do instalado — se essa cadeia se rompe, a única forma de lançar uma "nova versão" é publicar um app diferente e pedir que os usuários o instalem de novo, perdendo instalações, avaliações e histórico.

Esse único fato é o motivo pelo qual o Play App Signing existe. Desde agosto de 2021, espera-se que novos apps no Google Play o utilizem, e hoje ele é o caminho padrão: o Google guarda a chave que assina os APKs de distribuição, então um notebook perdido, um keystore roubado ou um desenvolvedor que sai da empresa não podem mais encerrar a vida de um app. O que você mantém — e o que a maioria das pessoas ainda chama de "keystore" — é a chave de upload, e essa pode ser redefinida.


Três tipos de chave, três funções bem diferentes

A própria documentação do Play separa as chaves por quem as detém e o que elas assinam. Acertar esse mapeamento é o que evita tanto bugs de autenticação (impressão digital errada registrada em uma API) quanto pânico (achar que um keystore perdido é fatal).

  • Chave de upload — mantida por você. Armazenada em um keystore Java (.jks ou .keystore) e precisa ser uma chave RSA de 2048 bits ou mais. Você a usa para assinar o bundle do app antes do upload; Google a usa para verificar que o upload veio de você. Se ela for perdida ou comprometida, Google pode redefini-la.
  • Chave de assinatura do app — mantida pelo Google Play. Associada a um certificado público (.der ou .pem). Chaves geradas pelo Google são RSA de 4096 bits; chaves fornecidas por você mesmo devem ser RSA de 2048 bits ou superior. Esta é a chave que assina os APKs otimizados entregues aos usuários. Você pode deixar o Google gerá-la ou fornecer a sua própria.
  • Chaves híbridas preparadas para o pós-quântico — mantidas por Google Play. Uma assinatura híbrida que combina uma chave clássica RSA de 4096 bits com uma chave pós-quântica ML-DSA-65. O Android 17 e superior verifica apps com o esquema de assinatura APK v3.2; dispositivos mais antigos continuam verificando pelo bloco de assinatura clássico. Como o Google gera uma chave clássica separada para o caminho anterior ao Android 17, um app pode acabar usando três chaves distintas ao mesmo tempo.

Nota da própria Google sobre o design: para segurança máxima, sua chave de upload e sua chave de assinatura do app devem ser chaves diferentes.

Quando o Google assina seus APKs, ele também marca o manifesto com com.android.stamp.source e com.android.stamp.type, para que um APK entregue continue rastreável até o assinante original. Alterar qualquer coisa nesta página exige permissão de administrador na conta — por isso quem detém o admin controla efetivamente o futuro do app, não apenas as configurações dele.


O que a inscrição libera

O Play App Signing não é apenas um serviço de custódia de chaves. Deixar o Google assinar os APKs otimizados gerados a partir dos seus bundles é o que viabiliza a proteção automática e a tradução automática de strings (com tecnologia dos modelos Gemini) e, para jogos, desbloqueia serviços como Play Games Sidekick, Play-as-you-download e testes gratuitos para títulos pagos. Um app que gerencia suas próprias chaves de assinatura fora do Play App Signing simplesmente não tem acesso a isso.


Cadastrando um novo app

  1. Crie o app. Um app recém-criado é automaticamente inscrito na assinatura híbrida quantum-ready com chaves geradas pelo Google; o Google também gera uma chave clássica separada para blocos de assinatura reconhecidos no Android 16 e anteriores.
  2. Crie uma chave de upload. Gere um keystore para assinar seu bundle de lançamento — no Android Studio ou com o utilitário Java keytool pela linha de comando. Guarde esse arquivo e suas senhas em um lugar onde você ainda os tenha daqui a dois anos.
  3. Envie o bundle do app. Preparar uma versão e enviar o .aab é o que conclui a inscrição automática.
  4. Opcionalmente, altere a chave de assinatura do app. Desenvolvedores avançados que querem gerenciar a própria chave podem fazer isso antes de qualquer versão ter sido lançada nas faixas de teste aberto ou de produção: acesse Protegido com o Play > Distribuição no Play Store > Ir para a assinatura do app no Play e clique em Alterar a chave de assinatura do app. Você pode reutilizar a mesma chave de outro app na conta de desenvolvedor ou fornecer uma cópia da sua própria chave de assinatura do app.

Migrar um app existente

Se você ainda gerencia suas próprias chaves e envia APKs, pode migrar para o Play App Signing para ter bundles do app e o restante dos recursos do Play:

  1. No Play Console, acesse Protegido com o Play > Distribuição na Play Store > Acessar a assinatura do app no Play.
  2. Aceite os termos de serviço, caso ainda não tenha feito isso.
  3. Transfira uma cópia da sua chave de assinatura original. Baixe a ferramenta PEPK e siga as instruções passo a passo da Google para criptografar e enviar sua chave existente, de qualquer repositório onde ela esteja. É isso que preserva o caminho de atualização para os usuários que já instalaram o app.
  4. Crie uma nova chave de upload (recomendado). Gere uma chave nova no Android Studio e registre o certificado dela no console, para que a chave que você usa nos uploads do dia a dia não seja mais a chave que assina para os usuários.

Registre as impressões digitais corretas nos seus provedores de API

Esta é a etapa que quebra apps após a inscrição. Serviços como Google Maps, OAuth ou Facebook Login autenticam seu app pela impressão digital da chave de assinatura do app. Como o Google agora assina o APK final, a impressão digital que chega aos usuários é a mantida pelo Google — então você precisa registrar a Googleimpressão digital da chave de assinatura do app mantida pelo em cada provedor, não apenas a impressão digital da chave de upload local.

  • Abra Protegido com o Play > Distribuição no Play Store > Acessar a assinatura do app no Play e role até a seção Chave de assinatura do app.
  • Copie as impressões digitais SHA-1 ou SHA-256 exigidas pelo provedor e cole-as no console desse provedor (por exemplo, o Google Cloud Console para Maps e OAuth).
  • Se o seu app usa assinatura híbrida quantum-ready, copie e registre as impressões digitais das três chaves: a nova chave clássica e a chave pós-quântica usadas em dispositivos mais recentes, além da chave clássica usada em dispositivos mais antigos.
  • Se você usa Android App Links, atualize o assetlinks.json com as mesmas impressões digitais.

Quando a chave de upload é perdida ou comprometida

Perder uma chave de upload não bloqueia o acesso ao seu app. O caminho de recuperação é documentado e rotineiro:

  1. Crie uma nova chave de upload no Android Studio.
  2. Exporte o certificado dele para o formato PEM:
keytool -export -rfc -keystore upload-keystore.jks -alias upload -file upload_certificate.pem
  1. No Play Console, acesse Protegido com o Play > Proteção da Play Store > Gerenciar a assinatura do app no Play.
  2. Na seção Certificado da chave de upload, clique em Solicitar redefinição da chave de upload.
  3. Informe o motivo da redefinição, envie o arquivo upload_certificate.pem e clique em Solicitar.

Até que a redefinição seja processada, você não pode enviar novas versões, então planeje a recuperação antes de um prazo, não depois. Note a assimetria: a chave de upload é redefinível, a chave de assinatura do app não é algo que você simplesmente pede ao Google para substituir sob demanda.


Atualização da chave de assinatura do app

Se uma chave de assinatura do app for comprometida, ou se você precisar de uma criptograficamente mais forte, o Play oferece uma atualização anual de chave que se aplica a instalações no Android 17 (nível de API 37) e superiores. A aplicação varia conforme a versão da plataforma:

  • Android 17 (API 37) e superior: a plataforma aplica rigorosamente a chave híbrida quântica atualizada, verificada pelo esquema de assinatura APK v3.2.
  • Android 13 (API 33) para Android 16 (API 36): a plataforma aplica rigorosamente sua chave clássica mais recente, conforme o esquema de assinatura de APK v3.1.
  • Android 7 (API 24) a Android 12 (API 32): a própria plataforma não exige a chave atualizada e ainda reconhece a chave clássica mais recente. O Google Play Protect adiciona validação ao verificar se as atualizações são assinadas com sua chave clássica mais recente, a menos que o usuário tenha desativado isso.

Uma consequência é fácil de passar despercebida: como a plataforma não aplica a chave atualizada no Android 12 e anteriores, os apps que compartilham a mesma chave de assinatura entre vários apps para compartilhar dados, nessas versões mais antigas, só reconhecerão a chave legada para recursos como o compartilhamento de permissões personalizadas.

Para fazer o upgrade: abra Protegido com o Play > Distribuição no Play Store > Ir para a assinatura do app no Play, clique em Fazer upgrade da chave na seção Chave de assinatura do app, escolha um caminho — deixar o Google Play gerar uma nova chave (recomendado), reutilizar a chave de assinatura do app de outro app da conta ou fornecer uma cópia da sua própria — e clique em Salvar. Depois, registre as novas impressões digitais nos seus provedores de API. Com a assinatura híbrida preparada para quantum, isso significa duas novas chaves: a nova chave clássica e a nova chave pós-quântica.


Publicar fora do Google Play

Se você distribui o mesmo app por outras Androidlojas e quer uma única identidade de assinatura em todos os lugares, você tem duas opções:

  • Deixe o Google gerar a chave de assinatura do app e depois baixe um APK universal assinado no Play Console (Testar e lançar > Versões e bundles mais recentes, selecione o bundle, abra a aba Downloads) ou pela Play Developer API, e distribua esse arquivo em outro lugar.
  • Gere a chave de assinatura do app você mesmo e transfira uma cópia dela para o Google ao configurar o Play App Signing, para que a mesma chave seja usada em todas as lojas.

O Play App Signing também aplica automaticamente o esquema de assinatura de APK v4 para apps elegíveis, para dar suporte à distribuição otimizada no Android 11 e superior — nenhuma ação necessária. A exceção são os apps que usam assinatura híbrida quantum-ready, ainda incompatível com a assinatura v4.


As armadilhas que custam instalações reais a apps reais

  • Tratar o keystore de upload como descartável. O Google pode redefinir uma chave de upload, mas você ainda não poderá enviar nada até que a redefinição seja processada. Faça backup do arquivo keystore e das senhas dele fora da máquina de build.
  • Registrando apenas sua impressão digital local. Após o cadastro, o APK entregue carrega a impressão digital da chave de assinatura do app da Google. Mapas, OAuth e provedores de login que conhecem apenas sua impressão digital antiga vão falhar.
  • Esquecer o assetlinks.json. A verificação de Android App Links depende das mesmas impressões digitais.
  • Alterar a chave de assinatura após o lançamento. É possível alterar a chave de assinatura padrão do app antes que qualquer coisa seja liberada para teste aberto ou produção — não depois. Planeje as decisões de chave na criação do app, não na primeira atualização.
  • Ignorar o caminho da Android antiga na assinatura híbrida. Apps que usam assinatura preparada para quantum têm três chaves, e os provedores precisam de todas as impressões digitais relevantes, não só da mais recente.
  • Presumir que as atualizações se comportam da mesma forma em todas as versões do Android. A aplicação de chaves atualizadas termina no Android 12, onde o Play Protect — e não a plataforma — faz a verificação.
  • Auto-hospedar a chave no seu próprio projeto Cloud. O Google permite o cadastro por meio de um projeto Cloud Google auto-hospedado para requisitos muito específicos, mas documenta isso como não padrão e não recomendado: você assume total responsabilidade pelas operações de assinatura, perde a recuperação de desastres e pode perder otimizações avançadas, certos aprimoramentos do Play e recursos como assinatura híbrida preparada para quantum. O Google não consegue regenerar nem corrigir uma versão existente nessa configuração; a solução é uma nova versão.
  • Controle de acesso fraco. Tudo na página de assinatura do app é de nível administrativo. Ative a verificação em duas etapas para todos os usuários da conta.

O modelo em uma linha: sua chave de upload prova quem você é e sempre pode ser redefinida; a chave de assinatura do app prova a identidade do seu app para cada dispositivo instalado e é o ativo que você nunca pode perder nem vazar. Inscreva-se no Play App Signing, registre as impressões digitais mantidas pelo Play em todos os lugares em que seu app se autentica e trate o keystore no seu pipeline de build como infraestrutura de produção — com backup, controle de acesso e substituição apenas deliberada.


Gerencia contas de desenvolvedor em escala? Cuidamos do lado operacional.

Clique para escolher um arquivo · clique com o botão direito → Colar, ou pressione Ctrl/⌘+V para colar uma captura de tela

Você também pode arrastar um arquivo para esta caixa.

Respondemos ao e-mail que você fornecer. Seus dados ficam com KappS.

✔ Enviado

Recebemos sua mensagem e responderemos em até 24 horas.


← Voltar para editar