Ibernazione dell'app

Se la tua app ha come target Android 11 (livello API 30) o versioni successive e l'utente non interagisce con la tua app per alcuni mesi, il sistema la mette in stato di ibernazione. Il sistema esegue l'ottimizzazione per lo spazio di archiviazione invece che per delle prestazioni e il sistema protegge i dati degli utenti. Questo comportamento del sistema è simile a quello che si verifica quando l'utente arresta forzatamente la tua app dalle impostazioni di sistema.

Effetti dell'ibernazione

Come mostrato nella tabella 1, gli effetti della modalità di sospensione dipendono dalla versione dell'SDK target della tua app, nonché dal dispositivo su cui è in esecuzione:

Tabella 1. Effetti della ibernazione sull'app

Versione SDK target	Caratteristiche del dispositivo	Effetti della sospensione
Android 12 o versioni successive	Eseguire Android 12 o versioni successive	Il runtime dell'app autorizzazioni. Questa azione ha lo stesso effetto che se l'utente ha visualizzato un'autorizzazione nelle impostazioni di sistema e modificato il livello di accesso dell'app su Rifiuta. La tua app non può eseguire job o avvisi in background. La tua app non può ricevere notifiche push, inclusi i messaggi con priorità elevata inviati tramite Firebase Cloud Messaging. Qualsiasi file nel tuo dell'app cache vengono rimosse.
Android 11	Funziona su Android 11	Le autorizzazioni di runtime dell'app sono state reimpostate.
Android 11	Esegue Android 6.0 (livello API 23) ad Android 10 (livello API 29), inclusive, ed è basata su Google Play Services	Le autorizzazioni di runtime dell'app sono state reimpostate. Questo comportamento entrerà in vigore a dicembre 2021. Scopri di più in questo blog pubblica su relativa la reimpostazione automatica delle autorizzazioni è disponibile per miliardi di altri dispositivi.

Comportamento del sistema quando un'app esce dalla modalità di sospensione

Quando l'utente interagisce di nuovo con l'app, questa esce dalla modalità di sospensione e può creare nuovamente job, avvisi e notifiche.

Tuttavia, il sistema non esegue le seguenti operazioni per la tua app:

1. Concedi di nuovo le autorizzazioni di runtime dell'app.

   L'utente deve concedere nuovamente queste autorizzazioni per la tua app.

2. Riprogramma eventuali lavori, avvisi e notifiche pianificati in precedenza la tua app è in ibernazione.

   Per supportare più facilmente questo flusso di lavoro, utilizza WorkManager. Puoi anche aggiungere la logica di riprogrammazione nel broadcast receiver ACTION_BOOT_COMPLETED, che viene richiamato quando l'app esce dalla modalità di sospensione e dopo l'avvio del dispositivo.

Utilizzo di app

Le seguenti sezioni forniscono esempi di utilizzo delle app ed esempi di azioni che il sistema non considera come utilizzo dell'app.

Esempi di utilizzo delle app

Quando un'attività nella tua app viene ripresa, il sistema considera questo evento come un'interazione utente. Pertanto, il sistema estende il periodo di tempo che deve trascorrere prima che la tua app entri in ibernazione.

Su Android 11 e versioni successive, vengono inoltre rilevati i seguenti comportamenti considerate interazioni dell'utente:

• L'utente interagisce con un widget.

• L'utente interagisce con una notifica, ad eccezione della chiusura della notifica.

  Nota: se l'utente ignora la notifica e non interagisce con essa, l'utilizzo dell'app non viene conteggiato.

Tieni presente che l'uso delle app per la ibernazione non richiede esplicitamente interazione dell'utente. Finché un componente del pacchetto viene richiamato, rimane considerato l'utilizzo dell'app. Ecco alcuni esempi:

• App che hanno un fornitore di servizi o contenuti vincolato da un'altra app sul dispositivo o sul sistema operativo. Ad esempio, Input Method Editor (IME) o gestori delle password.

• I ricevitori di trasmissione nel pacchetto che ricevono una trasmissione esplicita da un pacchetto esterno.

  Nota: sono esclusi gli utilizzi che non si verificherebbero se l'app viene interrotta forzatamente. Ad esempio, l'esecuzione di un job non viene conteggiata come utilizzo anche se viene invocato il componente del servizio job.

Non esempi

Se la tua app presenta soltanto i comportamenti descritti nel seguente elenco: la tua app entra in ibernazione dopo alcuni mesi:

