Eseguire la migrazione delle app ad Android 15

Questo documento offre una panoramica generale delle fasi tipiche di sviluppo e test che possono aiutarti a creare un piano di preparazione ben allineato alla sequenza temporale di rilascio della piattaforma e a garantire un'esperienza ottimale per gli utenti su Android 15.

Con ogni release di Android, introduciamo nuove funzionalità e modifiche al comportamento volte a rendere Android più utile, sicuro e performante. In molti casi, la tua app funzionerà esattamente come previsto, mentre in altri casi potrebbe essere necessario aggiornarla per adattarla alle modifiche della piattaforma.

Gli utenti possono iniziare a ricevere la nuova piattaforma non appena il codice sorgente viene rilasciato in AOSP (Android Open Source Project), quindi è importante che le tue app siano pronte, funzionino come previsto per gli utenti e, idealmente, sfruttino le nuove funzionalità e API per ottenere il massimo dalla nuova piattaforma.

Una migrazione tipica ha due fasi, che possono essere eseguite contemporaneamente:

• Garantire la compatibilità dell'app (entro la release finale di Android 15)
• Avere come target le nuove funzionalità e API della piattaforma (il prima possibile dopo la release finale)

Garantire la compatibilità con Android 15

È importante testare la funzionalità dell'app esistente su Android 15 per garantire un'esperienza ottimale per gli utenti che eseguono l'aggiornamento all'ultima versione di Android. Alcune modifiche della piattaforma possono influire sul comportamento dell'app, quindi è importante eseguire test in anticipo e in modo approfondito e apportare le modifiche necessarie all'app.

In genere, puoi modificare l'app e pubblicare un aggiornamento senza dover cambiare targetSdkVersion dell'app. Allo stesso modo, non dovresti aver bisogno di utilizzare nuove API o modificare compileSdkVersion dell'app, anche se questo può dipendere dal modo in cui l'app è stata creata e dalla funzionalità della piattaforma che utilizza.

Prima di iniziare i test, assicurati di acquisire familiarità con le modifiche al comportamento per tutte le app. Queste modifiche potrebbero interessare la tua app, anche se non modifichi targetSdkVersion.

Esegui test di compatibilità

Nella maggior parte dei casi, il test di compatibilità con Android 15 è simile al normale test delle app. Questo è un buon momento per esaminare le norme sulla qualità principali delle app e le best practice per i test.

Per eseguire i test, installa l'app pubblicata corrente su un dispositivo con Android 15 e completa tutti i flussi e le funzionalità cercando eventuali problemi. Per aiutarti a concentrare i test, esamina le modifiche al comportamento per tutte le app introdotte in Android 15 che possono influire sul funzionamento dell'app o causarne l' arresto anomalo.

Assicurati inoltre di esaminare e testare l'utilizzo di interfacce non SDK con limitazioni. Dovresti sostituire qualsiasi interfaccia con limitazioni utilizzata dall'app con un SDK pubblico o un equivalente NDK. Cerca gli avvisi logcat che evidenziano questi accessi e utilizza il StrictMode metodo detectNonSdkApiUsage() per rilevarli in modo programmatico.

Infine, assicurati di testare completamente le librerie e gli SDK nella tua app per assicurarti che funzionino come previsto su Android 15 e seguano le best practice per privacy, prestazioni, UX, gestione dei dati e autorizzazioni. Se riscontri un problema, prova ad aggiornare all'ultima versione dell'SDK o contatta lo sviluppatore dell'SDK per ricevere assistenza.

Una volta terminati i test e apportati gli aggiornamenti, ti consigliamo di pubblicare subito l'app compatibile. In questo modo, gli utenti potranno testare l'app in anticipo e garantire una transizione senza problemi quando eseguiranno l'aggiornamento ad Android 15.

Aggiorna il targeting e la build dell'app con le nuove API

