Mudanças no framework de compatibilidade (Android {/9}11)

Esta página descreve cada mudança de comportamento que afeta o app e foi adicionada ao framework de compatibilidade no Android 11 (nível 30 da API). Use esta lista em conjunto com as opções do desenvolvedor e comandos adb para testar e depurar seu app enquanto você se prepara para direcionar ao Android 11.

ADD_CONTENT_OBSERVER_FLAGS

ID da mudança: 150939131

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para apps voltados para o Android 11, há uma nova sobrecarga de API public onChange(boolean, Uri, int) que inclui um argumento flags de inteiro.

Esse novo método é uma alternativa pública do SDK para apps que usam o método sobrecarregado onChange() não SDK que inclui um argumento inteiro userId.

ADMIN_APP_PASSWORD_COMPLEXITY

ID da mudança: 123562444

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para apps de administrador voltados para o Android 11, gere um erro sempre que um app definir um requisito de senha que não seja relevante para a qualidade da senha atualmente atribuída. Por exemplo, quando a qualidade da senha é definida como DevicePolicyManager.PASSWORD_QUALITY_UNSPECIFIED, um app não poderia definir um comprimento de senha mínimo. Nesse caso, antes de tentar definir o comprimento mínimo da senha, o app precisa primeiro chamar o método setPasswordQuality() e só então chamar o método setPasswordMinimumLength().

Além disso, quando um app de administrador voltado para o Android 11 diminui a qualidade da senha, todos os requisitos de senha existentes que não são mais aplicáveis são redefinidos para os valores padrão.

APP_DATA_DIRECTORY_ISOLATION

ID da mudança: 143937733

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Apps voltados para o Android 11 não podem mais acessar arquivos em diretórios de dados particulares de nenhum app, independentemente da versão do SDK de destino do outro app.

Para saber mais, consulte Acesso a diretórios privados.

APN_READING_PERMISSION_CHANGE_ID

ID da mudança: 124107808

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para apps destinados ao Android 11, o acesso ao banco de dados APN agora requer a permissão Manifest.permission.WRITE_APN_SETTINGS.

Para saber mais sobre essa mudança, consulte Acesso de leitura restrito ao banco de dados do APN.

BACKGROUND_RATIONALE_CHANGE_ID

ID da mudança: 147316723

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Agora, os apps precisam fornecer uma justificativa válida sempre que solicitarem acesso à localização do dispositivo em segundo plano.

Para saber mais sobre essa mudança, consulte o guia sobre como acessar a localização em segundo plano no Android 11 que discute mudanças de privacidade relacionadas à localização no Android 11.

CALLBACK_ON_CLEAR_CHANGE

ID da mudança: 119147584

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Sempre que Editor.clear é chamado, um callback para OnSharedPreferenceChangeListener.onSharedPreferenceChanged é feito com uma chave null.

Para saber mais sobre essa mudança, consulte Mudanças de callback para OnSharedPreferenceChangeListener.

CALLBACK_ON_MORE_ERROR_CODE_CHANGE

ID da mudança: 130595455

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Os códigos de erro estão expandidos para updateAvailableNetworks(List, Executor, Consumer) e setPreferredOpportunisticDataSubscription(int, boolean, Executor, Consumer).

CALL_BACK_ON_CHANGED_LISTENER_WITH_SWITCHED_OP_CHANGE

ID da mudança: 148180766

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Essa é uma mudança de comportamento sutil para startWatchingMode(String, String, AppOpsManager.OnOpChangedListener). Antes dessa mudança, o sistema era chamado de volta para a operação trocada. Após a mudança, o sistema faz o callback para a operação realmente solicitada ou todas as operações trocadas se nenhuma operação for especificada.

CAMERA_MICROPHONE_CAPABILITY_CHANGE_ID

ID da mudança: 136219221

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para apps voltados para o Android 11, os serviços em primeiro plano só recebem recursos em uso de câmera e microfone quando o R.attr.foregroundServiceType está configurado como ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA e ServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE, respectivamente, no arquivo de manifesto. Em versões anteriores do Android, os serviços em primeiro plano recebiam automaticamente recursos de câmera e microfone.

Para saber mais sobre essa mudança, consulte Tipos de serviço em primeiro plano no Android 11.

CHANGE_BACKGROUND_CUSTOM_TOAST_BLOCK

ID da mudança: 128611929

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Os apps não podem mais postar avisos personalizados em segundo plano. No entanto, os apps ainda podem postar avisos em segundo plano usando o método Toast.makeText(Context, CharSequence, int) e variantes dele.

Para saber mais sobre essa mudança, consulte Visualizações de avisos personalizadas estão bloqueadas.

CHANGE_RESTRICT_SAW_INTENT

ID da mudança: 135920175

Estado padrão: essa mudança não pode ser ativada ou desativada. Ela é registrada apenas pelo framework de compatibilidade.

