La procedura di registrazione varia a seconda che il nome di pacchetto sia nuovo o già esistente (con installazioni).
Passaggio 1: fornisci i dettagli del nome di pacchetto (comuni ai nomi di pacchetto nuovi ed esistenti)
- Vai alla pagina Verifica dello sviluppatore Android.
- Seleziona Registra il nome di pacchetto nella scheda Nomi pacchetto.
- Inserisci il nome di pacchetto che vuoi registrare.
- Fornisci un nome descrittivo per facilitarne l'identificazione in Play Console.
- Seleziona Avanti per procedere.
Passaggio 2: registrazione della chiave
Il passaggio successivo varia a seconda del che tu stia registrando un nome del pacchetto nuovo o esistente.
A. Registrazione di un nuovo nome di pacchetto
Per un nuovo nome di pacchetto mai visto su Android, devi solo fornire il certificato di chiave pubblica dalla coppia di chiavi di firma dell'app.
- Seleziona Aggiungi chiave.
- Fornisci il certificato di chiave pubblica dalla coppia di chiavi di firma della tua app. Questa chiave di firma è quella che Android utilizza per verificare che gli aggiornamenti dell'app provengano da te. Scopri come trovare il certificato SHA-256 pubblico.
- Inserisci la chiave e seleziona Aggiungi chiave.
B. Registrazione di un nome di pacchetto esistente
Per registrare un nome di pacchetto esistente, devi dimostrare la proprietà di una chiave di firma privata nota.
- Vai a Seleziona chiave.
- A differenza di quando registri un nuovo pacchetto, verrà visualizzato un elenco di fingerprint dei certificati pubblici idonei. Queste chiavi possono essere utilizzate per la registrazione diretta.
- Scansiona l'elenco o cerca direttamente la fingerprint del certificato.
- Seleziona la chiave (se presente nell'elenco) e seleziona Aggiungi chiave.
- Tornerai alla pagina di registrazione e vedrai la conferma che la chiave è stata aggiunta.
Regole di idoneità delle chiavi e richiesta di utilizzo di un nome di pacchetto
L'elenco delle chiavi idonee è determinato dalle regole di idoneità del nome del pacchetto progettate per ridurre al minimo l'utilizzo dello stesso nome del pacchetto (introdotte nell'ambito della verifica degli sviluppatori Android).
Nei casi in cui un nome di pacchetto viene utilizzato da più sviluppatori o ha più chiavi di firma, l'idoneità viene determinata nel seguente modo:
|
Scenario |
Regola per la registrazione diretta |
Regola per gli altri sviluppatori |
|
Titolare della maggioranza delle chiavi |
La chiave che rappresenta oltre il 50% delle installazioni note totali ha la priorità. |
Tutti gli altri sviluppatori devono inviare una richiesta. |
|
50+ installazioni |
Se nessuna chiave ha più del 50% delle installazioni, tutte le chiavi con 50 o più installazioni sono idonee. |
Gli sviluppatori con chiavi con meno di 50 installazioni devono inviare una richiesta. |
|
Meno di 50 installazioni |
Se nessuna chiave soddisfa la soglia di 50 installazioni, tutte le chiavi note possono essere utilizzate in ordine di arrivo. |
Una volta che uno sviluppatore si è registrato, gli altri devono inviare una richiesta. |
Se il certificato di fingerprint SHA-256 NON figura come idoneo, puoi comunque registrarti, ma la procedura richiede una richiesta a Google, che potrebbe essere rifiutata:
- Espandi l'elenco delle altre chiavi nella pagina.
- Conferma di aver compreso le implicazioni della richiesta di utilizzo di un nome del pacchetto in questo modo
- Oltre a completare la prova di proprietà (vedi il passaggio 3), dovrai anche inviare una motivazione per l'utilizzo del nome del pacchetto (ad esempio, la migrazione degli utenti interromperebbe la distribuzione dell'app).
Durante l'accesso in anteprima, potrai registrare solo i nomi di pacchetto per le app per cui possiedi una chiave idonea. La possibilità di registrare pacchetti con altre chiavi verrà implementata con il lancio ufficiale a marzo 2026.
Passaggio 3: verifica della proprietà della chiave privata (solo pacchetti esistenti)
Per completare la verifica di un nome di pacchetto esistente, devi firmare e caricare un APK utilizzando la chiave privata corrispondente alla chiave pubblica che hai fornito.
- Seleziona Carica APK per aprire il percorso dell'utente per la verifica della proprietà.
- Nella schermata successiva verranno visualizzati il nome del pacchetto, il certificato pubblico SHA-256 selezionato e le indicazioni per la firma.
- Copia lo snippet, un identificatore univoco associato al tuo account sviluppatore.
- Prepara l'APK: nel tuo IDE (utilizzando un progetto vuoto con lo stesso nome di pacchetto o la tua app effettiva), vai all'albero delle origini dell'app.
- All'interno della cartella degli asset, crea un file denominato esattamente
adi-registration.properties. - Apri il file e incolla lo snippet.
- Esamina il progetto di esempio su GitHub per verificare la struttura corretta e il posizionamento dello snippet per la prova di proprietà.
- Crea e firma: crea un APK di release e firmalo con la chiave privata corrispondente all'impronta del certificato pubblico. La firma (tramite
jarsignerosigningConfigsdi Gradle) funge da prova di proprietà legittima.Nota: registrazione del nome di pacchetto per le app con chiavi di firma delegateSe il nome di pacchetto che stai registrando appartiene a un'app in cui la chiave di firma privata è stata delegata a una piattaforma di distribuzione di terze parti, come ad esempio il Samsung Galaxy Store, devi seguire invece questi passaggi per dimostrare la proprietà della chiave privata.- Crea e carica l'APK o l'AAB di rilascio sulla piattaforma di distribuzione.
- Scarica l'APK di rilascio firmata finale direttamente da questa piattaforma di distribuzione.
- Carica l'APK firmato che hai scaricato in Play Console al passaggio 8.
- Carica: torna a Play Console, seleziona Carica, individua l'APK di rilascio firmato e caricalo. Android controllerà la firma e registrerà la tua proprietà.
Passaggio 4: monitoraggio della registrazione del nome di pacchetto
Android tenterà formalmente di registrare il nome di pacchetto, collegandolo alla tua identità di sviluppatore Play verificata.
Riceverai una notifica via email al termine dell'operazione.
Puoi monitorare lo stato della registrazione e della chiave nella pagina Pacchetti.
Aggiungi ulteriori chiavi
Dopo aver registrato un nome di pacchetto, puoi aggiungere altre chiavi:
- Seleziona Carica APK per aprire il percorso dell'utente per la verifica della proprietà.
- Nella schermata successiva verranno visualizzati il nome del pacchetto, il certificato pubblico SHA-256 selezionato e le indicazioni per la firma.
- Copia lo snippet, un identificatore univoco associato al tuo account sviluppatore.
- Prepara l'APK: nel tuo IDE (utilizzando un progetto vuoto con lo stesso nome di pacchetto o la tua app effettiva), vai all'albero delle origini dell'app.
- All'interno della cartella degli asset, crea un file denominato esattamente adi-registration.properties.
- Apri il file e incolla lo snippet.
- Esamina il progetto di esempio su GitHub per verificare la struttura corretta e il posizionamento dello snippet per la prova di proprietà.
- Crea e firma: crea un APK di release e firmalo con la chiave privata corrispondente all'impronta del certificato pubblico. La firma (tramite
jarsignerosigningConfigsdi Gradle) funge da prova di proprietà legittima. - Carica: torna a Play Console, seleziona Carica, individua l'APK di rilascio firmato e caricalo. Android controllerà la firma e registrerà la tua proprietà.