Soddisfa il requisito relativo ai livelli API target di Google Play

Quando carichi un APK, questo deve soddisfare i requisiti relativi al livello API target di Google Play.

A partire dal 31 agosto 2024:

  • Le nuove app e gli aggiornamenti delle app devono avere come target Android 14 (livello API 34) o versioni successive per essere inviati a Google Play, ad eccezione delle app per Wear OS e Android TV, che devono avere come target Android 13 (livello API 33) o versioni successive.
  • Le app esistenti devono avere come target Android 13 (livello API 33) o versioni successive per rimanere disponibili per i nuovi utenti su dispositivi con sistema operativo Android superiore al livello API target della tua app. Le app che hanno come target Android 12 (livello API 31) o versioni precedenti (Android 10 (livello API 29) o versioni precedenti per Wear OS e Android 11 (livello API 30) o versioni precedenti per Android TV) saranno disponibili solo sui dispositivi con sistema operativo Android pari o precedente al livello API target della tua app.

Se hai bisogno di più tempo per aggiornare l'app, potrai richiedere un'estensione fino al 1° novembre 2024. Entro la fine dell'anno, potrai accedere ai moduli di estensione per la tua app in Play Console.

Le eccezioni a questi requisiti includono:

  • App sempre private riservate agli utenti di un'organizzazione specifica e destinate esclusivamente alla distribuzione interna.
  • App che hanno come target Android Automotive OS o sono pacchettizzate da APK che hanno come target il sistema operativo Android Automotive.

Perché scegliere come target SDK più recenti?

Ogni nuova versione di Android introduce modifiche che apportano miglioramenti della sicurezza e delle prestazioni e migliorano l'esperienza utente di Android. Alcune di queste modifiche si applicano solo alle app che dichiarano esplicitamente il supporto tramite l'attributo manifest targetSdkVersion (noto anche come livello API target).

Se configuri la tua app in modo che abbia come target un livello API recente, ti assicuri che gli utenti possano trarre vantaggio da questi miglioramenti, mentre la tua app può continuare a essere eseguita su versioni precedenti di Android. Inoltre, scegliere come target un livello API recente consente alla tua app di sfruttare le ultime funzionalità della piattaforma per soddisfare gli utenti. Inoltre, a partire da Android 10 (livello API 29), gli utenti visualizzano un avviso quando avviano un'app per la prima volta se l'app ha come target Android 5.1 (livello API 22) o versioni precedenti.

Questo documento mette in evidenza i punti importanti da conoscere per aggiornare il livello API target in modo da soddisfare il requisito di Google Play. Consulta le istruzioni nelle sezioni seguenti, a seconda della versione a cui esegui la migrazione.

Esegui la migrazione da Android 12 e versioni successive (livello API 31) a una versione più recente

Per aggiornare l'app in modo che abbia come target una versione più recente di Android, segui l'elenco delle modifiche di comportamento pertinenti:

Esegui la migrazione da Android 11 (livello API 30) ad Android 12 (livello API 31)

Sicurezza e autorizzazioni

Esperienza utente

  • Notifiche personalizzate: le notifiche con visualizzazioni dei contenuti personalizzate non utilizzeranno più l'area di notifica completa; al loro posto, il sistema applicherà un modello standard. Questo modello garantisce che le notifiche personalizzate abbiano la stessa decorazione delle altre notifiche in tutti gli stati. Questo comportamento è quasi identico a quello di Notification.DecoratedCustomViewStyle.
  • Modifiche alla verifica dei link per app Android: quando utilizzi la verifica dei link per app Android, assicurati che i filtri intent includano la categoria BROWSABLE e supportino lo schema HTTPS.

