Firma dell'app e tester: cosa cambia nelle build di test

«Sul mio telefono si installa, su quello del tester no.» «L'aggiornamento fallisce con un errore di firma.» Molti di questi problemi nascono da una sola cosa: la stessa app può essere firmata con chiavi diverse a seconda di come la build arriva al dispositivo.

I tre tipi di build

Build locale. Compili e installi dal tuo computer, di solito firmata con una chiave di debug o con una tua chiave. Nessun altro può aggiornarla, a meno che non abbia la stessa firma.

Bundle firmato con la chiave di caricamento. Firmi il bundle dell'app con la tua chiave di caricamento e lo invii a Google Play. Secondo la guida di Play Console su Play App Signing, la chiave di caricamento è in tuo possesso ed è usata perché Google possa verificare la tua identità.

Build distribuita da Play. Con Play App Signing, Google detiene la chiave di firma dell'app e firma con essa gli APK che consegna agli utenti. Quindi la build che un tester riceve da Google Play è firmata con una chiave diversa dal file che hai caricato. (Fonte: guida di Play Console, consultata il 2026-10-23.)

Cosa si rompe, per sintomo

• «App non installata» o conflitto di firma durante l'aggiornamento. La copia installata è stata firmata con una chiave e quella nuova con un'altra. Caso tipico: un tester ha installato il tuo APK locale e poi prova la versione di test di Play, o viceversa. Android non aggiorna tra firme diverse.
• Correzione: disinstalla la copia esistente e reinstalla da una sola fonte. Dì ai tester quale fonte usare e avvisali che disinstallando perdono i dati dell'app.
• Un provider di accesso o un'API rifiuta l'app. I servizi che controllano l'impronta del certificato di firma potrebbero conoscere solo la chiave locale o quella di caricamento. Le build distribuite da Play hanno il certificato della chiave di firma di Play App Signing, quindi registra anche quello. Consulta la documentazione attuale di ogni provider per sapere dove trovare e registrare le impronte.
• Comportamento diverso tra la build di debug e quella del tester. Le build di debug differiscono spesso dalle build di rilascio in più di una chiave, ad esempio riduzione del codice e logging. Testa la build di rilascio che distribuisce Play.
• Timori per una chiave persa. Secondo la stessa guida, se perdi la chiave di caricamento o sospetti che sia compromessa, non sei bloccato: ne crei una nuova e richiedi il ripristino in Play Console. Conserva comunque la chiave di caricamento al sicuro.

Una regola pratica per le build di test

1. Scegli un solo percorso di distribuzione per gruppo di tester: o il track di test di Play o l'APK diretto, non entrambi.
2. Prima di un round di test, chiedi ai tester di rimuovere le copie precedenti installate in altro modo.
3. Controlla l'impronta che i tuoi servizi si aspettano e confrontala con la build che i tester ricevono davvero.
4. Testa almeno una volta la build distribuita da Play prima del rilascio, non solo quella locale.

Cosa dire ai tester

Basta una breve nota: «Installa solo dal link di invito. Se hai installato una versione precedente da un'altra fonte, disinstallala prima.»

Torna all'hub di test delle app Android. Correlati: test di lingua e regione e test di fotocamera e media.

AppReviewX offre feedback privati e strutturati e gruppi di test per Google Play (12 tester, 14 giorni consecutivi, per app Android). 1 feedback = 1 credito. Inizia gratis.

Controlla la pagina Google collegata prima di basarti sui dettagli; la gestione delle chiavi può cambiare.