Modifiche al framework di compatibilità (Android 11)

Questa pagina descrive ogni modifica al comportamento che influisce sulle app aggiunta al framework di compatibilità in Android 11 (livello API 30). Utilizza questo elenco insieme alle opzioni sviluppatore e ai comandi ADB per testare ed eseguire il debug della tua app mentre ti prepari a scegliere Android 11 come target.

ADD_CONTENT_OBSERVER_FLAGS

ID modifica: 150939131

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per le app destinate ad Android 11, è disponibile un nuovo overload dell'API pubblica onChange(boolean, Uri, int) che include un argomento intero flags.

Questo nuovo metodo è un'alternativa all'SDK pubblico per le app che utilizzano il metodo sovraccaricato non SDK onChange() che include un argomento userId intero.

ADMIN_APP_PASSWORD_COMPLEXITY

ID modifica: 123562444

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per le app per amministratori che hanno come target Android 11, genera un errore ogni volta che un'app imposta un requisito per la password non pertinente alla qualità della password attualmente assegnata. Ad esempio, quando la qualità della password è impostata su DevicePolicyManager.PASSWORD_QUALITY_UNSPECIFIED, un'app non può impostare una lunghezza minima della password. In questo caso, prima di provare a impostare la lunghezza minima della password, l'app deve prima chiamare il metodo setPasswordQuality() e solo successivamente il metodo setPasswordMinimumLength().

Inoltre, quando un'app per amministratori che ha come target Android 11 riduce la qualità della password, tutti i requisiti esistenti per la password che non sono più applicabili vengono reimpostati sui valori predefiniti.

APP_DATA_DIRECTORY_ISOLATION

ID modifica: 143937733

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Le app che hanno come target Android 11 non possono più accedere ai file nelle directory di dati privati di qualsiasi app, indipendentemente dalla versione dell'SDK target dell'altra app.

Per saperne di più, consulta Accesso alle directory private.

APN_READING_PERMISSION_CHANGE_ID

ID modifica: 124107808

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per le app che hanno come target Android 11, l'accesso al database APN ora richiede l'autorizzazione Manifest.permission.WRITE_APN_SETTINGS.

Per scoprire di più su questa modifica, consulta Accesso in lettura limitato al database APN.

BACKGROUND_RATIONALE_CHANGE_ID

ID modifica: 147316723

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Ora le app devono fornire una motivazione valida ogni volta che richiedono l'accesso alla posizione del dispositivo in background.

Per scoprire di più su questa modifica, consulta la guida su come accedere alla posizione in background in Android 11, che illustra le modifiche alla privacy relative alla posizione in Android 11.

CALLBACK_ON_CLEAR_CHANGE

ID modifica: 119147584

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Ogni volta che viene chiamato Editor.clear, viene eseguito un callback a OnSharedPreferenceChangeListener.onSharedPreferenceChanged con una chiave null.

Per scoprire di più su questa modifica, consulta Modifiche ai callback per OnSharedPreferenceChangeListener.

CALLBACK_ON_MORE_ERROR_CODE_CHANGE

ID modifica: 130595455

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

I codici di errore sono ora espansi per updateAvailableNetworks(List, Executor, Consumer) e setPreferredOpportunisticDataSubscription(int, boolean, Executor, Consumer).

CALL_BACK_ON_CHANGED_LISTENER_WITH_SWITCHED_OP_CHANGE

ID modifica: 148180766

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Si tratta di una leggera modifica del comportamento di startWatchingMode(String, String, AppOpsManager.OnOpChangedListener). Prima di questa modifica, il sistema richiamava l'operazione scambiata. Dopo la modifica, il sistema richiamerà l'operazione effettivamente richiesta o tutte le operazioni scambiate se non viene specificata alcuna operazione.

CAMERA_MICROPHONE_CAPABILITY_CHANGE_ID

ID modifica: 136219221

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per le app che hanno come target Android 11, i servizi in primo piano ricevono le funzionalità di utilizzo della fotocamera e del microfono solo quando R.attr.foregroundServiceType è configurato come ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA e ServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE rispettivamente nel file manifest. Nelle versioni precedenti di Android, i servizi in primo piano ricevevano automaticamente le funzionalità di fotocamera e microfono.

Per scoprire di più su questa modifica, consulta Tipi di servizi in primo piano in Android 11.

CHANGE_BACKGROUND_CUSTOM_TOAST_BLOCK

ID modifica: 128611929

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Le app non possono più pubblicare toast personalizzati in background. Tuttavia, le app possono comunque pubblicare toast utilizzando il metodo Toast.makeText(Context, CharSequence, int) e le relative varianti mentre sono in background.

Per scoprire di più su questa modifica, consulta Le visualizzazioni di toast personalizzate sono bloccate.

CHANGE_RESTRICT_SAW_INTENT

ID modifica: 135920175

Stato predefinito: questa modifica non può essere attivata/disattivata. Viene registrato solo dal framework di compatibilità.