• Esegue un job pianificato utilizzando JobScheduler
• Riceve un annuncio implicito.
• Programma le sveglie.

Esenzioni dal letargo del sistema

Android concede esenzioni a livello di sistema dal ibernazione delle app in determinati casi d'uso. Se la tua app rientra in una delle seguenti categorie, è esente dagli standard di utilizzo delle app e non va in ibernazione.

App non visualizzate in Avvio app

Qualsiasi app che non ha un riquadro di scorciatoia attivo nel programma di avvio.

App del profilo di lavoro

Qualsiasi app installata da un utente in un profilo di lavoro. Tieni presente che se la stessa app è presente anche in un profilo personale, solo lo spazio di lavoro dell'app del profilo è esente.

Controller dei criteri dei dispositivi

App che controllano i criteri dei dispositivi locali e le applicazioni di sistema sui dispositivi.

App con privilegi dell'operatore

Qualsiasi app che gli operatori di telefonia mobile precaricano sui dispositivi e che ritengano necessarie per obbligazioni contrattuali per i servizi, come le app di segreteria o assistenza clienti.

App di installazione di terze parti

Store di terze parti per aggiornamenti automatici delle app installate app quando necessario.

Esenzioni dall'ibernazione per gli utenti

Se prevedi che un caso d'uso principale nella tua app sia interessato dalla ibernazione, puoi richiedere all'utente un'esenzione dalla sospensione delle app. Questa esenzione è utile per le situazioni in cui l'utente si aspetta che la tua app funzioni principalmente in background, anche senza che l'utente interagisca con l'app, ad esempio quando la tua app esegue una delle seguenti operazioni:

• Garantire la sicurezza della famiglia segnalando periodicamente la posizione dei familiari.
• Sincronizza i dati tra un dispositivo e il server dell'app.
• Comunicare con gli smart device, ad esempio una TV.
• Accoppiamento con dispositivi complementari, ad esempio uno smartwatch.

Nota: se la tua app è un controllore dei criteri relativi ai dispositivi che implementa DeviceAdminService, viene eseguita in modalità di funzionamento come proprietario del dispositivo o del profilo o è un'app con privilegi dell'operatore, il sistema non la mette mai in uno stato di ibernazione.

Per richiedere un'esenzione, completa i passaggi descritti nelle sezioni seguenti.

Controlla se l'utente ha già disattivato la modalità di sospensione per la tua app

Per verificare se l'utente ha già disattivato la modalità di sospensione per la tua app, utilizza l'API getUnusedAppRestrictionsStatus().

Per ulteriori dettagli su come utilizzare questa API nella tua app, consulta l'esempio di codice dell'API in questa pagina.

Chiedi all'utente di disattivare la modalità di sospensione per la tua app

Se l'utente non ha già disattivato la modalità di ibernazione per la tua app, puoi inviare un richiesta all'utente. Per farlo, segui questi passaggi:

1. Visualizza una UI che spieghi all'utente perché deve disattivarla di ibernazione per la tua app.

2. Richiama l'API createManageUnusedAppRestrictionsIntent(), come mostrato nell'esempio di codice API. Questa API crea un intent che carica la schermata Informazioni app nelle Impostazioni. Da qui, l'utente può disattivare la modalità di ibernazione per la tua app.

   È importante chiamare startActivityForResult(), non startActivity(), quando invii questo intent.

   Come mostrato nella tabella 2, la posizione e il nome dell'opzione dipendono dalle caratteristiche del dispositivo su cui è installata l'app:

   Tabella 2. Opzione che disattiva l'ibernazione per il tuo dell'app

   Caratteristiche del dispositivo	Pagina in cui viene visualizzata l'opzione	Nome dell'opzione da disattivare
   Android 13 o versioni successive	Informazioni delle app	Sospendi attività app se inutilizzata
   Con Android 12	Informazioni delle app	Rimuovi autorizzazioni e libera spazio
   Con Android 11	Informazioni sull'app > Autorizzazioni	Rimuovere le autorizzazioni se l'app non viene utilizzata
   Esegui Android 6.0 e versioni successive, inclusive, ed è basato su Google Play Services	App Google Play > Menu > Play Protect > Autorizzazioni per App	Rimuovere le autorizzazioni se l'app non viene utilizzata

Esempio di codice API

Questo esempio di codice mostra come verificare se la modalità di sospensione è attivata per la tua app e il modo corretto per chiedere agli utenti di disattivarla.

