Modifiche al comportamento: tutte le app

La piattaforma Android 13 include modifiche al comportamento che potrebbero influire sulla tua app. Le seguenti modifiche al comportamento si applicano a tutte le app quando vengono eseguite su Android 13, indipendentemente da targetSdkVersion. Dovresti testare la tua app e poi modificarla in base alle esigenze per supportare correttamente queste modifiche, se applicabili.

Assicurati di esaminare anche l'elenco delle modifiche al comportamento che interessano solo le app che hanno come target Android 13.

Prestazioni e batteria

Task Manager

Nella parte inferiore del riquadro delle notifiche è presente un pulsante che indica il numero di app attualmente in esecuzione in background. Quando premi questo pulsante, viene visualizzata una finestra di dialogo con l'elenco dei nomi di diverse app. Il pulsante Interrompi si trova a destra di ogni app
Figura 1. Flusso di lavoro per Task Manager , che consente agli utenti di interrompere le app con servizi in primo piano in corso. Questo flusso di lavoro viene visualizzato solo sui dispositivi con Android 13 o versioni successive.

A partire da Android 13 (livello API 33), gli utenti possono completare un workflow dal riquadro delle notifiche per interrompere le app con servizi in primo piano in corso, come mostrato nella Figura 1. Questa funzionalità è nota come Task Manager. Le app devono essere in grado di gestire questa interruzione avviata dall'utente.

Migliorare la gestione dei job di precaricamento utilizzando JobScheduler

JobScheduler consente alle app di contrassegnare job specifici come job di "precaricamento" (utilizzando JobInfo.Builder.setPrefetch()), il che significa che idealmente dovrebbero essere eseguiti in prossimità e prima del successivo avvio dell'app per migliorare l'esperienza utente. In passato, JobScheduler utilizzava solo l'indicatore per consentire ai job di precaricamento di utilizzare in modo opportunistico i dati senza costi o in eccesso.

In Android 13 (livello API 33) e versioni successive, il sistema tenta di determinare la prossima volta che un'app verrà avviata e utilizza questa stima per eseguire i job di precaricamento. Le app devono provare a utilizzare i job di precaricamento per qualsiasi lavoro che vogliono eseguire prima del successivo avvio dell'app.

Utilizzo delle risorse della batteria

Android 13 (livello API 33) offre i seguenti modi per consentire al sistema di gestire meglio la durata della batteria del dispositivo:

  • Regole aggiornate su quando il sistema inserisce l'app nel bucket di standby delle app "limitato" .
  • Nuove limitazioni al lavoro che l'app può svolgere quando l'utente la mette nello "stato limitato" per l'utilizzo della batteria in background.

Quando testi l'app con queste modifiche, assicurati di controllare quanto segue:

  • Verifica la risposta dell'app quando il sistema la inserisce nel bucket di standby delle app "limitato" . Utilizza il seguente comando Android Debug Bridge (ADB) per assegnare l'app a questo bucket:

    adb shell am set-standby-bucket PACKAGE_NAME restricted

  • Verifica la risposta dell'app alle seguenti limitazioni che in genere si applicano alle app in stato "limitato" per l'utilizzo della batteria in background:

    • Impossibile avviare i servizi in primo piano
    • I servizi in primo piano esistenti vengono rimossi dal primo piano
    • Le sveglie non vengono attivate
    • I job non vengono eseguiti

    Utilizza il seguente comando ADB per mettere l'app in questo stato "limitato":

    adb shell cmd appops set PACKAGE_NAME RUN_ANY_IN_BACKGROUND ignore

Quote di Firebase Cloud Messaging (FCM) con priorità elevata

Android 13 (livello API 33) aggiorna Firebase Cloud Messaging (FCM) quote per migliorare l'affidabilità della consegna di FCM con priorità elevata per le app che mostrano notifiche in risposta a FCM con priorità elevata. In Android 13 (livello API 33) sono state apportate le seguenti modifiche:

  • I bucket di standby delle app non determinano più il numero di FCM con priorità elevata che un'app può utilizzare.
  • Il sistema ora esegue il downgrade dei messaggi con priorità elevata se rileva che un'app invia costantemente messaggi con priorità elevata che non generano una notifica.

Come nelle versioni precedenti di Android, i FCM con priorità elevata che superano la quota vengono sottoposti a downgrade alla priorità normale. Quando avvii Servizi in primo piano (FGS) in risposta a un FCM, ti consigliamo di controllare il risultato di RemoteMessage.getPriority() e di verificare che sia PRIORITY_HIGH e/o di gestire eventuali eccezioni ForegroundServiceStartNotAllowedException.