Intents que usam a ação android.settings.MANAGE_APP_OVERLAY_PERMISSION e o esquema de dados URI package não direcionam mais o usuário para uma tela específica do app para gerenciar a permissão associada. Em vez disso, o usuário é direcionado para uma tela em que pode gerenciar todos os apps que solicitaram a permissão.

CHANGE_TEXT_TOASTS_IN_THE_SYSTEM

ID da mudança: 147798919

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Os avisos de texto agora são renderizados pela SystemUI em vez de no app. Isso evita que apps burlem as restrições de postagem de avisos personalizados em segundo plano.

DEFAULT_SCOPED_STORAGE

ID da mudança: 149924527

Estado padrão: ativada para todos os apps.

Todos os apps voltados para o Android 11 agora usam o armazenamento com escopo por padrão e não podem mais desativá-lo.

No entanto, é possível testar o app sem armazenamento com escopo, independentemente da versão do SDK de destino e dos valores de sinalização do manifesto do app, desativando essa mudança.

Para saber mais sobre as mudanças no armazenamento com escopo no Android 11, consulte a seção armazenamento com escopo na página sobre mudanças no armazenamento do Android 11.

EMPTY_INTENT_ACTION_CATEGORY

ID da mudança: 151163173

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para apps direcionados ao Android 11, o sistema gera um erro se action ou category de um filtro de intent for uma string vazia. Um bug na plataforma anterior ao Android 11 permitia que esse caso fosse transmitido sem gerar um erro. Isso não inclui casos em que o atributo é nulo ou ausente, porque isso sempre gerou um erro.

FILTER_APPLICATION_QUERY

ID da mudança: 135549675

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Os apps precisam declarar os pacotes e as intents que pretendem usar antes de ver detalhes sobre outros apps em um dispositivo. Essas declarações precisam ser feitas usando a tag <queries> no manifesto do app.

Para saber mais sobre como consultar e interagir com outros apps instalados no Android 11, consulte a página de privacidade visibilidade do pacote.

FORCE_ENABLE_SCOPED_STORAGE

ID da mudança: Valor: 132649864

Estado padrão: desativada para todos os apps.

Todos os apps voltados para o Android 11 agora usam o armazenamento com escopo por padrão e não podem mais desativá-lo.

No entanto, se o app ainda for direcionado ao Android 10 (API de nível 29) ou anterior, teste o app com armazenamento com escopo, independentemente da versão do SDK de destino e dos valores de sinalização do manifesto, ativando essa opção.

Para saber mais sobre as mudanças no armazenamento com escopo no Android 11, consulte a seção armazenamento com escopo na página sobre mudanças no armazenamento do Android 11.

GET_DATA_CONNECTION_STATE_R_VERSION

ID da mudança: 148535736

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para verificar a versão do SDK para PreciseDataConnectionState#getDataConnectionState.

GET_DATA_STATE_R_VERSION

ID da mudança: 148534348

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para verificar a versão do SDK para getDataState().

GET_PROVIDER_SECURITY_EXCEPTIONS

ID da mudança: 150935354

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para apps direcionados para o Android 11 (API de nível 30) ou versões mais recentes, o getProvider(String) não gera mais exceções de segurança.

GET_TARGET_SDK_VERSION_CODE_CHANGE

ID da mudança: 145147528

Estado padrão: ativado para apps voltados para o Android 10 (API de nível 29) ou mais recente.

Para verificar a versão do SDK para o método SmsManager.sendResolverResult().

GWP_ASAN

ID da mudança: 135634846

Estado padrão: desativada para todos os apps.

Ativa a detecção de bugs de memória nativa de amostra em apps.

Para saber mais sobre essa mudança, consulte o Guia do GWP-ASan.

HIDE_MAXTARGETSDK_P_HIDDEN_APIS

ID da mudança: 149997251

Estado padrão: ativado para apps voltados para o Android 10 (API de nível 29) ou mais recente.

Para apps direcionados para o Android 10 (nível da API 29) ou mais recentes, remove o acesso a todas as interfaces não SDK que fazem parte da lista max-target-p (greylist-max-p) do Android 10 (nível da API 29).

HIDE_MAXTARGETSDK_Q_HIDDEN_APIS

ID da mudança: 149994052

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para apps direcionados para o Android 11 (nível da API 30) ou mais recentes, remove o acesso a todas as interfaces não SDK que fazem parte da lista max-target-q (greylist-max-q) do Android 11 (nível da API 30).

Para saber mais sobre essa mudança, consulte Interfaces não SDK que agora estão bloqueadas no Android 11.

LISTEN_CODE_CHANGE

ID da mudança: 147600208

Estado padrão: ativado para apps voltados para o Android 10 (API de nível 29) ou mais recente.

Para verificar a versão do SDK para TelephonyManager.listen(PhoneStateListener, int).