Nota: questa API può essere utilizzata su un dispositivo con qualsiasi versione di Android, ma fornisce informazioni per la tua app solo se questa ha come target Android 11 o versioni successive.

Kotlin

val future: ListenableFuture<Int> =
    PackageManagerCompat.getUnusedAppRestrictionsStatus(context)
future.addListener({ onResult(future.get()) }, ContextCompat.getMainExecutor(context))

fun onResult(appRestrictionsStatus: Int) {
  when (appRestrictionsStatus) {
    // Couldn't fetch status. Check logs for details.
    ERROR -> { }

    // Restrictions don't apply to your app on this device.
    FEATURE_NOT_AVAILABLE -> { }

    // The user has disabled restrictions for your app.
    DISABLED -> { }

    // If the user doesn't start your app for a few months, the system will
    // place restrictions on it. See the API_* constants for details.
    API_30_BACKPORT, API_30, API_31 -> handleRestrictions(appRestrictionsStatus)
  }
}

fun handleRestrictions(appRestrictionsStatus: Int) {
  // If your app works primarily in the background, you can ask the user
  // to disable these restrictions. Check if you have already asked the
  // user to disable these restrictions. If not, you can show a message to
  // the user explaining why permission auto-reset or app hibernation should be
  // disabled. Then, redirect the user to the page in system settings where they
  // can disable the feature.
  val intent = IntentCompat.createManageUnusedAppRestrictionsIntent(context, packageName)

  // You must use startActivityForResult(), not startActivity(), even if
  // you don't use the result code returned in onActivityResult().
  startActivityForResult(intent, REQUEST_CODE)
}

API della piattaforma precedente

Il sistema operativo include anche un'API per interagire con la funzionalità di ibernazione. Tuttavia, l'API funziona solo su dispositivi con Android 11 o versioni successive; l'API non gestisce le funzionalità di ibernazione che vengono riportate alle versioni precedenti di Android. Pertanto, sconsigliamo di utilizzare l'API.

Se devi continuare a utilizzare temporaneamente l'API per motivi di compatibilità, l'elenco seguente mostra come utilizzarla:

• Per controllare se la modalità di ibernazione è disattivata per la tua app: isAutoRevokeWhitelisted()
• Per inviare l'utente alla pagina delle impostazioni di ibernazione: crea un'intenzione utilizzando ACTION_APPLICATION_DETAILS_SETTINGS

Invocare manualmente il comportamento di ibernazione

Nota: se testi la tua app su un dispositivo con Android 11, puoi saltare diversi passaggi di questa sezione. Questi passaggi sono etichettati come "Android 12 e solo superiore".

Per testare il comportamento della tua app dopo che il sistema la mette in stato di ibernazione completa i seguenti passaggi:

1. (Solo Android 12 e versioni successive) Attiva il comportamento di ibernazione sul tuo dispositivo:

   adb shell device_config put app_hibernation app_hibernation_enabled true
   

2. Imposta il periodo di tempo predefinito che il sistema attende per entrare in modalità di sospensione. In questo modo, potrai ripristinarlo dopo aver eseguito il test:

   threshold=$(adb shell device_config get permissions \
     auto_revoke_unused_threshold_millis2)
   

3. Riduci il tempo di attesa del sistema. Nell'esempio seguente, il sistema viene modificato in modo che la tua app entri in ibernazione solo per un secondo Quando smetti di interagire con l'app:

   adb shell device_config put permissions \
     auto_revoke_unused_threshold_millis2 1000
   

4. Attendi il completamento delle trasmissioni all'avvio sul dispositivo di test eseguendo il seguente comando:

   adb shell am wait-for-broadcast-idle
   

   Al termine delle trasmissioni, questo comando restituisce il messaggio: All broadcast queues are idle!

5. Richiama manualmente la procedura di ibernazione dell'app:

   adb shell cmd jobscheduler run -u 0 -f \
     com.google.android.permissioncontroller 2
   

6. (Solo Android 12 e versioni successive) Verificare che l'app sia in ibernazione, utilizzandone una uno dei seguenti metodi:

   • Nota che ora il dispositivo di test mostra una notifica che indica che le app non utilizzate sono in modalità di sospensione.

   • Esegui il seguente comando:

     adb shell cmd app_hibernation get-state PACKAGE-NAME
     

7. Ripristina la durata predefinita che il sistema attende prima di mettere la tua app in modalità di sospensione:

   adb shell device_config put permissions \
     auto_revoke_unused_threshold_millis2 $threshold