Eseguire la migrazione delle app ad Android 16

Questo documento offre una panoramica generale delle fasi tipiche di sviluppo e test che possono aiutarti a pianificare la preparazione in modo che sia in linea con la sequenza temporale di rilascio della piattaforma e garantisca un'esperienza ottimale per gli utenti su Android 16.

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 simultanee:

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

Garantire la compatibilità con Android 16

È importante testare la funzionalità dell'app esistente su Android 16 per garantire un'esperienza ottimale agli 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 influire sulla tua app, anche se non modifichi targetSdkVersion.

Esegui test di compatibilità

Nella maggior parte dei casi, il test di compatibilità con Android 16 è 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 il test, installa l'app pubblicata corrente su un dispositivo con Android 16 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 16 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 dalla tua 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 16 e seguano le best practice per privacy, prestazioni, UX, gestione dei dati e autorizzazioni. Se riscontri un problema, prova ad eseguire l'aggiornamento 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 possono testare l'app in anticipo e contribuire a garantire una transizione senza problemi quando eseguono l'aggiornamento ad Android 16.

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 16 aggiornando targetSdkVersion e sfruttando le nuove API e funzionalità di Android 16. 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 16, esamina le modifiche al comportamento che interessano le app che hanno come target Android 16. 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 seguenti passaggi descrivono come supportare completamente Android 16.

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

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

Testa l'app Android 16

Dopo aver compilato l'app e averla installata su un dispositivo con Android 16, inizia a testarla per assicurarti che funzioni correttamente quando ha come target Android 16. 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 16. È 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 16 e seguano le best practice per privacy, prestazioni, UX, gestione dei dati e autorizzazioni. Se riscontri un problema, prova ad eseguire l'aggiornamento all'ultima versione dell'SDK o contatta lo sviluppatore dell'SDK per ricevere assistenza.

Test con gli indicatori di compatibilità delle app

Android 16 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ù rapidamente utilizzando gli ID di modifica standard. Le modifiche attivabili hanno ciascuna 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 16. Per ulteriori informazioni, consulta Modifiche al framework di compatibilità (Android 16).