Prestazioni

  • Limitazioni di avvio dei servizi in primo piano: per avere come target Android 12 o versioni successive, la tua app non può avviare servizi in primo piano durante l'esecuzione in background, ad eccezione di alcuni casi speciali. Se un'app tenta di avviare un servizio in primo piano mentre è in esecuzione in background, si verifica un'eccezione (tranne nei pochi casi speciali).

    Potresti usare WorkManager per pianificare e avviare il lavoro accelerato mentre l'app viene eseguita in background. Per completare le azioni urgenti richieste dall'utente, avvia i servizi in primo piano entro un'ora esatta.

  • Restrizioni del trampolino alle notifiche: quando gli utenti toccano le notifiche, alcune app rispondono avviando un componente dell'app che avvia l'attività che l'utente vede e con cui interagisce. Questo componente dell'app è noto come trampolino di notifica.

    Le app non devono avviare attività da servizi o broadcast receiver usati come trampolini per le notifiche. Dopo che un utente tocca una notifica o un pulsante di azione al suo interno, l'app non può chiamare startActivity() all'interno di un servizio o di un'entità di ricezione di trasmissione.

Visualizza l'insieme completo di modifiche che interessano le app che hanno come target Android 12 (livello API 31).

Eseguire la migrazione da una versione precedente ad Android 11 (livello API 30)

Seleziona la versione di Android da cui eseguirai la migrazione:

Eseguire la migrazione ad Android 5 (livello API 21)

Consulta la rispettiva pagina Modifiche al comportamento per ciascuna delle seguenti release per assicurarti che la tua app abbia preso in considerazione le modifiche introdotte in queste release:

Continua seguendo le istruzioni nella sezione successiva.

Eseguire la migrazione ad Android 6 (livello API 23)

Le seguenti considerazioni si applicano alle app destinate ad Android 6.0 e versioni successive della piattaforma:

  • Autorizzazioni di runtime

    • Le autorizzazioni pericolose vengono concesse solo in fase di esecuzione. I flussi dell'interfaccia utente devono fornire elementi che consentano di concedere queste autorizzazioni.

    • Ove possibile, assicurati che la tua app sia pronta a gestire il rifiuto delle richieste di autorizzazione. Ad esempio, se un utente rifiuta una richiesta di accesso al GPS del dispositivo, assicurati che l'app abbia un altro modo per procedere.

Per un elenco esaustivo delle modifiche introdotte in Android 6.0 (livello API 23), consulta la pagina Modifiche al comportamento per la versione della piattaforma in questione.

Continua seguendo le istruzioni riportate nella sezione successiva.

Eseguire la migrazione ad Android 7 (livello API 24)

Le seguenti considerazioni si applicano alle app destinate ad Android 7.0 e versioni successive della piattaforma:

  • Sospensione e Standby delle app

    Progetta in base ai comportamenti descritti in Ottimizzazione per sospensione e standby delle app, che include le modifiche incrementali introdotte in diverse release della piattaforma.

    Quando un dispositivo è in modalità Sospensione e Standby app, il sistema si comporta nel seguente modo:

    • Limita l'accesso alla rete
    • Rimanda sveglie, sincronizzazioni e job
    • Limita le ricerche GPS e Wi-Fi
    • Limita i messaggi Firebase Cloud Messaging a priorità normale.
  • Modifiche alle autorizzazioni

    • Il sistema limita l'accesso alle directory private delle app.
    • L'esposizione di un URI file:// all'esterno dell'app attiva un FileUriExposedException. Se devi condividere file all'esterno della tua app, implementa FileProvider
  • Il sistema vieta il collegamento alle librerie non NDK.

Per un elenco esaustivo delle modifiche introdotte in Android 7.0 (livello API 24), consulta la pagina Modifiche al comportamento per la versione della piattaforma in questione.

Continua seguendo le istruzioni nella sezione successiva.

Eseguire la migrazione ad Android 8 (livello API 26)

Le seguenti considerazioni si applicano alle app destinate ad Android 8.0 e versioni successive della piattaforma:

Per un elenco esaustivo delle modifiche introdotte in Android 8.0 (livello API 26), consulta la pagina Modifiche al comportamento per questa versione della piattaforma.

Eseguire la migrazione da Android 8 (API 26) ad Android 9 (API 28)

Per un elenco esaustivo delle modifiche introdotte in Android 9.0 (livello API 28), consulta le modifiche al comportamento.

Eseguire la migrazione da Android 9 (livello API 28) ad Android 10 (livello API 29)

Eseguire la migrazione da Android 10 (livello API 29) ad Android 11 (livello API 30)

Per un elenco esaustivo delle modifiche introdotte in Android 11 (livello API 30), consulta la pagina Modifiche al comportamento.

