Cambiamenti del comportamento: app destinate ad Android 15 o versioni successive

Come nelle release precedenti, Android 15 include modifiche del comportamento che potrebbero interessare la tua app. Le seguenti modifiche del comportamento si applicano esclusivamente alle app destinate ad Android 15 o versioni successive. Se la tua app ha come target Android 15 o versioni successive, devi modificarla in modo da supportare correttamente questi comportamenti, ove applicabile.

Assicurati di esaminare anche l'elenco delle modifiche al comportamento che interessano tutte le app in esecuzione su Android 15, indipendentemente dal targetSdkVersion della tua app.

Funzionalità di base

Android 15 modifica o espande varie funzionalità di base del sistema Android.

Modifiche ai servizi in primo piano

Stiamo apportando le seguenti modifiche ai servizi in primo piano con Android 15.

• Comportamento di timeout del servizio in primo piano di sincronizzazione dei dati
• Nuovo tipo di servizio in primo piano per l'elaborazione dei contenuti multimediali
• Limitazioni relative ai broadcast receiver che BOOT_COMPLETED avviano i servizi in primo piano
• Limitazioni relative all'avvio di servizi in primo piano quando un'app conserva l'autorizzazione SYSTEM_ALERT_WINDOW

Comportamento di timeout del servizio in primo piano di sincronizzazione dei dati

Android 15 introduce un nuovo comportamento di timeout per dataSync per le app che hanno come target Android 15 (livello API 35) o versioni successive. Questo comportamento si applica anche al nuovo tipo di servizio in primo piano mediaProcessing.

Il sistema consente l'esecuzione dei servizi dataSync di un'app per un totale di 6 ore in un periodo di 24 ore, dopodiché il sistema chiama il metodo Service.onTimeout(int, int) del servizio in esecuzione (introdotto in Android 15). Al momento, il servizio ha alcuni secondi di tempo per chiamare Service.stopSelf(). Quando viene chiamato Service.onTimeout(), il servizio non è più considerato un servizio in primo piano. Se il servizio non chiama Service.stopSelf(), il sistema genera un'eccezione interna. L'eccezione viene registrata in Logcat con il seguente messaggio:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"

Per evitare problemi con questa modifica del comportamento, puoi eseguire una o più delle seguenti operazioni:

1. Chiedi al tuo servizio di implementare il nuovo metodo Service.onTimeout(int, int). Quando l'app riceve il Callback, assicurati di chiamare stopSelf() entro alcuni secondi. Se non interrompi immediatamente l'app, il sistema genera un errore.
2. Assicurati che i servizi dataSync della tua app non vengano eseguiti per più di un totale di 6 ore in un periodo di 24 ore (a meno che l'utente non interagisca con l'app, reimpostando il timer).
3. Avvia i servizi in primo piano dataSync solo in seguito a un'interazione diretta con l'utente. Poiché l'app è in primo piano all'avvio del servizio, il servizio ha a disposizione tutte le sei ore dopo che l'app passa in background.
4. Anziché utilizzare un servizio in primo piano dataSync, utilizza un'API alternativa.

Se i servizi in primo piano dataSync della tua app sono stati in esecuzione per 6 ore nelle ultime 24, non puoi avviare un altro servizio in primo piano dataSync a meno che l'utente non abbia portato la tua app in primo piano (il che reimposta il timer). Se provi a avviare un altro servizio in primo piano dataSync, il sistema genera un messaggio di errore ForegroundServiceStartNotAllowedException come "Tempo limite già esaurito per il servizio in primo piano di tipo dataSync".

Test

Per testare il comportamento dell'app, puoi attivare i timeout della sincronizzazione dei dati anche se la tua app non ha come target Android 15 (a condizione che l'app sia in esecuzione su un dispositivo Android 15). Per abilitare i timeout, esegui questo comando adb:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

Puoi anche modificare il periodo di timeout per testare più facilmente il comportamento della tua app quando viene raggiunto il limite. Per impostare un nuovo periodo di timeout, esegui il seguente comando adb:

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

Nuovo tipo di servizio in primo piano per l'elaborazione dei contenuti multimediali

Android 15 introduce un nuovo tipo di servizio in primo piano, mediaProcessing. Questo tipo di servizio è appropriato per operazioni come la transcodifica di file multimediali. Ad esempio, un'app multimediale potrebbe scaricare un file audio e doverlo convertire in un formato diverso prima di riprodurlo. Puoi utilizzare un servizio in primo piano mediaProcessing per assicurarti che la conversione continui anche quando l'app è in background.