MISSING_APP_TAG

ID da mudança: 150776642

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para apps direcionados ao Android 11, um erro agora é gerado quando o arquivo de manifesto de um app não tem uma tag application ou instrumentation.

NATIVE_HEAP_POINTER_TAGGING

ID da mudança: 135754954

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para apps voltados para o Android 11, as alocações de heap nativas agora têm uma tag diferente de zero no byte mais significativo.

Para saber mais, consulte Inclusão de tag de ponteiro de heap.

PHONE_STATE_LISTENER_LIMIT_CHANGE_ID

ID da mudança: 150880553

Estado padrão: ativada para todos os apps.

Para apps direcionados ao Android 11, agora há um limite no número de objetos PhoneStateListener que qualquer processo pode registrar via TelephonyManager.listen(PhoneStateListener, int). O limite padrão é 50, que pode ser alterado por atualizações de configuração remota do dispositivo. Esse limite é aplicado usando um IllegalStateException gerado por TelephonyManager.listen(PhoneStateListener, int) quando o processo com problemas tenta registrar muitos listeners.

PREVENT_META_REFLECTION_BLACKLIST_ACCESS

ID da mudança: 142365358

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Os apps direcionados para o Android 11 não podem mais usar uma camada extra de reflexão para acessar interfaces não SDK restritas.

PROCESS_CAPABILITY_CHANGE_ID

ID da mudança: 136274596

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para apps voltados para o Android 11, a sinalização Context.BIND_INCLUDE_CAPABILITIES agora pode ser usada para transmitir recursos em uso do processo do cliente para um serviço vinculado.

REMOVE_ANDROID_TEST_BASE

ID da mudança: 133396946

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para apps direcionados para o Android 11, a biblioteca android.test.base foi removida se o app não depende de android.test.runner (porque depende das classes da biblioteca android.test.base).

REQUEST_ACCESSIBILITY_BUTTON_CHANGE

ID da mudança: 136293963

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Para serviços de acessibilidade voltados para o Android 11, a sinalização FLAG_REQUEST_ACCESSIBILITY_BUTTON precisa ser especificada no arquivo de metadados do serviço de acessibilidade. Caso contrário, ela será ignorada.

Para saber mais sobre essa mudança, consulte Declarar o uso do botão de acessibilidade no arquivo de metadados.

RESOURCES_ARSC_COMPRESSED

ID da mudança: 132742131

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Os apps destinados ao Android 11 (API de nível 30) não poderão ser instalados se contiverem um arquivo compactado resources.arsc ou se esse arquivo não estiver alinhado em um limite de 4 bytes.

Para saber mais sobre essa mudança, consulte Arquivos de recursos compactados.

RESTRICT_STORAGE_ACCESS_FRAMEWORK

ID da mudança: 141600225

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Se o app for voltado para o Android 11 e usar o Framework de acesso ao armazenamento (SAF, na sigla em inglês), não será mais possível acessar determinados diretórios usando as ações da intent ACTION_OPEN_DOCUMENT e ACTION_OPEN_DOCUMENT_TREE. Para saber mais sobre essas mudanças, consulte a seção de restrições de acesso ao documento na página que discute atualizações de privacidade relacionadas a armazenamento no Android 11.

SELINUX_LATEST_CHANGES

ID da mudança: 143539591

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Essa mudança permite que os apps acessem o domínio SELinux untrusted_app_R-targetSDk. Essa é uma das mudanças fundamentais no framework de compatibilidade que permite que os apps alternem outras mudanças controladas por targetSdkVersion sem modificar as targetSDKVersion do app. Por esse motivo, não desative essa mudança para um app direcionado ao Android 11, porque o app não funcionará.

Essa mudança não tem efeito para apps que usam um ID do usuário compartilhado.

THROW_SECURITY_EXCEPTIONS

ID da mudança: 147340954

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Antes do Android 11, um SecurityException só seria gerado por APIs setEnabled para um erro de permissão. No Android 11, isso não é mais válido, e um SecurityException pode ser gerado por vários motivos, e nenhum deles é exposto ao autor da chamada.

Para manter o comportamento já existente da API, se ocorrer uma falha de permissão legada ou falha de aplicação de ação em um app que não direcionado ao Android 11, a exceção será forçada para um IllegalStateException que existia na fonte antes do Android 11.

USE_SET_LOCATION_ENABLED

ID da mudança: 117835097

Estado padrão: ativado para apps direcionados para o Android 11 (API de nível 30) ou mais recente.

Apps de administrador voltados para o Android 11 não podem mais usar DevicePolicyManager.setSecureSetting(ComponentName, String, String) para mudar a configuração Settings.Secure.LOCATION_MODE obsoleta. Em vez disso, eles usarão DevicePolicyManager.setLocationEnabled(ComponentName, boolean).