Per continuare l'aggiornamento all'API 31, segui le istruzioni riportate nella sezione precedente.

Modernizza le tue app

Quando aggiorni il livello API target per le tue app, ti consigliamo di adottare le funzionalità della piattaforma più recenti per modernizzare le app e soddisfare gli utenti.

  • Prendi in considerazione l'utilizzo di CameraX, in versione beta, per sfruttare al meglio la fotocamera.
  • Utilizza i componenti Jetpack per seguire le best practice, liberarti dalla scrittura di codice boilerplate e semplificare le attività complesse in modo da poterti concentrare sul codice che ti interessa.
  • Utilizza Kotlin per scrivere app migliori più velocemente e con meno codice.
  • Assicurati di rispettare i requisiti e le best practice relativi alla privacy.
  • Aggiungi il supporto del tema scuro alle tue app.
  • Aggiungi il supporto della navigazione con gesti alle tue app.
  • Esegui la migrazione della tua app da Google Cloud Messaging (GCM) alla versione più recente di Firebase Cloud Messaging.
  • Sfrutta la gestione avanzata delle finestre.

Controllare e aggiornare gli SDK e le librerie

Assicurati che le dipendenze dell'SDK di terze parti supportino l'API 31: alcuni fornitori di SDK la pubblicano nel proprio manifest, mentre altri richiederanno ulteriori indagini. Se utilizzi un SDK che non supporta l'API 31, collabora con il fornitore dell'SDK per risolvere il problema.

Inoltre, tieni presente che il targetSdkVersion della tua app o del tuo gioco potrebbe limitare l'accesso alle librerie della piattaforma Android private. Per maggiori dettagli, consulta Collegamenti delle app NDK alle librerie della piattaforma.

Dovresti anche verificare eventuali limitazioni esistenti nella versione della Libreria di supporto Android in uso. Come sempre, devi assicurarti della compatibilità tra la versione principale della libreria di assistenza Android e compileSdkVersion della tua app.

Ti consigliamo di scegliere un valore targetSdkVersion minore o uguale alla versione principale della Libreria di supporto. Ti invitiamo a eseguire l'aggiornamento a una libreria di supporto compatibile recente per usufruire delle funzionalità di compatibilità e delle correzioni di bug più recenti.

Testare l'app

Dopo aver aggiornato il livello API e le funzionalità dell'app, se necessario, devi eseguire il test di alcuni casi d'uso di base. I seguenti suggerimenti non sono esaustivi, ma hanno lo scopo di guidarti nella procedura di test. Ti consigliamo di testare:

  • La tua app viene compilata per l'API 29 senza errori o avvisi.
  • La tua app deve avere una strategia per i casi in cui l'utente rifiuta le richieste di autorizzazione e deve richiedere all'utente le autorizzazioni. Per farlo:

    • Vai alla schermata Informazioni app dell'app e disattiva ogni autorizzazione.
    • Apri l'app e assicurati che non ci siano arresti anomali.
      • Esegui test dei casi d'uso principali e assicurati che vengano richieste nuovamente le autorizzazioni richieste.
  • Gestisce Doze con risultati previsti e senza errori.

    • Utilizzando adb, inserisci il dispositivo di test in modalità Sospensione mentre l'app è in esecuzione.
      • Testa tutti i casi d'uso che attivano i messaggi di Firebase Cloud Messaging.
      • Testa tutti i casi d'uso che utilizzano Avvisi o Job.
      • Elimina qualsiasi dipendenza dai servizi in background.
    • Impostare l'app in modalità App Standby
      • Testa tutti i casi d'uso che attivano i messaggi di Firebase Cloud Messaging.
      • Testa tutti i casi d'uso che utilizzano le sveglie.
  • Gestisce le nuove foto / i nuovi video acquisiti

  • Gestisce la condivisione di file con altre app - Testa qualsiasi caso d'uso che condivida i dati dei file con qualsiasi altra app (anche un'altra app dello stesso sviluppatore)

    • Verifica che i contenuti siano visibili nell'altra app e che non vengano attivati i crash.

Ulteriori informazioni

Attiva le email in Google Play Console per consentirci di inviarti aggiornamenti e annunci importanti di Android e Google Play, inclusa la nostra newsletter mensile per i partner.