Il sistema consente l'esecuzione dei servizi mediaProcessing di un'app per un totale di 6 ore in un periodo di 24 ore, dopodiché chiama il metodo Service.onTimeout(int, int) del servizio in esecuzione (introdotto in Android 15). Al momento, il servizio ha alcuni secondi di tempo per chiamare Service.stopSelf(). Se il servizio non chiama Service.stopSelf(), il sistema genera un'eccezione interna. L'eccezione viene registrata in Logcat con il seguente messaggio:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"

Per evitare l'eccezione, puoi procedere in uno dei seguenti modi:

1. Fai in modo che il tuo servizio implementi il nuovo metodo Service.onTimeout(int, int). Quando la tua app viene richiamata, assicurati di chiamare il numero stopSelf() entro pochi secondi. Se non interrompi immediatamente l'app, il sistema genera un errore.
2. Assicurati che i servizi mediaProcessing della tua app non vengano eseguiti per più di 6 ore in un periodo di 24 ore (a meno che l'utente non interagisca con l'app, reimpostando il timer).
3. Avvia mediaProcessing servizi in primo piano solo a seguito dell'interazione diretta degli utenti. Poiché la tua app è in primo piano all'avvio del servizio, il tuo servizio ha a disposizione tutte le sei ore dopo il passaggio dell'app in background.
4. Anziché utilizzare un servizio in primo piano mediaProcessing, utilizza un'API alternativa, come WorkManager.

Se i servizi in primo piano mediaProcessing della tua app sono stati in esecuzione per 6 ore nelle ultime 24, non puoi avviare un altro servizio in primo piano mediaProcessing a meno che l'utente non abbia portato la tua app in primo piano (il che reimposta il timer). Se provi ad avviare un altro servizio in primo piano mediaProcessing, il sistema genera un messaggio di errore ForegroundServiceStartNotAllowedException come "Tempo limite già esaurito per il servizio in primo piano tipo mediaProcessing".

Per ulteriori informazioni sul tipo di servizio mediaProcessing, consulta Modifiche ai tipi di servizio in primo piano per Android 15: elaborazione multimediale.

Test

Per testare il comportamento dell'app, puoi attivare i timeout di elaborazione dei contenuti multimediali anche se la tua app non ha come target Android 15 (a condizione che l'app sia in esecuzione su un dispositivo Android 15). Per abilitare i timeout, esegui il seguente comando adb:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

Puoi anche modificare il periodo di timeout per testare più facilmente il comportamento della tua app quando viene raggiunto il limite. Per impostare un nuovo periodo di timeout, esegui il seguente comando adb:

adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds

Limitazioni relative ai broadcast receiver BOOT_COMPLETED che avviano i servizi in primo piano

Esistono nuove limitazioni per i BOOT_COMPLETED ricevitori di trasmissione che avviano servizi in primo piano. BOOT_COMPLETED di destinatari non sono autorizzati ad avviare il i seguenti tipi di servizi in primo piano:

• dataSync
• camera
• mediaPlayback
• phoneCall
• mediaProjection
• microphone (questa limitazione è in vigore per microphone dal giorno Android 14)

Se un receiver BOOT_COMPLETED tenta di avviare uno di questi tipi di servizi in primo piano, il sistema genera un'eccezione ForegroundServiceStartNotAllowedException.

Test

Per verificare il comportamento della tua app, puoi attivare queste nuove limitazioni anche se le tue L'app non ha come target Android 15 (purché l'app sia installata su un Android 15) dispositivo). Esegui il seguente comando adb:

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

Per inviare un annuncio BOOT_COMPLETED senza riavviare il dispositivo: esegui questo comando adb:

adb shell am broadcast -a android.intent.action.BOOT_COMPLETED your-package-name

Limitazioni relative all'avvio di servizi in primo piano quando un'app conserva l'autorizzazione SYSTEM_ALERT_WINDOW

In precedenza, se un'app disponeva dell'autorizzazione SYSTEM_ALERT_WINDOW, poteva avviare un servizio in primo piano anche se l'app era attualmente in background (come discusso nella sezione Esclusioni dalle limitazioni di avvio in background).

Se un'app ha come target Android 15, l'esenzione è ora più limitata. Ora l'app deve avere l'autorizzazione SYSTEM_ALERT_WINDOW e anche una finestra overlay visibile. In altre parole, l'app deve prima avviare una finestra TYPE_APPLICATION_OVERLAY e la finestra deve essere visibile prima di avviare un servizio in primo piano.

Se la tua app tenta di avviare un servizio in primo piano in background senza soddisfare questi nuovi requisiti (e non ha altre esenzioni), il sistema restituisce ForegroundServiceStartNotAllowedException.