Dopo aver pubblicato una versione compatibile dell'app, il passaggio successivo consiste nell'aggiungere il supporto completo per Android 15 aggiornando targetSdkVersion e sfruttando le nuove API e funzionalità di Android 15. Puoi apportare questi aggiornamenti non appena sei pronto, tenendo presente i requisiti di Google Play per il targeting della nuova piattaforma.

Quando pianifichi il lavoro per supportare completamente Android 15, esamina le modifiche al comportamento che interessano le app che hanno come target Android 15. Queste modifiche al comportamento mirate potrebbero causare problemi funzionali che dovrai risolvere. In alcuni casi, queste modifiche richiedono uno sviluppo significativo, quindi ti consigliamo di conoscerle e risolverle il prima possibile. Per identificare le modifiche al comportamento specifiche che interessano la tua app, utilizza gli indicatori di compatibilità per testare l'app con le modifiche selezionate attivate.

I passaggi seguenti descrivono come supportare completamente Android 15.

Scarica l'SDK, modifica il targeting, crea la build con le nuove API

Per iniziare a testare il supporto completo di Android 15, utilizza l'ultima versione di anteprima di Android Studio per scaricare l'SDK Android 15 e tutti gli altri strumenti di cui hai bisogno. Poi, aggiorna targetSdkVersion e compileSdkVersion dell'app e ricompila l'app. Per dettagli, consulta la guida alla configurazione dell'SDK.

Testa l'app Android 15

Dopo aver compilato l'app e averla installata su un dispositivo con Android 15, inizia a testarla per assicurarti che funzioni correttamente quando ha come target Android 15. Alcune modifiche al comportamento si applicano solo quando l'app ha come target la nuova piattaforma, quindi ti consigliamo di esaminare quelle modifiche prima di iniziare.

Come per i test di compatibilità di base, completa tutti i flussi e le funzionalità cercando eventuali problemi. Concentra i test sulle modifiche al comportamento per le app che hanno come target Android 15. È anche un buon momento per verificare la tua app rispetto alle norme sulla qualità principali delle app e alle best practice per i test.

Assicurati di esaminare e testare l'utilizzo di interfacce non SDK con limitazioni che potrebbero essere applicabili. Cerca gli avvisi logcat che evidenziano questi accessi e utilizza il metodo StrictMode detectNonSdkApiUsage() per rilevarli in modo programmatico.

Infine, assicurati di testare completamente le librerie e gli SDK nella tua app per assicurarti che funzionino come previsto su Android 15 e seguano le best practice per privacy, prestazioni, UX, gestione dei dati e autorizzazioni. Se riscontri un problema, prova ad aggiornare all'ultima versione dell'SDK o contatta lo sviluppatore dell'SDK per ricevere assistenza.

Esegui i test utilizzando gli indicatori di compatibilità delle app

Android 15 include indicatori di compatibilità che semplificano il test dell'app con modifiche al comportamento mirate. Per un'app di cui è possibile eseguire il debug, gli indicatori ti consentono di:

• Testare le modifiche mirate senza modificare effettivamente targetSdkVersion dell'app. Puoi utilizzare gli indicatori per forzare l'attivazione di modifiche al comportamento mirate specifiche per valutare l'impatto sull'app esistente.
• Concentrare i test solo su modifiche specifiche. Anziché dover risolvere tutte le modifiche mirate contemporaneamente, gli indicatori ti consentono di disattivare tutte le modifiche mirate tranne quelle che vuoi testare.
• Gestire gli indicatori tramite adb. Puoi utilizzare i comandi adb per attivare e disattivare le modifiche attivabili nell'ambiente di test automatizzato.
• Eseguire il debug più velocemente utilizzando gli ID di modifica standard. Ogni modifica attivabile ha un ID e un nome univoci che puoi utilizzare per eseguire rapidamente il debug della causa principale nell'output del log.

Gli indicatori possono essere utili quando ti prepari a modificare il targeting dell'app o durante lo sviluppo attivo per il supporto di Android 15. Per maggiori informazioni, consulta Modifiche al framework di compatibilità (Android 15).