O processo de registro varia dependendo de se o nome do pacote é novo ou já existe (tem instalações).
Etapa 1: fornecer detalhes do nome do pacote (tanto nomes novos quanto atuais)
- Acesse a página Verificação de desenvolvedores Android.
- Selecione Registrar nome do pacote na guia Nomes de pacote.
- Digite o nome do pacote que você quer registrar.
- Escolha um nome que facilite a identificação no Play Console.
- Selecione Avançar para continuar.
Etapa 2: registrar a chave
A próxima etapa depende de se você está registrando um nome de pacote novo ou atual.
A. Registrar um novo nome de pacote
Para um nome de pacote que nunca foi visto no Android, basta fornecer o certificado de chave pública do par de chaves de assinatura do app.
- Selecione Adicionar chave.
- Forneça o certificado de chave pública do par de chaves de assinatura do app. Essa chave de assinatura é usada pelo Android para verificar se as atualizações do app são suas. Saiba como encontrar seu certificado SHA-256 público.
- Insira a chave e selecione Adicionar chave.
B. Registrar um nome de pacote atual
Para registrar um nome de pacote que já existe, é necessário comprovar a propriedade de uma chave de assinatura privada conhecida.
- Acesse Selecionar chave.
- Ao contrário do novo registro, será exibida uma lista de impressões digitais de certificados públicos qualificados. Essas chaves podem ser usadas para registro direto.
- Analise a lista ou pesquise diretamente a impressão digital do certificado.
- Selecione sua chave, se ela estiver listada, e clique em Adicionar chave.
- Você vai voltar para a página de registro, confirmando que a chave foi adicionada.
Principais regras de qualificação e pedido para usar um nome de pacote
A lista de chaves qualificadas é determinada por regras de qualificação de nome de pacote. Elas foram criadas para minimizar o compartilhamento de nomes e apresentadas como parte da verificação de desenvolvedores Android.
Quando um nome de pacote é usado por vários desenvolvedores ou tem várias chaves de assinatura, a qualificação é determinada da seguinte maneira:
|
Cenário |
Regra para registro direto |
Regra para outros desenvolvedores |
|
Titular da chave majoritária |
A chave que representa mais de 50% do total de instalações conhecidas tem prioridade. |
Todos os outros desenvolvedores precisam enviar um pedido. |
|
Mais de 50 instalações |
Se nenhuma chave tiver mais de 50% das instalações, todas as chaves com 50 ou mais instalações vão se qualificar. |
Os desenvolvedores com chaves que têm menos de 50 instalações precisam enviar um pedido. |
|
Menos de 50 instalações |
Se nenhuma chave atender ao limite de 50 instalações, todas as chaves conhecidas poderão ser usadas por ordem de chegada. |
Depois que um desenvolvedor se registrar, os outros precisarão enviar um pedido. |
Se o certificado de impressão digital SHA-256 NÃO estiver listado como qualificado, você ainda poderá se registrar, mas o processo exige um pedido ao Google, que pode ser rejeitado:
- Abra a lista de outras chaves na página.
- Confirme que você entende as implicações de solicitar o uso de um nome de pacote dessa forma.
- Além de concluir a prova de propriedade (consulte a etapa 3), você também precisará enviar uma justificativa para usar o nome do pacote. Por exemplo, a migração de usuários interromperia a distribuição do app.
Durante o acesso antecipado, só será possível registrar nomes de pacotes para apps em que você tem uma chave qualificada. A capacidade de registrar pacotes com outras chaves será lançada oficialmente em março de 2026.
Etapa 3: verificar a propriedade da chave privada (somente pacotes atuais)
Para concluir a verificação de um nome de pacote atual, assine e faça upload de um APK usando a chave privada correspondente à chave pública fornecida.
- Selecione Enviar APK para abrir a jornada do usuário de verificação de propriedade.
- A próxima tela vai mostrar o nome do pacote, o certificado SHA-256 público selecionado e orientações sobre assinatura.
- Copie seu snippet, um identificador exclusivo vinculado à sua conta de desenvolvedor.
- Prepare o APK: no seu IDE (usando um projeto vazio com o mesmo nome do pacote ou do app real), navegue até a árvore de origem do app.
- Na pasta "assets", crie um arquivo chamado exatamente
adi-registration.properties. - Abra o arquivo e cole o snippet.
- Revise o projeto de exemplo no GitHub (link em inglês) para confirmar a estrutura correta e o posicionamento do snippet para a comprovação de propriedade.
- Crie e assine: crie um APK de lançamento e assine com a chave privada correspondente à impressão digital do certificado público. A assinatura (via
jarsignerousigningConfigsdo Gradle) serve como prova de propriedade legítima.Observação: registro do nome do pacote para apps com chaves de assinatura delegadasSe o nome de pacote que você está registrando pertence a um app em que a chave de assinatura privada foi delegada a uma plataforma de distribuição terceirizada, como a Samsung Galaxy Store, siga estas etapas para comprovar a propriedade da chave privada.- Crie e envie o APK ou AAB de lançamento para a plataforma de distribuição.
- Baixe o APK de lançamento assinado final diretamente nessa plataforma.
- Envie esse APK assinado que você baixou para o Play Console.
- Faça upload: volte ao Play Console, selecione Fazer upload, localize e envie o APK de lançamento assinado. O Android vai verificar a assinatura e registrar sua propriedade.
Etapa 4: acompanhar o registro do nome do pacote
O Android vai tentar registrar formalmente o nome do pacote, vinculando-o à sua identidade de desenvolvedor verificada do Google Play.
Você vai receber uma notificação por e-mail quando o processo for concluído.
Monitore o registro e o status da chave na página "Pacotes".
Adicionar outras chaves
Depois de registrar um nome de pacote, você pode adicionar outras chaves.
- Selecione Enviar APK para abrir a jornada do usuário de verificação de propriedade.
- A próxima tela vai mostrar o nome do pacote, o certificado SHA-256 público selecionado e orientações sobre assinatura.
- Copie seu snippet, um identificador exclusivo vinculado à sua conta de desenvolvedor.
- Prepare o APK: no seu IDE (usando um projeto vazio com o mesmo nome do pacote ou do app real), navegue até a árvore de origem do app.
- Na pasta "assets", crie um arquivo chamado exatamente "adi-registration.properties".
- Abra o arquivo e cole o snippet.
- Revise o projeto de exemplo no GitHub (link em inglês) para confirmar a estrutura correta e o posicionamento do snippet para a comprovação de propriedade.
- Crie e assine: crie um APK de lançamento e assine com a chave privada correspondente à impressão digital do certificado público. A assinatura (via
jarsignerousigningConfigsdo Gradle) serve como prova de propriedade legítima. - Faça upload: volte ao Play Console, selecione Fazer upload, localize e envie o APK de lançamento assinado. O Android vai verificar a assinatura e registrar sua propriedade.