Se la tua app dichiara l'autorizzazione SYSTEM_ALERT_WINDOW e avvia servizi in primo piano in background, potrebbe essere interessata da questa modifica. Se la tua app riceve un ForegroundServiceStartNotAllowedException, controlla l'ordine di operazioni dell'app e assicurati che abbia già una finestra in overlay attiva prima di tentare di avviare un servizio in primo piano da un servizio in background. Puoi controllare se la finestra dell'overlay è attualmente visibile chiamando View.getWindowVisibility() oppure puoi eseguire l'override di View.onWindowVisibilityChanged() per ricevere una notifica ogni volta che la visibilità cambia.

Test

Per testare il comportamento della tua app, puoi attivare queste nuove limitazioni anche se la tua app non ha come target Android 15 (a condizione che l'app sia in esecuzione su un dispositivo Android 15). Per attivare queste nuove limitazioni per l'avvio dei servizi in primo piano dall'background, esegui il seguente comando adb:

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

Modifiche ai casi in cui le app possono modificare lo stato globale della modalità Non disturbare

Le app destinate ad Android 15 non possono più modificare lo stato o il criterio globale della modalità Non disturbare su un dispositivo (modificando le impostazioni utente o disattivando la modalità DND). Le app devono però fornire un codice AutomaticZenRule, che il sistema combina in un criterio globale con lo schema con il criterio più restrittivo e vincente. Le chiamate alle API esistenti che in precedenza influenzavano lo stato globale (setInterruptionFilter, setNotificationPolicy) comportano la creazione o l'aggiornamento di un elemento AutomaticZenRule implicito, che viene attivato e disattivato a seconda del ciclo di chiamata di queste chiamate API.

Tieni presente che questa modifica influisce solo sul comportamento osservabile se l'app chiama setInterruptionFilter(INTERRUPTION_FILTER_ALL) e si aspetta che quella chiamata disattivi un AutomaticZenRule che era stato precedentemente attivato dai rispettivi proprietari.

Modifiche all'API OpenJDK

Android 15 continua il lavoro di aggiornamento delle librerie di base di Android per allinearle alle funzionalità delle ultime release LTS di OpenJDK.

Alcune di queste modifiche possono influire sulla compatibilità delle app per quelle che hanno come target Android 15 (livello API 35):

• Modifiche alle API di formattazione delle stringhe: la convalida dell'indice dell'argomento, dei flag, della larghezza e della precisione ora è più rigorosa quando si utilizzano le seguenti API String.format() e Formatter.format():

  • String.format(String, Object[])
  • String.format(Locale, String, Object[])
  • Formatter.format(String, Object[])
  • Formatter.format(Locale, String, Object[])

  Ad esempio, viene lanciata la seguente eccezione quando viene utilizzato un indice dell'argomento pari a 0 (%0 nella stringa di formato):

  IllegalFormatArgumentIndexException: Illegal format argument index = 0
  

  In questo caso, il problema può essere risolto utilizzando un indice dell'argomento pari a 1 (%1 nella stringa di formato).

• Modifiche al tipo di componente di Arrays.asList(...).toArray(): quando utilizzi Arrays.asList(...).toArray(), il tipo di componente dell'array risultante è ora Object, non il tipo degli elementi dell'array sottostante. Pertanto, il seguente codice genera un ClassCastException:

  String[] elements = (String[]) Arrays.asList("one", "two").toArray();
  

  In questo caso, per conservare String come tipo di componente nell'array risultante, puoi utilizzare Collection.toArray(Object[]):

  String[] elements = Arrays.asList("two", "one").toArray(new String[0]);
  

• Modifiche alla gestione dei codici lingua: quando utilizzi l'API Locale, i codici lingua per ebraico, yiddish e indonesiano non vengono più convertiti alle loro forme obsolete (ebraico: iw, yiddish: ji e indonesiano: in). Quando specifichi il codice lingua per una di queste impostazioni internazionali, utilizza invece i codici da ISO 639-1 (ebraico: he, yiddish: yi e indonesiano: id).

• Modifiche alle sequenze di interi casuali: a seguito delle modifiche apportate in https://bugs.openjdk.org/browse/JDK-8301574, i seguenti metodi Random.ints() ora restituiscono una sequenza di numeri diversa rispetto ai metodi Random.nextInt():

  • Random.ints(long)
  • Random.ints(long, int, int)
  • Random.ints(int, int)
  • Random.ints()

  In genere, questa modifica non dovrebbe comportare un comportamento che causa l'interruzione dell'app, ma il codice non deve prevedere che la sequenza generata dai metodi Random.ints() corrisponda a Random.nextInt().

La nuova API SequencedCollection può influire sulla compatibilità della tua app dopo aver aggiornato compileSdk nella configurazione di compilazione dell'app per utilizzare Android 15 (livello API 35):

• Collisione con le funzioni di estensione MutableList.removeFirst() e MutableList.removeLast() in kotlin-stdlib

  Il tipo List in Java è mappato al tipo MutableList in Kotlin. Poiché le API List.removeFirst() e List.removeLast() sono state introdotte in Android 15 (livello API 35), il compilatore Kotlin risolve le chiamate di funzione, ad esempio list.removeFirst(), in modo statico alle nuove API List anziché alle funzioni di estensione in kotlin-stdlib.

  Se un'app viene ricompilata con compileSdk impostato su 35 e minSdk impostato su 34 o versioni precedenti e poi viene eseguita su Android 14 e versioni precedenti, viene generato un errore di runtime:

  java.lang.NoSuchMethodError: No virtual method
  removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;
  

  L'opzione di lint NewApi esistente nel plug-in Android per Gradle può rilevare questi nuovi utilizzi dell'API.

  ./gradlew lint
  
  MainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi]
        list.removeFirst()
  

  Per correggere l'eccezione di runtime e gli errori di lint, le chiamate di funzione removeFirst() e removeLast() possono essere sostituite rispettivamente con removeAt(0) e removeAt(list.lastIndex) in Kotlin. Se utilizzi Android Studio Ladybug | 2024.1.3 o versioni successive, è disponibile anche un'opzione di correzione rapida per questi errori.

  Valuta la possibilità di rimuovere @SuppressLint("NewApi") e lintOptions { disable 'NewApi' } se l'opzione lint è stata disattivata.