Gli intent che utilizzano l'azione android.settings.MANAGE_APP_OVERLAY_PERMISSION e lo schema URI dei dati package non indirizzano più l'utente a una schermata specifica dell'app per la gestione dell'autorizzazione associata. L'utente viene invece indirizzato a una schermata in cui può gestire tutte le app che hanno richiesto l'autorizzazione.

CHANGE_TEXT_TOASTS_IN_THE_SYSTEM

ID modifica: 147798919

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

I toast di testo ora vengono visualizzati dalla SystemUI anziché in-app. In questo modo, le app non possono aggirare le limitazioni relative alla pubblicazione di toast personalizzati in background.

DEFAULT_SCOPED_STORAGE

ID modifica: 149924527

Stato predefinito: attivato per tutte le app.

Tutte le app che hanno come target Android 11 ora utilizzano l'archiviazione mirata per impostazione predefinita e non possono più disattivarla.

Tuttavia, puoi testare la tua app senza l'archiviazione mirata, indipendentemente dalla versione dell'SDK target dell'app e dai valori dei flag del manifest, disattivando questa modifica.

Per scoprire di più sulle modifiche all'archiviazione mirata in Android 11, consulta la sezione Archiviazione mirata nella pagina relativa alle modifiche allo spazio di archiviazione di Android in Android 11.

EMPTY_INTENT_ACTION_CATEGORY

ID modifica: 151163173

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per le app che hanno come target Android 11, il sistema ora genera un errore se action o category di un filtro per intent è una stringa vuota. Un bug nella piattaforma prima di Android 11 consentiva di superare questo caso senza generare un errore. Tieni presente che questo non include i casi in cui l'attributo è nullo o mancante, poiché ciò ha sempre generato un errore.

FILTER_APPLICATION_QUERY

ID modifica: 135549675

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Ora le app devono dichiarare i pacchetti e gli intent che intendono utilizzare prima di poter ottenere dettagli su altre app su un dispositivo. Queste dichiarazioni devono essere effettuate utilizzando il tag <queries> nel manifest dell'app.

Per scoprire di più su come eseguire query e interagire con altre app installate in Android 11, consulta la pagina sulla privacy relativa alla visibilità dei pacchetti.

FORCE_ENABLE_SCOPED_STORAGE

ID modifica: valore: 132649864

Stato predefinito: disattivato per tutte le app.

Tutte le app che hanno come target Android 11 ora utilizzano l'archiviazione mirata per impostazione predefinita e non possono più disattivarla.

Tuttavia, se la tua app ha ancora come target Android 10 (livello API 29) o versioni precedenti, puoi testarla con l'archiviazione mirata, indipendentemente dalla versione dell'SDK target dell'app e dai valori dei flag del manifest, attivando questa modifica.

Per scoprire di più sulle modifiche all'archiviazione mirata in Android 11, consulta la sezione Archiviazione mirata nella pagina relativa alle modifiche allo spazio di archiviazione di Android in Android 11.

GET_DATA_CONNECTION_STATE_R_VERSION

ID modifica: 148535736

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per controllare la versione dell'SDK per PreciseDataConnectionState#getDataConnectionState.

GET_DATA_STATE_R_VERSION

ID modifica: 148534348

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per controllare la versione dell'SDK per getDataState().

GET_PROVIDER_SECURITY_EXCEPTIONS

ID modifica: 150935354

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per le app che hanno come target Android 11 (livello API 30) o versioni successive, getProvider(String) non genera più eccezioni di sicurezza.

GET_TARGET_SDK_VERSION_CODE_CHANGE

ID modifica: 145147528

Stato predefinito: attivato per le app che hanno come target Android 10 (livello API 29) o versioni successive.

Per controllare la versione dell'SDK per il metodo SmsManager.sendResolverResult().

GWP_ASAN

ID modifica: 135634846

Stato predefinito: disattivato per tutte le app.

Consente il rilevamento di bug della memoria nativa campionata nelle app.

Per scoprire di più su questa modifica, consulta la guida di GWP-ASan.

HIDE_MAXTARGETSDK_P_HIDDEN_APIS

ID modifica: 149997251

Stato predefinito: attivato per le app che hanno come target Android 10 (livello API 29) o versioni successive.

Per le app che hanno come target Android 10 (livello API 29) o versioni successive, rimuove l'accesso a tutte le interfacce non SDK che fanno parte dell'elenco max-target-p (greylist-max-p) per Android 10 (livello API 29).

HIDE_MAXTARGETSDK_Q_HIDDEN_APIS

ID modifica: 149994052

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per le app che hanno come target Android 11 (livello API 30) o versioni successive, rimuove l'accesso a tutte le interfacce non SDK che fanno parte dell'elenco max-target-q (greylist-max-q) per Android 11 (livello API 30).

Per saperne di più su questa modifica, consulta la sezione sulle interfacce non SDK ora bloccate in Android 11.

LISTEN_CODE_CHANGE

ID modifica: 147600208

Stato predefinito: attivato per le app che hanno come target Android 10 (livello API 29) o versioni successive.

