Registar nomes de pacotes Android

O processo de registo varia consoante o nome do pacote seja novo ou existente (tenha instalações).

Tenha em atenção que, durante o acesso antecipado, só pode registar nomes de pacotes para apps que distribui fora do Google Play. Em março de 2026, antes do lançamento oficial da validação de programadores Android, vamos tentar registar automaticamente todas as suas apps do Google Play. Neste momento, não tem de registar os nomes de pacotes destas apps.

Para mais informações sobre o processo de registo automático para apps do Google Play, consulte a página 16 do nosso guia com instruções passo a passo.

Passo 1. Indique os detalhes do nome do pacote (comuns aos nomes de pacotes novos e existentes)

1. Navegue para a página Validação de programadores Android.
2. Selecione Registar nome do pacote no separador Nomes de pacotes.
3. Introduza o nome do pacote que quer registar.
4. Indique um nome familiar para facilitar a identificação na Play Console.
5. Selecione Seguinte para continuar.

Passo 2: registo da chave

O passo seguinte depende de estar a registar um nome de pacote novo ou existente.

A. Registar um novo nome de pacote

Para um novo nome de pacote que nunca tenha sido visto no Android, basta facultar o certificado de chave pública do par de chaves de assinatura da sua app.

1. Selecione Adicionar chave.
2. Faculte o certificado de chave pública do par de chaves de assinatura da sua app. (Esta chave de assinatura é o que o Android usa para verificar se as atualizações de apps são suas.) Saiba como localizar o seu certificado SHA-256 público.
3. Introduza a chave e selecione Adicionar chave.

B. Registar um nome de pacote existente

Para registar um nome de pacote existente, tem de comprovar a propriedade de uma chave de assinatura privada conhecida.

1. Aceda a Selecionar chave.
2. Ao contrário do novo registo, é apresentada uma lista de impressões digitais de certificados públicos elegíveis. Estas chaves podem ser usadas para o registo direto.
3. Analise a lista ou pesquise diretamente a impressão digital do certificado.
4. Selecione a chave (se estiver na lista) e selecione Adicionar chave.
5. Regressa à página de registo, confirmando que a chave foi adicionada.

Regras de elegibilidade principais e pedido de utilização de um nome do pacote

A lista de chaves elegíveis é determinada pelas regras de elegibilidade de nomes de pacotes concebidas para minimizar a partilha de nomes de pacotes (introduzidas como parte da validação de programadores Android).

Em cenários em que um nome do pacote é usado por vários programadores ou tem várias chaves de assinatura, a elegibilidade é determinada da seguinte forma:

Cenário	Regra para registo direto	Regra para outros programadores
Titular da chave maioritário	A chave que representa mais de 50% do total de instalações conhecidas tem prioridade.	Todos os outros programadores têm de enviar um pedido.
Mais de 50 instalações	Se nenhuma chave tiver >50% das instalações, todas as chaves com 50 ou mais instalações são elegíveis.	Os programadores com chaves que tenham menos de 50 instalações têm de enviar um pedido.
Menos de 50 instalações	Se nenhuma chave atingir o limite de 50 instalações, todas as chaves conhecidas podem ser usadas por ordem de chegada.	Quando um programador se regista, os outros têm de enviar um pedido.

Se o certificado de impressão digital SHA-256 NÃO estiver listado como elegível, ainda pode registar-se, mas o processo requer um pedido à Google, que pode ser rejeitado:

1. Expanda a lista de outras chaves na página.
2. Confirme que compreende as implicações de pedir para usar um nome do pacote desta forma
3. Além de concluir a prova de propriedade (consulte o passo 3), também tem de enviar uma justificação para usar o nome do pacote (por exemplo, a migração de utilizadores iria interromper a distribuição da app).

Durante o acesso antecipado, só pode registar nomes de pacotes para apps em que detém uma chave elegível. A capacidade de registar pacotes com outras chaves vai ser implementada com o lançamento oficial em março de 2026.

Passo 3: validar a propriedade da chave privada (apenas para pacotes existentes)

Para concluir a validação de um nome de pacote existente, tem de assinar e carregar um APK com a chave privada correspondente à chave pública que facultou.

1. Selecione Carregar APK para abrir o percurso do utilizador de validação da propriedade.
2. O ecrã seguinte mostra o nome do pacote, o certificado público SHA-256 selecionado e orientações para a assinatura.
3. Copie o fragmento, um identificador único associado à sua conta de programador.
4. Prepare o APK: no IDE (usando um projeto vazio com o mesmo nome do pacote ou a sua app real), navegue para a árvore de origem da sua app.
5. Na pasta de assets, crie um ficheiro com o nome exato adi-registration.properties.
6. Abra o ficheiro e cole o fragmento.
   • Reveja o projeto de exemplo no GitHub para confirmar a estrutura correta e o posicionamento do fragmento para a prova de propriedade.
7. Crie e assine: crie um APK de lançamento e assine-o com a chave privada que corresponde à impressão digital do certificado público. A assinatura (através do jarsigner ou das signingConfigs do Gradle) serve como prova de propriedade legítima.
   Nota: registo do nome do pacote para apps com chaves de assinatura delegadas

   Se o nome do pacote que está a registar pertencer a uma app em que a chave de assinatura privada foi delegada numa plataforma de distribuição de terceiros, como a Samsung Galaxy Store, tem de seguir estes passos em alternativa quando comprovar a propriedade da chave privada.

   • Crie e carregue o APK ou o AAB de lançamento para a plataforma de distribuição.
   • Transfira o APK de lançamento assinado final diretamente dessa plataforma de distribuição.
   • Carregue o APK assinado que transferiu para a Play Console no passo 8.
8. Carregamento: regresse à Play Console, selecione Carregar, localize o APK de lançamento assinado e carregue-o. O Android verifica a assinatura e regista a sua propriedade.

Passo 4: acompanhe o registo do nome do pacote

O Android tenta registar formalmente o nome do pacote, associando-o à sua identidade de programador do Google Play validada.

Recebe uma notificação por email quando a conclusão for bem-sucedida.
Pode monitorizar o registo e o estado da chave na página Pacotes.

Adicionar outras chaves

Depois de registar um nome de pacote, pode adicionar outras chaves.

1. Selecione Carregar APK para abrir o percurso do utilizador de validação da propriedade.
2. O ecrã seguinte mostra o nome do pacote, o certificado público SHA-256 selecionado e orientações para a assinatura.
3. Copie o fragmento, um identificador único associado à sua conta de programador.
4. Prepare o APK: no IDE (usando um projeto vazio com o mesmo nome do pacote ou a sua app real), navegue para a árvore de origem da sua app.
5. Na pasta de recursos, crie um ficheiro com o nome exato adi-registration.properties.
6. Abra o ficheiro e cole o fragmento.
   • Reveja o projeto de exemplo no GitHub para confirmar a estrutura correta e o posicionamento do fragmento para a prova de propriedade.
7. Crie e assine: crie um APK de lançamento e assine-o com a chave privada que corresponde à impressão digital do certificado público. A assinatura (através do jarsigner ou das signingConfigs do Gradle) serve como prova de propriedade legítima.
8. Carregamento: regresse à Play Console, selecione Carregar, localize o APK de lançamento assinado e carregue-o. O Android verifica a assinatura e regista a sua propriedade.