• Collisione con altri metodi in Java

  Ai tipi esistenti sono stati aggiunti nuovi metodi, ad esempio List e Deque. Questi nuovi metodi potrebbero non essere compatibili con i metodi con lo stesso nome e gli stessi tipi di argomenti in altre interfacce e classi. In caso di collisione della firma del metodo con incompatibilità, il compilatore javac genera un errore di compilazione. Per esempio:

  Esempio di errore 1:

  javac MyList.java
  
  MyList.java:135: error: removeLast() in MyList cannot implement removeLast() in List
    public void removeLast() {
                ^
    return type void is not compatible with Object
    where E is a type-variable:
      E extends Object declared in interface List
  

  Esempio di errore 2:

  javac MyList.java
  
  MyList.java:7: error: types Deque<Object> and List<Object> are incompatible;
  public class MyList implements  List<Object>, Deque<Object> {
    both define reversed(), but with unrelated return types
  1 error
  

  Esempio di errore 3:

  javac MyList.java
  
  MyList.java:43: error: types List<E#1> and MyInterface<E#2> are incompatible;
  public static class MyList implements List<Object>, MyInterface<Object> {
    class MyList inherits unrelated defaults for getFirst() from types List and MyInterface
    where E#1,E#2 are type-variables:
      E#1 extends Object declared in interface List
      E#2 extends Object declared in interface MyInterface
  1 error
  

  Per correggere questi errori di compilazione, la classe che implementa queste interfacce deve override il metodo con un tipo di ritorno compatibile. Ad esempio:

  @Override
  public Object getFirst() {
      return List.super.getFirst();
  }
  

Sicurezza

Android 15 include modifiche che promuovono la sicurezza del sistema per contribuire a proteggere le app e gli utenti da app dannose.

Avvio di attività in background protette

Android 15 protegge gli utenti da app dannose e offre loro un maggiore controllo i propri dispositivi aggiungendo modifiche che impediscano ad app in background dannose di mettere in primo piano altre app, aumentare i loro privilegi e abusare interazione dell'utente. I lanci di attività in background sono stati limitati dal giorno Android 10 (livello API 29).

Impedisci alle app che non corrispondono all'UID principale nell'impilare di avviare attività

Le app dannose possono avviare l'attività di un'altra app all'interno della stessa attività, quindi sovrapporsi, creando l'illusione di essere quell'app. Questo attacco di "pirateria dell'attività" aggira le attuali limitazioni di lancio in background perché avviene all'interno della stessa attività visibile. Per ridurre questo rischio, Android 15 aggiunge un un flag che impedisce l'avvio delle app che non corrispondono all'UID principale nello stack attività. Per attivare tutte le attività delle app, aggiorna le allowCrossUidActivitySwitchFromBelow nel file AndroidManifest.xml dell'app:

<application android:allowCrossUidActivitySwitchFromBelow="false" >

Le nuove misure di sicurezza sono attive se tutte le seguenti condizioni sono vere:

• L'app che esegue il lancio ha come target Android 15.
• L'app nella parte superiore dello stack di attività ha come target Android 15.
• Per qualsiasi attività visibile sono state attivate le nuove protezioni

Se le misure di sicurezza sono attive, le app potrebbero tornare alla schermata Home anziché all'ultima app visibile se completano la propria attività.

Altre modifiche

Oltre alla limitazione per la corrispondenza dell'UID, anche queste altre modifiche vengono inclusi:

• Modifica i creator di PendingIntent in modo che blocchino l'avvio delle attività in background per impostazione predefinita. In questo modo è possibile impedire alle app di creare accidentalmente un PendingIntent che potrebbero essere utilizzati in modo illecito da malintenzionati.
• Non mettere un'app in primo piano a meno che il mittente PendingIntent lo consente. Questa modifica ha lo scopo di impedire alle app dannose di utilizzare in modo illecito possibilità di avviare attività in background. Per impostazione predefinita, alle app non è consentito portare la serie di attività in primo piano, a meno che il creator non consenta i privilegi di lancio delle attività in background o che il mittente non disponga di questi privilegi.
• Controlla il modo in cui l'attività principale di uno stack di attività può completarne le attività. Se attività principale completa un'attività, Android torna all'attività precedente l'ultima attività. Inoltre, se un'attività non principale completa la propria attività, Android torna alla home page; non bloccherà la finitura di questa parte non superiore attività.
• Impedisci di avviare attività arbitrarie da altre app alla tua. un'attività. Questa modifica impedisce alle app dannose di applicare phishing agli utenti creando attività che sembrano provenire da altre app.
• Impedire che le finestre non visibili vengano prese in considerazione per l'attività in background Google Cloud. In questo modo è possibile evitare che app dannose utilizzino in modo illecito lo sfondo. viene avviata un'attività per mostrare agli utenti contenuti indesiderati o dannosi.

Intenzioni più sicure

Android 15 introduce nuove misure di sicurezza facoltative per rendere gli intent più sicuri e affidabili. Lo scopo di queste modifiche è prevenire le potenziali vulnerabilità e l'uso improprio di intent che possono essere sfruttati da app dannose. Ci sono due miglioramenti principali alla sicurezza degli intent in Android 15:

• Corrispondenza ai filtri intent di destinazione: gli intent che hanno come target componenti specifici devono corrispondere con precisione alle specifiche dei filtri intent del target. Se invii un intento per avviare l'attività di un'altra app, il componente dell'intent di destinazione deve essere in linea con i filtri intent dichiarati dell'attività di destinazione.
• Gli intent devono avere azioni: gli intent senza un'azione non corrisponderanno più a nessun filtro intent. Ciò significa che gli intent utilizzati per avviare attività o servizi devono avere un'azione chiaramente definita.

Per verificare in che modo la tua app risponde a queste modifiche, usa StrictMode nell'app. Per visualizzare log dettagliati sulle violazioni dell'utilizzo di Intent, aggiungi il seguente metodo:

fun onCreate() {
    StrictMode.setVmPolicy(VmPolicy.Builder()
        .detectUnsafeIntentLaunch()
        .build()
    )
}

public void onCreate() {
    StrictMode.setVmPolicy(new VmPolicy.Builder()
            .detectUnsafeIntentLaunch()
            .build());
}

Esperienza utente e UI di sistema

Android 15 include alcune modifiche volte a creare un'esperienza utente più coerente e intuitiva.

Modifiche agli riquadri delle finestre

Esistono due modifiche relative ai riquadri di finestre in Android 15: edge-to-edge è applicato per impostazione predefinita e esistono anche modifiche alla configurazione, ad esempio la configurazione predefinita delle barre di sistema.

Applicazione edge-to-edge

Per impostazione predefinita, le app sono edge-to-edge sui dispositivi con Android 15 se hanno come target Android 15 (livello API 35).

Si tratta di una modifica che potrebbe influire negativamente sull'interfaccia utente della tua app. Le modifiche interessano le seguenti aree della UI:

• Barra di navigazione con handle dei gesti
  • Trasparente per impostazione predefinita.
  • Lo spazio di compensazione in basso è disattivato, pertanto i contenuti vengono disegnati dietro la barra di navigazione del sistema, a meno che non vengano applicati gli inserti.
  • setNavigationBarColor e R.attr#navigationBarColor sono stati ritirati e non influiscono sulla navigazione tramite gesti.
  • setNavigationBarContrastEnforced e R.attr#navigationBarContrastEnforced continuano a non avere alcun effetto sulla navigazione tramite gesti.
• Navigazione con tre pulsanti
  • L'opacità è impostata su 80% per impostazione predefinita, con un colore che potrebbe corrispondere allo sfondo della finestra.
  • Lo spazio di compensazione in basso è disattivato, quindi i contenuti vengono disegnati dietro la barra di navigazione del sistema se non vengono applicati gli inserti.
  • Per impostazione predefinita, setNavigationBarColor e R.attr#navigationBarColor sono impostati in modo da corrispondere allo sfondo della finestra. Affinché questo valore predefinito venga applicato, lo sfondo della finestra deve essere una risorsa drawable a colori. Questa API è stata ritirata, ma continua a influire sulla navigazione con tre pulsanti.
  • setNavigationBarContrastEnforced e R.attr#navigationBarContrastEnforced sono veri per impostazione predefinita, il che aggiunge un sfondo opaco all'80% alla navigazione con tre pulsanti.
• Barra di stato
  • Trasparente per impostazione predefinita.
  • L'offset superiore è disattivato, quindi i contenuti vengono disegnati dietro la barra di stato, a meno che non vengano applicati inserti.
  • setStatusBarColor e R.attr#statusBarColor sono deprecati e non hanno alcun effetto su Android 15.
  • setStatusBarContrastEnforced e R.attr#statusBarContrastEnforced sono deprecati, ma hanno ancora un effetto su Android 15.
• Ritaglio del display
  • layoutInDisplayCutoutMode delle finestre non mobili deve essere LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. SHORT_EDGES, NEVER e DEFAULT vengono interpretati come ALWAYS in modo che gli utenti non vedano una barra nera causata dal ritaglio del display e che lo schermo sia completamente visibile.

L'esempio seguente mostra un'app prima e dopo aver scelto come target Android 15 (livello API 35) e prima e dopo l'applicazione degli inset.

Cosa controllare se la tua app è già edge-to-edge

Se la tua app è già edge-to-edge e applica i riquadri, nella maggior parte dei casi non hai impatto, ad eccezione dei seguenti scenari. Tuttavia, anche se ritieni di non essere interessato, ti consigliamo di testare la tua app.

• Hai una finestra non mobile, ad esempio un Activity che utilizza SHORT_EDGES, NEVER o DEFAULT anziché LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. Se la tua app si arresta in modo anomalo all'avvio, il problema potrebbe essere dovuto alla schermata di benvenuto. Puoi eseguire l'upgrade della dipendenza della schermata iniziale principale a 1.2.0-alpha01 o una versione successiva oppure impostare window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always.
• Potrebbero essere presenti schermate con traffico inferiore con UI ostruite. Verifica che queste schermate meno visitate non abbiano un'interfaccia utente nascosta. Le schermate con traffico ridotto includono:
  • Schermate di onboarding o di accesso
  • Pagine Impostazioni

Cosa controllare se la tua app non è già edge-to-edge

Se la tua app non è già edge-to-edge, è molto probabile che sia interessata. Oltre agli scenari per le app già a schermo intero, devi considerare quanto segue:

• Se la tua app utilizza i componenti Material 3 ( androidx.compose.material3) in compose, come TopAppBar, BottomAppBar e NavigationBar, è probabile che questi componenti non siano interessati perché gestiscono automaticamente gli inserti.
• Se la tua app utilizza componenti Material 2 ( androidx.compose.material) in Compose, questi componenti non gestiscono automaticamente i riquadri. Tuttavia, puoi accedere agli insert e applicarli manualmente. In androidx.compose.material 1.6.0 e versioni successive, utilizza il parametro windowInsets per applicare manualmente gli inserti per BottomAppBar, TopAppBar, BottomNavigation e NavigationRail. Analogamente, utilizza il parametro contentWindowInsets per Scaffold.
• Se la tua app utilizza viste e Componenti Materiale (com.google.android.material), la maggior parte dei Componenti Materiale basati su viste come BottomNavigationView, BottomAppBar, NavigationRailView o NavigationView gestisce gli inserti e non richiede alcun lavoro aggiuntivo. Tuttavia, devi aggiungere android:fitsSystemWindows="true" se utilizzi AppBarLayout.
• Per i composabili personalizzati, applica gli inserti manualmente come spaziatura interna. Se i contenuti sono all'interno di un Scaffold, puoi utilizzare gli inserti utilizzando i valori di spaziatura Scaffold. In caso contrario, applica il padding utilizzando uno dei parametri WindowInsets.
• Se la tua app utilizza viste e BottomSheet, SideSheet o container personalizzati, applica la spaziatura interna utilizzando ViewCompat.setOnApplyWindowInsetsListener. Per RecyclerView, applica il padding utilizzando questo ascoltatore e aggiungi anche clipToPadding="false".

Cosa controllare se la tua app deve offrire una protezione in background personalizzata

Se la tua app deve offrire una protezione dello sfondo personalizzata per la navigazione con tre pulsanti o la barra di stato, l'app deve posizionare una visualizzazione componibile o dietro la barra di sistema utilizzando WindowInsets.Type#tappableElement() per ottenere l'altezza della barra di navigazione con tre pulsanti o WindowInsets.Type#statusBars.

Risorse edge-to-edge aggiuntive

Consulta le guide sulle visualizzazioni edge-to-edge e sulla composizione edge-to-edge per ulteriori considerazioni sull'applicazione degli inserti.

API deprecate

Le seguenti API sono deprecate, ma non disattivate:

• R.attr#enforceStatusBarContrast
• R.attr#navigationBarColor (per la navigazione con tre pulsanti, con un'alfa dell'80%)
• Window#isStatusBarContrastEnforced
• Window#setNavigationBarColor (per la navigazione con tre pulsanti, con alpha al 80%)
• Window#setStatusBarContrastEnforced

Le seguenti API sono obsolete e disabilitate:

• R.attr#navigationBarColor (per la navigazione tramite gesti)
• R.attr#navigationBarDividerColor
• R.attr#statusBarColor
• Window#setDecorFitsSystemWindows
• Window#getNavigationBarColor
• Window#getNavigationBarDividerColor
• Window#getStatusBarColor
• Window#setNavigationBarColor (per la navigazione tramite gesti)
• Window#setNavigationBarDividerColor
• Window#setStatusBarColor

Configurazione stabile

Se la tua app ha come target Android 15 (livello API 35) o versioni successive, Configuration non esclude più le barre di sistema. Se utilizzi le dimensioni dello schermo nella classe Configuration per il calcolo del layout, devi sostituirle con migliori alternative, ad esempio ViewGroup, WindowInsets o WindowMetricsCalculator appropriati, a seconda delle tue esigenze.

Configuration è disponibile dall'API 1. In genere viene ottenuta da Activity.onConfigurationChanged. Fornisce informazioni come densità, orientamento e dimensioni delle finestre. Una caratteristica importante delle dimensioni della finestra riportate da Configuration è che in precedenza escludevano le barre di sistema.

Le dimensioni della configurazione vengono in genere utilizzate per la selezione delle risorse, ad esempio/res/layout-h500dp, e questo è ancora un caso d'uso valido. Tuttavia, l'utilizzo per il calcolo del layout è sempre stato sconsigliato. Se lo fai, ora dovresti allontanarti. Dovresti sostituire l'uso di Configuration con qualcosa di più adatto in base al tuo caso d'uso.

Se lo utilizzi per calcolare il layout, utilizza un ViewGroup appropriato, ad esempio CoordinatorLayout o ConstraintLayout. Se la utilizzi per determinare l'altezza della barra di navigazione del sistema, utilizza WindowInsets. Se vuoi conoscere le dimensioni attuali della finestra dell'app, utilizza computeCurrentWindowMetrics.

Il seguente elenco descrive i campi interessati da questa modifica:

• Le dimensioni Configuration.screenWidthDp e screenHeightDp non escludono più le barre di sistema.
• Configuration.smallestScreenWidthDp è indirettamente interessato dalle modifiche apportate a screenWidthDp e screenHeightDp.
• Configuration.orientation è indirettamente interessato dalle modifiche a screenWidthDp e screenHeightDp sui dispositivi quasi quadrati.
• Display.getSize(Point) è indirettamente interessato dalle modifiche in Configuration. Questo valore è stato ritirato a partire dal livello API 30.
• Display.getMetrics() ha già funzionato in questo modo dal livello API 33.

Il valore predefinito dell'attributo elegantTextHeight è true

Per le app che hanno come target Android 15, l'attributo elegantTextHeight TextView diventa true per impostazione predefinita, sostituendo il carattere compatto usato per impostazione predefinita con alcuni script che hanno metriche verticali di grandi dimensioni con una molto più leggibile. Il carattere compatto è stato introdotto per evitare interruzioni nei layout. Android 13 (livello API 33) impedisce molte di queste interruzioni consentendo al layout del testo di estendere l'altezza verticale utilizzando l'attributo fallbackLineSpacing.

In Android 15, il carattere compatto rimane ancora nel sistema, pertanto la tua app può impostare elegantTextHeight su false per avere lo stesso comportamento di prima, ma è improbabile che sia supportato nelle prossime release. Pertanto, se la tua app supporta i seguenti script: arabo, laotiano, Myanmar, tamil, gujarati, kannada, malayalam, Odia, telugu o thailandese, testa l'app impostando elegantTextHeight su true.

Modifiche alla larghezza di TextView per forme di lettere complesse

Nelle versioni precedenti di Android, alcuni caratteri corsivi o lingue con forme complesse potrebbero disegnare le lettere nell'area del carattere precedente o successivo. In alcuni casi, queste lettere sono state tagliate all'inizio o alla fine. A partire da Android 15, un TextView assegna una larghezza sufficiente per disegnare queste lettere e consente alle app di richiedere spaziature aggiuntive a sinistra per evitare il ritaglio.

Poiché questa modifica influisce sulla modalità di determinazione della larghezza da parte di TextView, per impostazione predefinita TextView allocate più larghezza se l'app ha come target Android 15 (livello API 35) o versioni successive. Puoi attivare o disattivare questo comportamento chiamando l'API setUseBoundsForWidth su TextView.

Poiché l'aggiunta di spaziatura interna a sinistra potrebbe causare un disallineamento dei layout esistenti, la spaziatura interna non viene aggiunta per impostazione predefinita anche per le app che hanno come target Android 15 o versioni successive. Tuttavia, puoi aggiungere un ulteriore spazio per evitare il ritaglio chiamando setShiftDrawingOffsetForStartOverhang.

Gli esempi riportati di seguito mostrano come queste modifiche possono migliorare il layout del testo per alcuni caratteri e lingue.

Layout standard per il testo inglese con carattere corsivo. Alcune lettere sono tagliate. Ecco il codice XML corrispondente:

<TextView
    android:fontFamily="cursive"
    android:text="java" />

Layout per lo stesso testo in inglese con larghezza e spaziatura interna aggiuntive. Ecco il codice XML corrispondente:

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

Layout standard per il testo thailandese. Alcune lettere sono tagliate. Ecco il codice XML corrispondente:

<TextView
    android:text="คอมพิวเตอร์" />

Layout per lo stesso testo thailandese con larghezza e spaziatura aggiuntivi. Ecco il codice XML corrispondente:

<TextView
    android:text="คอมพิวเตอร์"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

Altezza della riga predefinita basata sulla lingua per EditText

Nelle versioni precedenti di Android, il layout del testo estendeva l'altezza del testo per adattarlo all'altezza della riga del carattere corrispondente alle impostazioni internazionali correnti. Ad esempio, se i contenuti erano in giapponese, poiché l'altezza della riga del carattere giapponese è leggermente più grande di quella di un carattere latino, l'altezza del testo è aumentata leggermente. Tuttavia, nonostante queste differenze di altezza delle righe, le dimensioni dell'elemento EditText sono state uniformi, indipendentemente dall'impostazione internazionale utilizzata, come illustrato nell'immagine seguente:

Per le app che hanno come target Android 15, ora viene riservata un'altezza minima della riga per EditText affinché corrisponda al carattere di riferimento per le impostazioni internazionali specificate, come mostrato nella seguente immagine:

Se necessario, la tua app può ripristinare il comportamento precedente specificando l'attributo useLocalePreferredLineHeightForMinimum su false e la tua app può impostare metriche verticali minime personalizzate utilizzando l'API setMinimumFontMetrics in Kotlin e Java.

Fotocamera e contenuti multimediali

Android 15 apporta le seguenti modifiche al comportamento della fotocamera e dei contenuti multimediali per le app con target Android 15 o versioni successive.

Restrizioni relative alla richiesta dell'attenzione audio

Le app destinate ad Android 15 devono essere quelle di primo livello o avere un servizio in primo piano per poter richiedere lo stato attivo dell'audio. Se un'app tenta di richiedere lo stato attivo quando non soddisfa uno di questi requisiti, la chiamata restituisce AUDIOFOCUS_REQUEST_FAILED.

Puoi scoprire di più sulla messa a fuoco audio su Gestire il focus audio.

Limitazioni non SDK aggiornate

Android 15 include elenchi aggiornati di interfacce non SDK limitate in base alla collaborazione con sviluppatori Android e agli ultimi test interni. Ove possibile, ci assicuriamo che siano disponibili alternative pubbliche prima di applicare limitazioni alle interfacce non SDK.

Se la tua app non ha come target Android 15, alcune di queste modifiche potrebbero non riguardarti immediatamente. Tuttavia, anche se è possibile per la tua app accedere ad alcune interfacce non SDK a seconda del livello API target dell'app, l'utilizzo di qualsiasi metodo o campo non SDK comporta sempre un rischio elevato di interrompere l'app.

Se non sai con certezza se la tua app utilizza interfacce non SDK, puoi testarla per scoprirlo. Se la tua app si basa su interfacce non SDK, devi iniziare a pianificare una migrazione alle alternative SDK. Tuttavia, siamo consapevoli che alcune app hanno casi d'uso validi per l'utilizzo di interfacce non SDK. Se non riesci a trovare un'alternativa all'utilizzo di un'interfaccia non SDK per una funzionalità nella tua app, devi richiedere una nuova API pubblica.

Per scoprire di più sulle modifiche in questa release di Android, consulta Aggiornamenti alle limitazioni relative alle interfacce non SDK in Android 15. Per saperne di più sulle interfacce non SDK in generale, consulta Limitazioni relative alle interfacce non SDK.