Android 8.0 (livello API 26) introduce modifiche al comportamento, nonché nuove funzionalità e API che puoi sfruttare nelle tue app. Questo documento fornisce una panoramica dei passaggi per eseguire la migrazione delle tue app ad Android 8.0 in due fasi principali:
- Garantisci la compatibilità con Android 8.0
Verifica che la tua app sia completamente funzionale sulla nuova versione della piattaforma. In questa fase, non utilizzi nuove API né modifichi il valore
targetSdkVersiondella tua app, ma potrebbero essere necessarie piccole modifiche. - Aggiorna la versione target e utilizza le funzionalità di Android 8.0
Quando vuoi sfruttare le nuove funzionalità della piattaforma, aggiorna
targetSdkVersionalla versione 26, verifica che l'app continui a funzionare come previsto e poi inizia a utilizzare le nuove API.
Garantisci la compatibilità con Android 8.0
L'obiettivo è assicurarti che la tua app esistente funzioni così com'è su Android 8.0 (livello API 26). Poiché alcune modifiche alla piattaforma potrebbero influire sul comportamento della tua app,
potrebbero essere necessari alcuni aggiustamenti, ma non è necessario utilizzare nuove API o
modificare il tuo targetSdkVersion.
Prepara un dispositivo con Android 8.0
- Se hai un dispositivo compatibile (Pixel, Pixel XL, Pixel C, Nexus 5X, Nexus 6P o Nexus Player), segui le istruzioni per eseguire il flashing del dispositivo.
- In alternativa, scarica l'immagine di sistema di Android 8.0 per l'emulatore Android. È elencata in SDK Manager in Android 8.0 come Immagine di sistema API di Google Intel x86 Atom.
Nota: l'immagine di sistema di Android 8.0 è disponibile per il download da Android Studio 3.0 e versioni successive. Per saperne di più, consulta la sezione di seguito per scaricare l'SDK Android 8.0.
Esegui test di compatibilità
Per la maggior parte, i test di compatibilità con Android 8.0 (livello API 26) comportano lo stesso tipo di test che esegui quando ti prepari a rilasciare la tua app. Questo è un buon momento per esaminare le norme sulla qualità principali delle app e le best practice per i test.
Tuttavia, esiste un altro aspetto dei test: Android 8.0 introduce modifiche alla piattaforma Android che possono influire sul comportamento della tua app o interromperla del tutto, anche se non modifichi il targetSdkVersion. Per questo motivo, è importante esaminare le modifiche principali
nella tabella 1 e testare le correzioni implementate per adattarle alle modifiche.
Tabella 1. Modifiche principali che interessano tutte le app in esecuzione su dispositivi Android 8.0.
| Cambia | Riepilogo | Ulteriori riferimenti |
|---|---|---|
| Aggiornamenti della posizione in background meno frequenti | Se la tua app riceve aggiornamenti della posizione da un servizio in background, riceve aggiornamenti meno frequenti su Android 8.0 (livello API 26) rispetto alle versioni precedenti di Android. In particolare, un servizio in background non può ricevere aggiornamenti sulla posizione più di qualche volta all'ora. Tuttavia, mentre l'app è in primo piano, la frequenza degli aggiornamenti della posizione rimane invariata. | Limiti di accesso alla posizione in background |
net.hostname non sono più supportati |
La query della proprietà di sistema net.hostname produce un risultato nullo.
|
Nessuno |
Nuova eccezione da send(DatagramPacket) |
Il metodo send(DatagramPacket) genera un SocketException se il metodo connect(InetAddress, int) eseguito in precedenza non è andato a buon fine.
|
Modifiche del comportamento: connettività di rete e HTTP(S) |
NullPointerException corretto dai metodi AbstractCollection |
AbstractCollection.removeAll(null) e
AbstractCollection.retainAll(null) ora generano sempre un'eccezione
NullPointerException;
in precedenza, l'eccezione NullPointerException non veniva generata quando la raccolta era vuota.
Questa modifica rende il comportamento coerente con la documentazione.
|
Modifiche al comportamento: gestione delle raccolte |
NullPointerException corretto da
Currency.getDisplayName(null) |
La chiamata a Currency.getDisplayName(null) genera un NullPointerException.
|
Modifiche del comportamento: impostazioni internazionali e internazionalizzazione |
Per un elenco più completo delle modifiche del comportamento in Android 8.0 (livello API 26), consulta anche Modifiche del comportamento di Android 8.0.
Aggiorna la versione target e utilizza le funzionalità di Android 8.0
Questa sezione spiega come attivare il supporto completo per Android 8.0 (livello API 26) aggiornando targetSdkVersion a 26 e aggiungendo nuove funzionalità disponibili in Android 8.0.
Oltre a offrire nuove API, Android 8.0 introduce alcune modifiche
al comportamento quando aggiorni targetSdkVersion alla versione 26. Poiché alcune modifiche al comportamento potrebbero richiedere modifiche al codice per evitare interruzioni, devi prima capire in che modo la tua app potrebbe essere interessata quando modifichi targetSdkVersion esaminando tutte le modifiche al comportamento per le app che hanno come target Android 8.0.
Nota: i passaggi descritti sopra per garantire la compatibilità della piattaforma sono prerequisiti per scegliere come target della tua app Android 8.0, quindi assicurati di completare prima questi passaggi.
Scarica l'SDK per Android 8.0
Puoi scaricare i pacchetti SDK per creare la tua app con Android 8.0 (livello API 26) utilizzando l'ultima versione di Android Studio (è consigliato Android Studio 3.0 o versioni successive). Android Studio 3.0 e versioni successive include strumenti che ti aiutano con le funzionalità di Android 8.0, come le icone adattive e i caratteri scaricabili. Se non hai ancora bisogno di queste funzionalità, puoi utilizzare la versione stabile di Android Studio 2.3.3 per creare la tua app con Android 8.0 e utilizzare le nuove API.
Per configurare una delle due versioni di Android Studio, segui questi passaggi:
- Avvia Android Studio e apri SDK Manager facendo clic su Strumenti > SDK Manager.
- Nella scheda SDK Platforms (Piattaforme SDK), seleziona Show Package Details (Mostra dettagli pacchetto). In
Anteprima di Android 8.0, controlla quanto segue:
- Android SDK Platform 26
- API di Google Intel x86 Atom System Image (richiesto solo per l'emulatore)
- Passa alla scheda Strumenti SDK e seleziona tutti gli elementi per cui sono disponibili aggiornamenti (fai clic su ogni casella di controllo che mostra un trattino
). Dovrebbero essere incluse le ultime versioni dei seguenti elementi obbligatori:
- Android SDK Build-Tools 26.0.0
- Android SDK Platform-Tools 26.0.0
- Emulatore Android 26.0.0
- Fai clic su Ok per installare tutti i pacchetti SDK selezionati.
Ora puoi iniziare a creare con Android 8.0.
Aggiorna la configurazione di compilazione
Aggiorna compileSdkVersion, targetSdkVersion e la versione della libreria di assistenza alle ultime revisioni disponibili, ad esempio:
android {
compileSdkVersion 26
defaultConfig {
targetSdkVersion 26
}
...
}
dependencies {
compile 'com.android.support:appcompat-v7:26.0.0'
}
// REQUIRED: Google's new Maven repo is required for the latest
// support library that is compatible with Android 8.0
repositories {
google()
// If you're using a version of Gradle lower than 4.1, you must instead use:
// maven {
// url 'https://maven.google.com'
// }
}
Rimuovi i broadcast receiver dal file manifest
Poiché Android 8.0 (livello API 26) introduce nuove limitazioni per i broadcast receiver, devi rimuovere tutti i broadcast receiver registrati per gli intent di trasmissione impliciti. Se li lasci, non interromperanno l'app in fase di build o di runtime, ma non avranno alcun effetto quando l'app viene eseguita su Android 8.0.
Le trasmissioni a cui solo la tua app può rispondere, ovvero gli intent di trasmissione espliciti e le trasmissioni inviate specificamente al nome del pacchetto della tua app, continuano a funzionare allo stesso modo su Android 8.0.
Esistono eccezioni a questa nuova limitazione. Per un elenco delle trasmissioni implicite che funzionano ancora nelle app destinate ad Android 8.0, consulta Eccezioni per le trasmissioni implicite.
Testa la tua app per Android 8.0
Una volta completate le preparazioni precedenti, puoi creare la tua app e poi testarla ulteriormente per assicurarti che funzioni correttamente quando ha come target Android 8.0 (livello API 26). Questo è un altro buon momento per esaminare le norme sulla qualità principali delle app e le best practice per i test.
Quando crei la tua app con targetSdkVersion impostato su 26,
devi tenere conto di alcune modifiche specifiche della piattaforma. Alcune di queste modifiche possono influire in modo significativo sul comportamento della tua app o persino interromperne completamente il funzionamento, anche se non implementi nuove funzionalità in Android 8.0.
La Tabella 2 fornisce un elenco di queste modifiche con link ad ulteriori informazioni.
Tabella 2. Modifiche principali che interessano le app
quando targetSdkVersion è impostato su 26.
| Cambia | Riepilogo | Ulteriori riferimenti |
|---|---|---|
| Privacy | Android 8.0 (livello API 26) non supporta l'utilizzo delle proprietà di sistema net.dns1, net.dns2, net.dns3 o net.dns4. | Modifiche del comportamento: privacy |
| Segmenti scrivibili ed eseguibili applicati | Per le librerie native, Android 8.0 (livello API 26) applica la regola secondo cui i dati non devono essere eseguibili e il codice non deve essere scrivibile. | Modifiche del comportamento: librerie native |
| Convalida dell'intestazione e della sezione ELF | Il linker dinamico controlla più valori nell'intestazione ELF e nelle intestazioni delle sezioni e non va a buon fine se non sono validi. | Modifiche del comportamento: librerie native |
| Notifiche | Le app che hanno come target la versione dell'SDK Android 8.0 (livello API 26) devono implementare uno o più canali di notifica per pubblicare notifiche per gli utenti. | Panoramica dell'API: Notifiche |
Il metodo List.sort()
|
Le implementazioni di questo metodo potrebbero non chiamare più Collections.sort(), altrimenti la tua app genererà un'eccezione a causa di un overflow dello stack.
|
Modifiche al comportamento: gestione delle raccolte |
Il metodo Collections.sort()
|
Nelle implementazioni di List, Collections.sort() ora genera un
ConcurrentModificationException.
|
Modifiche al comportamento: gestione delle raccolte |
Per un elenco più completo delle modifiche al comportamento in Android 8.0 (livello API 26), consulta Modifiche al comportamento di Android 8.0.
Per scoprire le nuove funzionalità e API disponibili con Android 8.0 (livello API 26), consulta Funzionalità e API di Android 8.0.