Modifiche al framework di compatibilità (Android 11)

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

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 che hanno come target Android 11, è disponibile un nuovo overload dell'API pubblica onChange(boolean, Uri, int) che include un argomento intero flags.

Questo nuovo metodo è un'alternativa SDK pubblica per le app che utilizzano il metodo onChange()non SDK sovraccarico 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 di amministrazione che hanno come target Android 11, genera un errore ogni volta che un'app imposta un requisito di password non pertinente alla qualità della password attualmente assegnata. Ad esempio, se la qualità della password è impostata su DevicePolicyManager.PASSWORD_QUALITY_UNSPECIFIED, un'app non potrebbe impostare una lunghezza minima della password. In questo caso, prima di tentare di impostare la lunghezza minima della password, l'app deve prima chiamare il metodo setPasswordQuality() e solo dopo chiamare il metodo setPasswordMinimumLength().

Inoltre, quando un'app amministratore che ha come target Android 11 abbassa la qualità della password, tutti i requisiti di password esistenti che non si applicano più 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 di destinazione 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 saperne 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 saperne 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 chiamata Editor.clear, viene ora effettuato un callback a OnSharedPreferenceChangeListener.onSharedPreferenceChanged con una chiave null.

Per saperne di più su questa modifica, consulta Modifiche del 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 sottile modifica del comportamento di startWatchingMode(String, String, AppOpsManager.OnOpChangedListener). Prima di questa modifica, il sistema richiamava l'operazione commutata. Dopo la modifica, il sistema richiamerà l'operazione effettivamente richiesta o tutte le operazioni commutate 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 fotocamera e microfono durante l'uso 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 saperne di più su questa modifica, consulta Tipi di servizi in primo piano in Android 11.

CHANGE_BACKGROUND_CUSTOM_TOAST_BLOCK

ID Change: 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 in background.

Per scoprire di più su questa modifica, consulta Le visualizzazioni dei toast personalizzati 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 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 da SystemUI anziché all'interno dell'app. In questo modo le app non possono aggirare le limitazioni 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 lo storage isolato per impostazione predefinita e non possono più disattivare lo storage isolato.

Tuttavia, puoi testare la tua app senza lo spazio di archiviazione isolato, indipendentemente dalla versione SDK di destinazione e dai valori dei flag del manifest dell'app, disattivando questa modifica.

Per saperne di più sulle modifiche allo spazio di archiviazione isolato in Android 11, consulta la sezione Spazio di archiviazione isolato nella pagina relativa alle modifiche allo spazio di archiviazione 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 il passaggio di questo caso senza generare un errore. Tieni presente che non sono inclusi i casi in cui l'attributo è nullo o mancante, poiché in questi casi si è sempre verificato 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 saperne 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

Change ID: Value: 132649864

Stato predefinito: disabilitato per tutte le app.

Tutte le app che hanno come target Android 11 ora utilizzano lo storage isolato per impostazione predefinita e non possono più disattivare lo storage isolato.

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

Per saperne di più sulle modifiche allo spazio di archiviazione isolato in Android 11, consulta la sezione Spazio di archiviazione isolato nella pagina relativa alle modifiche allo spazio di archiviazione 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: disabilitato per tutte le app.

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

Per scoprire di più su questa modifica, consulta la guida a 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 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 dell'heap nativo ora hanno un tag diverso da zero nel byte più significativo.

Per scoprire di più, consulta Tagging dei puntatori dell'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, che può essere modificato dagli aggiornamenti della configurazione del dispositivo remoto. Questo limite viene applicato utilizzando un'IllegalStateException generata da TelephonyManager.listen(PhoneStateListener, int) quando il processo incriminato tenta di registrare un numero eccessivo di listener.

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 a 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 trasferire le funzionalità di utilizzo in primo piano 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 (in quanto 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, il flag FLAG_REQUEST_ACCESSIBILITY_BUTTON deve ora essere specificato nel file di metadati del servizio di accessibilità. In caso contrario, il flag viene ignorato.

Per saperne di più su questa modifica, consulta Dichiarare 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 compresso resources.arsc o se questo file non è allineato a 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 lo Storage Access Framework (SAF), non puoi più accedere a determinate directory utilizzando le azioni intent ACTION_OPEN_DOCUMENT e ACTION_OPEN_DOCUMENT_TREE. Per saperne di più su queste modifiche, consulta la sezione Limitazioni all'accesso ai documenti nella pagina che illustra gli aggiornamenti della privacy relativi all'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. Si tratta di una delle modifiche fondamentali nel framework di compatibilità che consentono alle app di attivare/disattivare altre modifiche controllate da targetSdkVersion senza modificare il 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'SecurityException sarebbe stato generato solo dalle API setEnabled per un errore di autorizzazione. In Android 11 questo non è più vero e un SecurityException può essere generato per una serie di motivi, nessuno dei quali è esposto al chiamante.

Per mantenere il comportamento esistente dell'API, se si verifica un errore di autorizzazione legacy o di applicazione dell'attore per un'app che non ha come target Android 11, l'eccezione viene forzata in un IllegalStateException esistente 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 deprecata. Devono invece utilizzare DevicePolicyManager.setLocationEnabled(ComponentName, boolean).