Codici versione

Gestire i codici versione delle app per Android in modo sostenibile

Android richiede che i codici versione delle app aumentino a ogni release per evitare downgrade accidentali e Google Play stabilisce un limite massimo rigoroso per questi codici. L'utilizzo di uno schema di numerazione che aumenta rapidamente può impedirti di pubblicare aggiornamenti in futuro. Per assicurarti che la tua app rimanga aggiornabile per gli anni a venire, è importante capire come funziona il controllo delle versioni dell'app e adottare una strategia scalabile per la generazione dei codici versione.

Informazioni sulle versioni delle app

Le app per Android utilizzano due attributi principali per il controllo delle versioni:

• versionCode: un numero intero a 32 bit che aumenta costantemente con ogni nuova release. Viene utilizzato internamente dal sistema Android e da Google Play per determinare se una versione è più recente di un'altra.
• versionName: una stringa che rappresenta il numero di versione rivolto agli utenti, ad esempio "1.0.0", "1.1 Beta", "2.0". È quello che gli utenti vedono su Google Play e sui loro dispositivi.

Per indicazioni più dettagliate su come scegliere i codici versione, consulta la documentazione di Android for Developers sull'uso di più APK e codici versione.

Se raggiungi il limite massimo per i codici versione

Google Play applica un tetto ai codici versione. Il valore massimo consentito da Google Play per un versionCode è 2.100.000.000. Anche se questo numero può sembrare elevato, un controllo delle versioni non gestito o inefficiente può causare problemi per la tua app, ad esempio:

• Impossibilità di pubblicare aggiornamenti: se il valore versionCode della tua app raggiunge o supera il limite massimo, non potrai più caricare nuovi APK o app bundle su Google Play per l'applicazione in questione. Ciò significa che gli utenti non riceveranno più correzioni di bug, nuove funzionalità o aggiornamenti della compatibilità.

Per evitare di raggiungere il limite massimo per i codici versione:

• Adotta una strategia sostenibile per i versionCode: implementa una strategia di generazione dei versionCode che garantisca un aumento graduale e coerente ed eviti il rapido esaurimento dell'intervallo disponibile.
• Monitora l'utilizzo dei versionCode: monitora regolarmente la progessione dei versionCode della tua app per prevedere il raggiungimento del limite.
• Implementa controlli automatici: integra dei controlli nei processi di build e release per impedire l'utilizzo di valori versionCode eccessivamente elevati o implementare avvisi nel caso in cui ciò si verifichi.

Se raggiungi il limite massimo per i codici versione, Google Play potrebbe essere in grado di fornire assistenza. Contatta il team di assistenza di Play per ricevere aiuto.