Se la tua applicazione non pubblica sempre notifiche in risposta a FCM con priorità elevata, ti consigliamo di modificare la priorità di questi FCM in normale in modo che i messaggi che generano una notifica non vengano sottoposti a downgrade.

Privacy

Autorizzazione di runtime per le notifiche

Android 13 (livello API 33) introduce un'autorizzazione di runtime per le notifiche: POST_NOTIFICATIONS. Questa modifica aiuta gli utenti a concentrarsi sulle notifiche più importanti per loro.

Ti consigliamo vivamente di avere come target Android 13 o versioni successive il prima possibile per sfruttare il controllo e la flessibilità aggiuntivi di questa funzionalità.

Scopri di più sulle best practice per le autorizzazioni app.

Nascondere i contenuti sensibili dagli appunti

Se la tua app consente agli utenti di copiare contenuti sensibili, come password o informazioni sulla carta di credito, negli appunti, devi aggiungere un flag a ClipDescription di ClipData prima di chiamare ClipboardManager#setPrimaryClip(). L'aggiunta di questo flag impedisce la visualizzazione di contenuti sensibili nell'anteprima dei contenuti.

Anteprima del testo copiato senza segnalazione di contenuti sensibili
Anteprima del testo copiato senza contrassegnare i contenuti sensibili.
Anteprima del testo copiato che segnala contenuti sensibili.
Anteprima del testo copiato con i contenuti sensibili contrassegnati.

Per contrassegnare i contenuti sensibili, aggiungi un extra booleano a ClipDescription. Tutte le app devono farlo, indipendentemente dal livello API di destinazione.


// When your app is compiled with the API level 33 SDK or higher
clipData.apply {
    description.extras = PersistableBundle().apply {
        putBoolean(ClipDescription.EXTRA_IS_SENSITIVE, true)
    }
}

// If your app is compiled with a lower SDK
clipData.apply {
    description.extras = PersistableBundle().apply {
        putBoolean("android.content.extra.IS_SENSITIVE", true)
    }
}

Per scoprire di più sulla nuova UI degli appunti, visita la pagina della funzionalità Copia e incolla.

Sicurezza

Eseguire la migrazione dallo User ID condiviso

Se la tua app utilizza l'attributo ritirato android:sharedUserId e non dipende più dalla funzionalità dell'attributo, puoi impostare l'attributo android:sharedUserMaxSdkVersion su 32, come mostrato nel seguente snippet di codice:

<manifest ...>
    <!-- To maintain backward compatibility, continue to use
         "android:sharedUserId" if you already added it to your manifest. -->
    android:sharedUserId="SHARED_PACKAGE_NAME"
    android:sharedUserMaxSdkVersion="32"
    ...
</manifest>

Questo attributo indica al sistema che la tua app non si basa più su uno User ID condiviso. Se la tua app dichiara android:sharedUserMaxSdkVersion ed è stata installata di recente su dispositivi con Android 13 o versioni successive, si comporta come se non avessi mai definito android:sharedUserId. Le app aggiornate utilizzano ancora lo User ID condiviso esistente.

Gli User ID condivisi causano un comportamento non deterministico all'interno del gestore di pacchetti. La tua app deve invece utilizzare meccanismi di comunicazione appropriati, come servizi e content provider, per facilitare l'interoperabilità tra i componenti condivisi.

Esperienza utente

Notifiche dei servizi in primo piano ignorabili

Sui dispositivi con Android 13 o versioni successive, gli utenti possono ignorare le notifiche associate ai servizi in primo piano per impostazione predefinita.

Funzionalità di base

Copia legacy dell'implementazione del servizio vocale rimossa

Android 13 rimuove l'implementazione SpeechService—inclusi Voice IME, RecognitionService e un'API basata su intent—dall' app Google.

In Android 12 sono state apportate le seguenti modifiche:

  • Le funzionalità di SpeechService sono state migrate all'app Servizi vocali di Google, che è diventata il provider SpeechService predefinito.
  • La funzionalità RecognitionService è stata spostata nell'app Android System Intelligence per supportare il riconoscimento vocale sul dispositivo.

Per contribuire a mantenere la compatibilità delle app su Android 12, l'app Google utilizza un trampoline per reindirizzare il traffico all'app Servizi vocali di Google. In Android 13, questo trampoline viene rimosso.

Le app devono utilizzare il provider predefinito del dispositivo per SpeechService, anziché codificare un'app specifica.