Questo documento offre una visione generale delle fasi tipiche di sviluppo e test che può aiutarti a creare un piano di preparazione ben allineato alle tempistiche di rilascio della piattaforma e che garantisca un'ottima esperienza per gli utenti su Android 13.
Con ogni release di Android introduciamo nuove funzionalità e cambiamenti del comportamento volti a rendere Android più utile, sicuro e dalle prestazioni migliori. In molti casi l'app funzionerà subito come previsto, mentre in altri casi potresti dover aggiornare l'app 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), pertanto è importante che le tue app siano pronte, funzionino come previsto per gli utenti e, idealmente, sfruttino le nuove funzionalità e le nuove API per ottenere il massimo dalla nuova piattaforma.
In genere, una migrazione è suddivisa in due fasi, che possono essere simultanee:
- Garanzia della compatibilità delle app (per la release finale di Android 13)
- Targeting delle nuove funzionalità e API della piattaforma (non appena possibile dopo il rilascio finale)
Garantire la compatibilità con Android 13
È importante testare la funzionalità della tua app esistente rispetto ad Android 13 per garantire un'esperienza ottimale agli utenti che eseguono l'aggiornamento alla versione più recente di Android. Alcune modifiche alla piattaforma possono influire sul comportamento dell'app, pertanto è importante testare in anticipo e in modo approfondito l'app e apportare le modifiche necessarie.
Generalmente puoi modificare l'app e pubblicare un aggiornamento senza dover modificare il valore targetSdkVersion dell'app. Allo stesso modo, non dovresti dover utilizzare nuove API o
modificare il compileSdkVersion dell'app, anche se ciò può dipendere dal modo in cui
la tua app è stata creata e dalle funzionalità della piattaforma che utilizza.
Prima di iniziare il test, assicurati di acquisire familiarità con le modifiche
del comportamento di tutte le app. Queste modifiche potrebbero interessare la tua app, anche se non ne modifichi i targetSdkVersion.
Esegui il flash di un'immagine di sistema Android 13 sul tuo dispositivo o scarica un'immagine di sistema per l'emulatore Android.
Esamina le modifiche al comportamento del sistema per identificare le aree in cui la tua app potrebbe essere interessata.
Installa l'app sul tuo dispositivo o emulatore ed esegui dei test. Concentrati sulle modifiche del comportamento del sistema e analizza tutti i flussi dell'app.
Apporta solo le modifiche al codice necessarie per adattarsi alle modifiche del comportamento o risolvere i problemi. Ricompila con lo stesso livello API scelto come target inizialmente dell'app, senza dover scegliere come target Android 13.
Firma, carica e pubblica l'Android App Bundle o l'APK aggiornato.
Esegui test di compatibilità
Per la maggior parte, testare la compatibilità con Android 13 è simile ai normali test delle app. Questo è un buon momento per rivedere le norme sulla qualità principali delle app e le best practice per i test.
Per verificarla, installa l'app attualmente pubblicata su un dispositivo con Android 13 e analizza tutti i flussi e le funzionalità cercando i problemi. Per ottimizzare i test, esamina le modifiche del comportamento di tutte le app introdotte in Android 13 che possono influire sul funzionamento della tua app o causare l'arresto anomalo dell'app.
Inoltre, assicurati di esaminare e testare gli utilizzi di interfacce non SDK limitate. Devi sostituire qualsiasi interfaccia con restrizioni utilizzata dalla tua app con un SDK pubblico o un equivalente NDK. Controlla gli avvisi logcat che evidenziano questi accessi e utilizza il metodo StrictMode detectNonSdkApiUsage() per intercettarli in modo programmatico.
Infine, assicurati di testare completamente le librerie e gli SDK nella tua app per assicurarti che funzionino come previsto su Android 13 e segui le best practice per privacy, prestazioni, UX, gestione dei dati e autorizzazioni. Se riscontri un problema, prova a eseguire l'aggiornamento all'ultima versione dell'SDK o contatta lo sviluppatore dell'SDK per ricevere assistenza.
Una volta terminato il test e apportato gli eventuali aggiornamenti, ti consigliamo di pubblicare subito la tua app compatibile. In questo modo gli utenti possono testare l'app in anticipo e garantire una transizione senza problemi per gli utenti che eseguono l'aggiornamento ad Android 13.
Aggiorna il targeting dell'app e crea con nuove API
Dopo aver pubblicato una versione compatibile della tua app, il passaggio successivo consiste nell'aggiungere
il supporto completo per Android 13 aggiornando il relativo targetSdkVersion
e sfruttando le nuove API e funzionalità di Android 13.
Puoi apportare questi aggiornamenti non appena sarà tutto pronto, tenendo presente i requisiti di Google Play per il targeting della nuova piattaforma.
Mentre pianifichi il tuo lavoro per supportare completamente Android 13, consulta le modifiche del comportamento che interessano le app destinate ad Android 13. Queste modifiche al comportamento mirato potrebbero causare problemi funzionali che dovrai risolvere. In alcuni casi, questi cambiamenti richiedono uno sviluppo significativo, quindi ti consigliamo di scoprirli e affrontarli il prima possibile. Per identificare più facilmente modifiche al comportamento specifiche che interessano la tua app, utilizza i dispositivi di attivazione/disattivazione della compatibilità per testare l'app con le modifiche selezionate attivate.
I passaggi seguenti spiegano come supportare completamente Android 13.
Installa la versione più recente dell'anteprima di Android Studio per creare
con Android 13. Assicurati di avere un emulatore o un dispositivo Android 13.
Aggiorna le configurazioni di build di targetSdkVersion e altre.
Esamina le modifiche del comportamento che si applicano alle app che hanno come target Android 13. Identifica le aree in cui la tua app potrebbe essere interessata e pianifica come supportarle.
Apporta le modifiche al codice e all'architettura necessarie per supportare le modifiche relative alla privacy dell'utente di Android 13.
Sfrutta le API Android 13 per aggiungere nuove funzionalità alle tue app. Ricompila per Android 13.
Esegui il test su un emulatore o un dispositivo Android 13. Concentrati sulle aree in cui le modifiche del comportamento potrebbero influire sulla tua app. Prova la funzionalità che utilizza nuove API. Fornisci feedback sulla piattaforma e sull'API. Segnala eventuali problemi relativi a piattaforma, API o SDK di terze parti.
Quando le API Android 13 sono definitive, aggiorna di nuovo targetSdkVersion e altre configurazioni di build, apporta eventuali aggiornamenti aggiuntivi e testa l'app.
Firma, carica e pubblica l'Android App Bundle o l'APK aggiornato.
Scarica l'SDK, cambia il targeting, crea con nuove API
Per iniziare a testare il supporto completo di Android 13, utilizza
l'ultima versione di anteprima di Android Studio per scaricare l'SDK per Android 13
e tutti gli altri strumenti di cui hai bisogno. Dopodiché, aggiorna targetSdkVersion e compileSdkVersion dell'app e ricompila l'app. Per i dettagli, consulta la guida alla configurazione dell'SDK.
Testare l'app Android 13
Dopo aver compilato l'app e averla installata su un dispositivo con Android 13, inizia a testarla per assicurarti che l'app funzioni correttamente quando scegli come target Android 13. Alcune modifiche al comportamento vengono applicate solo quando la tua app ha come target la nuova piattaforma, pertanto ti consigliamo di esaminare tali modifiche prima di iniziare.
Come per i test di compatibilità di base, esamina tutti i flussi e tutte le funzionalità per individuare eventuali problemi. Concentra i tuoi test sulle modifiche del comportamento per le app destinate ad Android 13. È anche un buon momento per controllare la tua app in base alle norme sulla qualità principali delle app e alle best practice per i test.
Assicurati di esaminare e testare gli utilizzi di interfacce non SDK limitate che potrebbero essere applicabili. Controlla se sono presenti 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 13 e segui le best practice per privacy, prestazioni, UX, gestione dei dati e autorizzazioni. Se riscontri un problema, prova a eseguire l'aggiornamento all'ultima versione dell'SDK o contatta lo sviluppatore dell'SDK per ricevere assistenza.
Esegui dei test utilizzando i pulsanti di attivazione/disattivazione della compatibilità delle app
Android 13 include opzioni di attivazione/disattivazione della compatibilità che semplificano i test della tua app con modifiche del comportamento mirate. Per un'app di cui è possibile eseguire il debug, i pulsanti di attivazione/disattivazione ti consentono di:
- Testa modifiche mirate senza modificare effettivamente il valore targetSdkVersion dell'app. Puoi utilizzare i pulsanti di attivazione/disattivazione per forzare l'attivazione di modifiche specifiche del comportamento mirato al fine di valutare l'impatto sulla tua app esistente.
- Esegui i test solo su modifiche specifiche. Invece di dover risolvere tutte le modifiche mirate contemporaneamente, le opzioni di attivazione/disattivazione ti consentono di disabilitare tutte le modifiche scelte come target tranne quelle su cui vuoi eseguire il test.
- Gestisci i pulsanti di attivazione/disattivazione tramite ADB. Puoi usare i comandi adb per abilitare e disabilitare le modifiche attivabili nell'ambiente di test automatizzato.
- Esegui il debug più velocemente utilizzando gli ID modifica standard. Le modifiche che possono essere attivate hanno ciascuna un ID e un nome univoci che puoi utilizzare per eseguire rapidamente il debug della causa principale nell'output del log.
Mentre ti prepari a modificare il targeting della tua app o sei in fase di sviluppo attivo per il supporto di Android 13, i pulsanti di attivazione/disattivazione possono aiutarti. Per ulteriori informazioni, consulta Modifiche del framework di compatibilità (Android 13).