Google Play App Signing em 2026: guia passo a passo para enviar chaves, fazer upgrades de chave e redefinições
O Play App Signing divide a assinatura do app em duas tarefas: você guarda uma chave, o Google guarda uma chave. Em 2026, uma terceira chave se juntou a elas — a metade pós-quântica da nova assinatura híbrida — e é por isso que as impressões digitais que você registra no Google Maps, no OAuth ou no Facebook Login já não são um valor único. Aqui está o modelo completo de chaves da própria documentação do Play Console do Google, os caminhos exatos no console e as duas operações que mais importam na prática: a atualização anual da chave de assinatura do app e a redefinição da chave de upload.
O que você resolve hoje: saber qual chave faz o quê, configurar o Play App Signing para um app novo ou existente, registrar as impressões digitais corretas (até três), atualizar uma chave de assinatura do app e redefinir uma chave de upload perdida sem perder o app nem a ficha na loja.
Duas chaves, três com assinatura pronta para quantum
Conforme Usar o Play App Signing, todo app no Play App Signing lida com chaves distintas, cada uma com seu próprio titular, formato e regras de recuperação.
- Chave de upload — sua. Formato: um keystore Java (
.jksou.keystore). Requisito: RSA de 2048 bits ou mais. Você a usa para assinar o bundle do app antes de enviá-lo ao Play Console, e o Google a usa para verificar sua identidade. Se ela for comprometida ou perdida, o Google pode redefini-la para você — é justamente esse o objetivo da separação. - App signing key — Google Play's. Format: a public certificate (
.deror.pem). Google-generated keys are RSA 4096-bit; a custom key you supply must be RSA 2048-bit or higher. Google uses this key to sign the final APKs delivered to users' devices. Manage it yourself, outside Play App Signing, and lose it, and it cannot be reset. - Chaves preparadas para quantum — as do Google Play, adicionadas para o Android 17. A assinatura híbrida combina uma chave clássica RSA de 4096 bits com uma chave pós-quântica ML-DSA-65. O Google gera uma nova chave clássica para a assinatura híbrida diferente da chave clássica que usa para dispositivos anteriores ao Android 17, então o app acaba usando três chaves distintas. O Android 17 e versões superiores verificam o app com o esquema de assinatura APK v3.2, que carrega exatamente dois signatários em um bloco híbrido; versões mais antigas do Android continuam verificando o app com os blocos de assinatura clássicos.
Para segurança máxima, sua chave de upload e sua chave de assinatura do app devem ser chaves diferentes. E quando o Google assina seus APKs com a chave de assinatura do app, ele usa o apksigner para adicionar dois carimbos ao manifesto, com.android.stamp.source e com.android.stamp.type, para que os APKs permaneçam rastreáveis até o signatário original.
Novo app: a assinatura quantum-ready agora é o padrão
- Crie o app. Ele é inscrito automaticamente na assinatura híbrida quantum-ready, com chaves geradas pelo Google. O Google também gera uma chave clássica separada para os blocos de assinatura reconhecidos no Android 16 e anteriores.
- Crie uma chave de upload — gere um keystore no Android Studio ou use o utilitário Java
keytoolpela linha de comando. - Envie o bundle do app. A adesão acontece no envio; não há etapa separada de opt-in.
- Opcional: altere a chave de assinatura do app se preferir gerenciá-la você mesmo. Vá para Protegido com o Play → Distribuição no Play Store → Acessar a assinatura do app no Play e clique em Alterar a chave de assinatura do app. Isso só é possível antes de haver uma versão lançada na faixa de teste aberto ou na faixa de produção, e você pode usar a chave de assinatura de outro app na mesma conta de desenvolvedor ou fornecer uma cópia da sua própria chave.
App existente: inscreva-se pela ferramenta PEPK
Se você ainda assina e envia seus próprios APKs, pode migrar para o Play App Signing para obter app bundles e os aprimoramentos do Play que vêm com eles.
- No Play Console, acesse Protegido pelo Play → Distribuição na Play Store → Ir para a assinatura do app no Play e aceite os termos de serviço, caso ainda não tenha feito isso.
- Transfira uma cópia da sua chave original. Baixe a ferramenta PEPK e siga as instruções unificadas passo a passo para criptografar e enviar sua chave de assinatura do app existente a partir de qualquer repositório.
- Crie uma nova chave de upload (recomendado). Gere uma nova chave no Android Studio e registre o certificado dela no Play Console.
Registre até três fingerprints com seus provedores de API
Maps, OAuth e Facebook Login autenticam seu app pela impressão digital da chave de assinatura do app. Como a Google assina o APK final, você precisa registrar nesses provedores a impressão digital da chave de assinatura mantida pela Google — registrar apenas sua chave de upload local é a falha clássica pós-migração.
- Acesse Protegido com o Play → Distribuição na Play Store → Ir para assinatura do app no Play.
- Role até a seção Chave de assinatura do app e copie as impressões digitais SHA-1 ou SHA-256.
- Se o seu app usa assinatura híbrida quantum-ready, copie as impressões digitais das três chaves e registre todas elas: a nova chave clássica e a chave PQC usada em dispositivos mais recentes, além da chave clássica usada em dispositivos mais antigos.
- Cole-os no console de cada provedor (por exemplo, o Google Cloud Console). Se você usa Android App Links, atualize o
assetlinks.jsoncom as mesmas impressões digitais.
Atualize a chave de assinatura do app — uma vez por ano, quando precisar
Se a chave de assinatura do app for comprometida, ou se você quiser uma chave criptograficamente mais forte, pode solicitar uma atualização anual de chave. A atualização se aplica a todas as instalações no Android 17 (nível de API 37) e superior, e a aplicação varia conforme a versão da plataforma:
- Android 17 (nível de API 37) e superior — a plataforma aplica rigorosamente a chave híbrida quântica atualizada (esquema de assinatura de APK v3.2).
- Android 13 a 16 (níveis de API 33–36) — a plataforma aplica rigorosamente sua chave clássica mais recente (esquema de assinatura de APK v3.1).
- Android 7 a 12 (níveis de API 24–32) — a plataforma não exige a chave atualizada e ainda reconhece a chave clássica mais recente; o Play Protect adiciona a validação de que as atualizações são assinadas com a sua chave clássica mais recente, a menos que o usuário tenha desativado isso.
Ressalva sobre dados compartilhados: como a chave atualizada não é aplicada em API 32 e anteriores, se você usa a mesma chave em vários apps para compartilhar dados, essas versões mais antigas do Android só reconhecerão a chave legada para recursos como compartilhamento de permissão personalizada.
Como fazer upgrade:
- Acesse Protegido com o Play → Distribuição na Play Store → Ir para assinatura do app no Play.
- Na seção App signing key, clique em Upgrade key.
- Escolha seu caminho: deixe o Google Play gerar uma nova chave de assinatura do app (recomendado), use a mesma chave de assinatura de outro app nesta conta de desenvolvedor ou forneça uma cópia da sua chave de assinatura do app.
- Clique em Salvar.
- Registre as novas impressões digitais nos seus provedores de API — com assinatura preparada para quantum, isso significa duas novas chaves, a nova chave clássica e a nova chave PQC.
Redefinir uma chave de upload perdida
Uma chave de upload perdida ou suspeita de comprometimento não bloqueia o acesso ao seu app.
- Crie uma nova chave de upload no Android Studio.
- Exporte o certificado para o formato PEM:
keytool -export -rfc -keystore upload-keystore.jks -alias upload -file upload_certificate.pem
- No Play Console, vá em Protegido com o Play → Proteção do Play Store → Gerenciar assinatura do app no Play.
- Na seção Upload key certificate, clique em Request upload key reset, informe o motivo da redefinição, envie seu arquivo
upload_certificate.peme clique em Request.
O que isso significa quando uma conta ou um app muda de mãos
A chave de assinatura do app é mantida pela Google e acompanha o app, então o trabalho de entrega se concentra no keystore de upload e nos serviços que confiam nas suas impressões digitais.
- Obtenha o keystore de upload (
.jks) junto com seu alias e senha, ou planeje uma redefinição da chave de upload no lado que recebe. - Verifique novamente toda integração dependente de fingerprint após qualquer atualização ou redefinição: chaves da API do Maps restritas por SHA-1, Facebook Login, clientes OAuth e
assetlinks.jsonpara App Links. Essas falhas são silenciosas, não ruidosas. - Um checklist de entrega que ainda pede um único SHA-1 está desatualizado: com assinatura preparada para quantum, o provedor vê três impressões digitais.
Dois tutoriais relacionados neste blog: a Google Play checklist de transferência de conta e app e o tutorial de controle de acesso do Play Console.
Distribuir fora do Google Play e testar o que os usuários realmente recebem
- A mesma chave em todos os lugares: você pode deixar o Google gerar a chave de assinatura do app e depois baixar um APK universal assinado do Play Console ou da Play Developer API para distribuir em outras lojas — vá em Testar e lançar → Versões e bundles mais recentes, selecione seu bundle do app e abra a aba Downloads. Como alternativa, gere você mesmo a chave de assinatura do app e transfira uma cópia dela para o Google ao configurar o Play App Signing.
- Teste o artefato real: use o Internal App Sharing para testar exatamente o que o Play vai entregar, ou baixe APKs específicos do dispositivo no app bundle explorer e instale-os localmente com
adb install-multiple *.apk. - O APK Signature Scheme v4 é aplicado automaticamente a apps elegíveis para viabilizar a distribuição otimizada em dispositivos Android 11+. Nenhuma ação necessária — exceto que apps que usam assinatura híbrida preparada para quantum ficam de fora, porque o v4 ainda não é compatível com ela.
- Proteja o acesso ao console: exija a verificação em duas etapas para todos os usuários da conta. Perder o keystore é recuperável; perder a conta, não.
Checklist de pré-verificação
- Chave de upload armazenada em um keystore com backup fora da máquina de compilação, alias e senha registrados no seu gerenciador de senhas.
- A chave de upload e a chave de assinatura do app são chaves diferentes.
- App inscrito no Play App Signing (novos apps são inscritos automaticamente no upload do bundle).
- Todas as impressões digitais da chave de assinatura do app copiadas do Play Console para o console de cada provedor de API — as três chaves quando a assinatura híbrida está em uso.
assetlinks.jsonatualizado com as mesmas impressões digitais, se você usa App Links.- Faça a atualização da chave antes de a versão entrar em teste aberto ou produção, se quiser sua própria chave de assinatura do app.
- Após atualização ou redefinição: impressões digitais registradas novamente e integrações testadas de novo em um dispositivo real.
- Verificação em duas etapas obrigatória para todos os usuários do Play Console.
A versão em uma linha
Você assina com a chave de upload, o Google assina com a chave de assinatura do app, e o Android 17 adiciona chaves pós-quânticas à equação — então mantenha o keystore de upload com backup, registre cada fingerprint da chave de assinatura do app nos seus provedores de API, use o caminho de atualização anual quando precisar de uma chave mais forte e redefina a chave de upload no Play Console se ela for perdida.
Fontes
Gerencia contas de desenvolvedor em escala? Cuidamos do lado operacional.
Recebemos sua mensagem e responderemos em até 24 horas.
← Voltar para editar