Per controllare la versione dell'SDK per TelephonyManager.listen(PhoneStateListener, int).

MISSING_APP_TAG

ID modifica: 150776642

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per le app che hanno come target Android 11, ora viene generato un errore quando nel file manifest di un'app manca un tag application o instrumentation.

NATIVE_HEAP_POINTER_TAGGING

ID modifica: 135754954

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per le app che hanno come target Android 11, le allocazioni heap native ora hanno un tag diverso da zero nel byte più significativo.

Per saperne di più, consulta Tagging dei puntatori heap.

PHONE_STATE_LISTENER_LIMIT_CHANGE_ID

ID modifica: 150880553

Stato predefinito: attivato per tutte le app.

Per le app che hanno come target Android 11, ora esiste un limite al numero di oggetti PhoneStateListener che qualsiasi processo può registrare tramite TelephonyManager.listen(PhoneStateListener, int). Il limite predefinito è 50, ma può essere modificato tramite gli aggiornamenti della configurazione del dispositivo remoto. Questo limite viene applicato utilizzando un'eccezione IllegalStateException generata da TelephonyManager.listen(PhoneStateListener, int) quando il processo incriminato tenta di registrare un listener di troppo.

PREVENT_META_REFLECTION_BLACKLIST_ACCESS

ID modifica: 142365358

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Le app che hanno come target Android 11 non possono più utilizzare un livello aggiuntivo di reflection per accedere alle interfacce non SDK con limitazioni.

PROCESS_CAPABILITY_CHANGE_ID

ID modifica: 136274596

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per le app che hanno come target Android 11, il flag Context.BIND_INCLUDE_CAPABILITIES ora può essere utilizzato per passare le funzionalità durante l'uso dal processo client a un servizio associato.

REMOVE_ANDROID_TEST_BASE

ID modifica: 133396946

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per le app che hanno come target Android 11, la libreria android.test.base è stata rimossa se l'app non dipende da android.test.runner (poiché dipende dalle classi della libreria android.test.base).

REQUEST_ACCESSIBILITY_BUTTON_CHANGE

ID modifica: 136293963

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Per i servizi di accessibilità che hanno come target Android 11, ora il flag FLAG_REQUEST_ACCESSIBILITY_BUTTON deve essere specificato nel file di metadati del servizio di accessibilità. In caso contrario, il flag viene ignorato.

Per scoprire di più su questa modifica, consulta Dichiara l'utilizzo del pulsante Accessibilità nel file di metadati.

RESOURCES_ARSC_COMPRESSED

ID modifica: 132742131

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Le app che hanno come target Android 11 (livello API 30) non possono essere installate se contengono un file resources.arsc compresso o se questo file non è allineato su un limite di 4 byte.

Per scoprire di più su questa modifica, consulta File di risorse compressi.

RESTRICT_STORAGE_ACCESS_FRAMEWORK

ID modifica: 141600225

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Se la tua app ha come target Android 11 e utilizza Storage Access Framework (SAF), non puoi più accedere a determinate directory utilizzando le azioni di intent ACTION_OPEN_DOCUMENT e ACTION_OPEN_DOCUMENT_TREE. Per scoprire di più su queste modifiche, consulta la sezione Limitazioni di accesso ai documenti nella pagina che illustra gli aggiornamenti della privacy relativi allo spazio di archiviazione in Android 11.

SELINUX_LATEST_CHANGES

ID modifica: 143539591

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Questa modifica limita l'accesso delle app al dominio SELinux untrusted_app_R-targetSDk. Questa è una delle modifiche fondamentali del framework di compatibilità che consente alle app di attivare/disattivare altre modifiche controllate da targetSdkVersion senza modificare il valore targetSDKVersion dell'app. Per questo motivo, non devi disattivare questa modifica per un'app che ha come target Android 11, altrimenti l'app non funzionerà.

Questa modifica non ha alcun effetto sulle app che utilizzano un ID utente condiviso.

THROW_SECURITY_EXCEPTIONS

ID modifica: 147340954

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Prima di Android 11, un'eccezione SecurityException veniva generata solo dalle API setEnabled per un errore di autorizzazione. In Android 11 questo non è più vero e può essere generata un'eccezione SecurityException per una serie di motivi, nessuno dei quali viene esposto al chiamante.

Per mantenere il comportamento dell'API esistente, se si verifica un errore di autorizzazione legacy o un errore di applicazione dell'attore per un'app che non ha come target Android 11, l'eccezione viene forzata in un IllegalStateException che esisteva nell'origine prima di Android 11.

USE_SET_LOCATION_ENABLED

ID modifica: 117835097

Stato predefinito: attivato per le app che hanno come target Android 11 (livello API 30) o versioni successive.

Le app di amministrazione che hanno come target Android 11 non possono più utilizzare DevicePolicyManager.setSecureSetting(ComponentName, String, String) per modificare l'impostazione Settings.Secure.LOCATION_MODE ritirata. Devono invece utilizzare DevicePolicyManager.setLocationEnabled(ComponentName, boolean).