Mudanças no framework de compatibilidade (Android 14)

Figura 1. Tela "Mudanças na compatibilidade do app" nas opções do desenvolvedor listando as mudanças que podem ser ativadas ou desativadas.

Esta página descreve as mudanças alternáveis que fazem parte do framework de compatibilidade do Android 14. Use esta lista em conjunto com as opções do desenvolvedor e os comandos adb para testar e depurar seu app enquanto você se prepara para oferecer suporte e direcionar para o Android 14.

Veja alguns exemplos do que você pode fazer usando as ferramentas do framework de compatibilidade:

  • Teste as mudanças esperadas sem realmente mudar a targetSdkVersion do app. Você pode usar as alternâncias para forçar a ativação de mudanças específicas de comportamento esperado e avaliar o impacto no app existente.
  • Concentre seus testes somente em mudanças específicas. Em vez de ter que resolver todas as mudanças esperadas de uma só vez, as alternâncias permitem as desativar, exceto as que você quer testar.
  • Gerencie alternâncias por meio do adb. Você pode usar comandos adb para ativar e desativar as mudanças alternáveis no seu ambiente de teste automatizado.
  • Depure mais rapidamente usando códigos de mudança padrão. Cada uma delas tem um código e um nome exclusivos que podem ser usados para depurar rapidamente a causa raiz na saída do registro.

Para ver informações completas sobre o uso das ferramentas em cada um desses casos, consulte Ferramentas do framework de compatibilidade.

Mudanças de comportamento incluídas no framework de compatibilidade

A lista nesta seção descreve mudanças alternáveis incluídas no framework de compatibilidade do Android 14.

É possível filtrar a lista de mudanças por Estado padrão.

Mudanças alternáveis no framework de compatibilidade do Android 14

ACCESS_SHARED_IDENTITY

ID da mudança: 259743961
Estado padrão: ativada para todos os apps

Concederá acesso à identidade do app que foi aberto se ele tiver ativado o compartilhamento de identidade iniciando essa atividade com uma instância de ActivityOptions em que ActivityOptions.setShareIdentityEnabled(boolean) foi invocado com um valor de true ou se o uid da atividade iniciada for o mesmo do app que foi aberto. Quando essa mudança é ativada e um desses requisitos é atendido, a atividade pode acessar o uid e o nome do pacote do app que foi aberto com Activity.getLaunchedFromUid() e Activity.getLaunchedFromPackage(), respectivamente.

ALWAYS_SANDBOX_DISPLAY_APIS

ID da mudança: 185004937
Estado padrão: desativada para todos os apps.

Quando ativado, aplica o sandbox da API Display a um pacote , independente do modo de janela. As APIs Display sempre vão fornecer os limites do app.

Para saber mais sobre essa mudança, consulte a seção na página Mudanças de comportamento do Android 12 sobre Métodos de exibição que foram descontinuados.

ANR_PRE_UDC_APIS_ON_SLOW_RESPONSES

ID da mudança: 258236856
Estado padrão: ativada para apps destinados ao Android 14 ou versões mais recentes.

Se ativada, aciona uma mensagem "O app não está respondendo" (ANR) quando os apps estão lentos para responder em APIs e funcionalidades do Android 13 (API de nível 33) ou versões anteriores.

AUTHORITY_ACCESS_CHECK_CHANGE_ID

ID da mudança: 207133734
Estado padrão: ativada para apps destinados ao Android 14 ou mais recente.

Em apps direcionados ao Android 14 e mais recentes, permite conferir o acesso de autoridade do UID de chamada em todas as APIs relacionadas a sincronização.

CAMERA_MIC_INDICATORS_NOT_PRESENT

ID da mudança: 162547999
Estado padrão: desativada para todos os apps.

Indica que o dispositivo oferece suporte a indicadores de câmera e microfone. Se presente, será false, porque o método CompatChanges#isChangeEnabled retornará true se o ID da mudança não estiver presente.

DEFAULT_RESCIND_BAL_FG_PRIVILEGES_BOUND_SERVICE

ID da mudança: 244637991
Estado padrão: ativada para apps destinados ao Android 14 ou versões mais recentes.

Quando um app envia uma PendingIntent usando PendingIntent#send() ou métodos semelhantes, ele agora precisa ativar um recurso para conceder à própria atividade em segundo plano os privilégios de inicialização para iniciar a intent pendente.

Para saber mais sobre essa mudança, na página de mudanças de comportamento do Android 14, consulte a seção sobre outras restrições para iniciar atividades em segundo plano.

DETACH_THROWS_ISE_ONLY

ID da mudança: 236825255
Estado padrão: ativada para apps destinados ao Android 14 ou versões mais recentes.

Flag para bloquear a exceção correta gerada por #detachImage.

#detachImage está documentado como responsável por gerar IllegalStateException em caso de erro. Um método auxiliar nativo gerará RuntimeException se a superfície tiver sido abandonada ao remover a Image.

Esse comportamento de exceção não documentado anteriormente continua no Android 13 (API de nível 33).

Após o Android 13 (API de nível 33), o método auxiliar nativo gera IllegalStateExceptions apenas de acordo com a documentação.

Quando essa mudança estiver ativada, #detachImage gerará uma IllegalStateException apenas se encontrar erros ao remover a imagem. O comportamento continua o mesmo para apps direcionados ao Android 13 (API de nível 33) e anteriores.

DOWNSCALED

ID da mudança: 168419799
Estado padrão: desativada para todos os apps.

Essa mudança é a responsável por todas as alterações de redução de escalonamento por buffer em cada app. Desativar essa mudança impede o funcionamento dos fatores de escalonamento a seguir:

Quando essa mudança estiver ativada para um pacote de apps, o app será forçado a ser redimensionado para o fator de escalonamento mais alto ativado. Por exemplo, 80% será usado se 80% e 70% estiverem ativados.

DOWNSCALE_30

ID da mudança: 189970040
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote forçará o app a presumir que ele será executado em uma tela com 30% da resolução vertical e horizontal da tela real.

DOWNSCALE_35

ID da mudança: 189969749
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote forçará o app a presumir que ele será executado em uma tela com 35% da resolução vertical e horizontal da tela real.

DOWNSCALE_40

ID da mudança: 189970038
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote forçará o app a presumir que ele será executado em uma tela com 40% da resolução vertical e horizontal da tela real.

DOWNSCALE_45

ID da mudança: 189969782
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote forçará o app a presumir que ele será executado em uma tela com 45% da resolução vertical e horizontal da tela real.

DOWNSCALE_50

ID da mudança: 176926741
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote vai forçar o app a presumir que ele será executado em uma tela com 50% da resolução vertical e horizontal da tela real.

DOWNSCALE_55

ID da mudança: 189970036
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote forçará o app a presumir que ele será executado em uma tela com 55% da resolução vertical e horizontal da tela real.

DOWNSCALE_60

ID da mudança: 176926771
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote vai forçar o app a presumir que ele será executado em uma tela com 60% da resolução vertical e horizontal da tela real.

DOWNSCALE_65

ID da mudança: 189969744
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote forçará o app a presumir que ele será executado em uma tela com 65% da resolução vertical e horizontal da tela real.

DOWNSCALE_70

ID da mudança: 176926829
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote vai forçar o app a presumir que ele será executado em uma tela com 70% da resolução vertical e horizontal da tela real.

DOWNSCALE_75

ID da mudança: 189969779
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote forçará o app a presumir que ele será executado em uma tela com 75% da resolução vertical e horizontal da tela real.

DOWNSCALE_80

ID da mudança: 176926753
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote vai forçar o app a presumir que ele será executado em uma tela com 80% da resolução vertical e horizontal da tela real.

DOWNSCALE_85

ID da mudança: 189969734
Estado padrão: desativada para todos os apps.

Quando a propriedade DOWNSCALED também estiver ativada, ativar esta mudança para um pacote vai forçar o app a presumir que ele será executado em uma tela com 85% da resolução vertical e horizontal da tela real.

DOWNSCALE_90

ID da mudança: 182811243
Estado padrão: desativada para todos os apps.

Quando DOWNSCALED também estiver ativado, ativar essa mudança para um pacote vai forçar o app a presumir que ele será executado em uma tela com 90% de resolução vertical e horizontal da tela real.

DYNAMIC_RECEIVER_EXPLICIT_EXPORT_REQUIRED

ID da mudança: 161145287
Estado padrão: desativada para todos os apps.

Quando ativada, exige que o app defina explicitamente Context.RECEIVER_EXPORTED ou Context.RECEIVER_NOT_EXPORTED ao registrar um receptor para uma transmissão desprotegida no código.

Para saber mais, consulte a seção Exportação mais segura de receptores registrados por contexto.

ENABLE_PLATFORM_MDNS_BACKEND

ID da mudança: 270306772
Estado padrão: ativada para apps destinados ao Android 14 ou versões mais recentes.

Apps destinados ao Android 14 ou versões mais recentes usam uma implementação de mDNS integrada à plataforma como back-end, enquanto os apps destinados a versões anteriores continuam usando um back-end de rede de descoberta de serviços (NSD, na sigla em inglês) legado, com um daemon nativo legado como NsdManager.

ENABLE_SELF_CERTIFIED_CAPABILITIES_DECLARATION

ID da mudança: 266524688
Estado padrão: ativada para apps destinados ao Android 14 ou versões mais recentes.

A verificação autocertificada de recursos está ativada para apps destinados ao Android 14 ou versões mais recentes. Consulte NetworkCapabilities para mais detalhes.

ENFORCE_PACKAGE_VISIBILITY_FILTERING

ID da mudança: 154726397
Estado padrão: ativada para apps destinados ao Android 14 ou mais recentes.

Em apps destinados ao Android 14 e mais recentes, exige que os apps declarem as necessidades de visibilidade do pacote no manifesto para acessar as APIs AccountManager.

ENFORCE_READ_ONLY_JAVA_DCL

ID da mudança: 218865702
Estado padrão: ativada para apps destinados ao Android 14 ou mais recentes.

Em apps direcionados ao Android 14 e mais recentes, exige que todos os arquivos carregados dinamicamente sejam marcados como somente leitura. Isso impede que arquivos carregados dinamicamente sejam substituídos inesperadamente por agentes maliciosos.

ENFORCE_STRICT_QUERY_BUILDER

ID da mudança: 143231523
Estado padrão: desativada para todos os apps.

Quando ativada, o SQLiteQueryBuilderCalendarProvider2 verifica todas as seleções de consulta para saber se há argumentos maliciosos.

FGS_TYPE_CHECK_FOR_INSTANT_APPS

ID da mudança: 261055255
Estado padrão: ativada para apps destinados ao Android 14 ou versões mais recentes.

Quando ativada, os apps instantâneos precisam especificar os tipos de serviço em primeiro plano adequados para todos os serviços declarados no arquivo de manifesto do app.

Para saber mais sobre essa mudança, consulte a página que descreve as mudanças nos tipos de serviço em primeiro plano.

FGS_TYPE_NONE_DEPRECATION_CHANGE_ID

ID da mudança: 255042465
Estado padrão: ativada para apps destinados ao Android 14 ou versões mais recentes.

Quando ativada, os apps destinados ao Android 14 e versões mais recentes que iniciam um serviço em primeiro plano usando o tipo FOREGROUND_SERVICE_TYPE_NONE descontinuado geram um aviso no registro.

Para saber mais sobre essa mudança, consulte a página que descreve as mudanças nos tipos de serviço em primeiro plano.

FGS_TYPE_NONE_DISABLED_CHANGE_ID

ID da mudança: 255038118
Estado padrão: ativada para apps destinados ao Android 14 ou versões mais recentes.

Quando ativada, os apps direcionados ao Android 14 e versões mais recentes que iniciam um serviço em primeiro plano usando o tipo FOREGROUND_SERVICE_TYPE_NONE descontinuado resultam em uma exceção.

Para saber mais sobre essa mudança, consulte a página que descreve as mudanças nos tipos de serviço em primeiro plano.

FGS_TYPE_PERMISSION_CHANGE_ID

ID da mudança: 254662522
Estado padrão: ativada para apps destinados ao Android 14 ou versões mais recentes.

Quando ativada, os apps direcionados ao Android 14 e mais recentes que iniciarem um serviço em primeiro plano sem as permissões necessárias associadas ao tipo de serviço em primeiro plano resultarão em uma SecurityException.

Para saber mais sobre essa mudança, consulte a página que descreve as mudanças nos tipos de serviço em primeiro plano.

FORCE_DISABLE_HEVC_SUPPORT

ID da mudança: 174227820
Estado padrão: desativada para todos os apps.

Força um app a deixar de ser compatível com o recurso de mídia HEVC. Os apps precisam declarar no manifesto os recursos de mídia a que oferecem suporte, mas essa sinalização pode ser usada para forçar um app a não oferecer suporte a HEVC, forçando a transcodificação ao acessar mídias codificadas em HEVC. Definir essa sinalização modificará todos os padrões no nível do SO do app. Esse recurso fica desativado por padrão, o que significa que os padrões do SO têm prioridade. Definir essa sinalização e FORCE_ENABLE_HEVC_SUPPORT indica um estado indefinido e faz com que o SO ignore as duas sinalizações.

FORCE_ENABLE_HEVC_SUPPORT

ID da mudança: 174228127
Estado padrão: desativada para todos os apps.

Força o app a oferecer suporte ao recurso de mídia HEVC. Os apps precisam declarar no manifesto os recursos de mídia a que oferecem suporte. mas essa sinalização pode ser usada para forçar um app oferecer suporte a HEVC, evitando a transcodificação ao acessar mídias codificadas em HEVC. Definir essa sinalização modificará todos os padrões no nível do SO do app. Esse recurso fica desativado por padrão, o que significa que os padrões do SO têm prioridade. Definir essa sinalização e FORCE_DISABLE_HEVC_SUPPORT indica um estado indefinido e fará com que o SO ignore as duas sinalizações.

FORCE_NON_RESIZE_APP

ID da mudança: 181146395
Estado padrão: desativada para todos os apps

Força os pacotes em que é aplicada a não serem redimensionáveis.

FORCE_RESIZE_APP

ID da mudança: 174042936
Estado padrão: desativada para todos os apps.

Força os pacotes em que é aplicada a serem redimensionáveis. Só é permitido redimensionar janelas no modo de tela cheia. Não é possível forçar o app a entrar no modo de várias janelas redimensionáveis.

GWP_ASAN

ID da mudança: 145634846
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 o uso do GWP-ASan, consulte o Guia do GWP-ASan.

IMPLICIT_INTENTS_ONLY_MATCH_EXPORTED_COMPONENTS

ID da mudança: 229362273
Estado padrão: ativada para apps destinados ao Android 14 ou mais recente

Em apps destinados ao Android 14 e mais recentes, os componentes precisam ser exportados para serem invocados por intents implícitas. Se um componente não for exportado e invocado, ele será removido da lista de receptores. Isso se aplica especificamente a atividades e transmissões.

KEYSTORE_OPERATION_CREATION_MAY_FAIL

ID da mudança: 169897160
Estado padrão: desativada para todos os apps.

Quando ativada, a criação da operação de keystore pode falhar de acordo com a nova estratégia de remoção. O keystore funcionava com base no pressuposto de que a criação de operações criptográficas sempre ocorria corretamente. No entanto, o back-end KeyMint tem um número limitado de slots de operação.

Para que o número de slots de operação parecessem ser "infinitos", o daemon do Keystore removia as operações menos usadas recentemente caso não houvesse um slot de operação disponível. Como resultado, boas operações podiam ser encerradas de forma prematura. Isso abriu o AndroidKeystore para negação de serviço (DoS) e livelocks indesejados. Por exemplo, caso vários apps fossem ativados ao mesmo tempo devido a otimizações de gerenciamento de energia e tentassem executar operações de criptografia, eles passariam a encerrar as operações uns dos outros, sem fazer nenhum progresso.

Para eliminar os livelocks e desestimular as tentativas de DoS, mudamos a estratégia de remoção, de forma que os clientes que usam poucos slots de operação de forma breve têm preferência. Consequentemente, operações únicas que não ficam inativas por mais de cinco segundos quase sempre são concluídas sem interrupções pela estratégia de remoção. Ainda existem algumas operações relacionadas à criptografia do sistema de arquivos que podem remover até mesmo essas operações, mas esses casos são extremamente raros. Como efeito colateral dessa nova estratégia de remoção, a criação pode apresentar falha se o cliente tiver um poder de remoção menor do que todas as operações existentes.

Estratégia de remoção: para encontrar um candidato adequado, computamos o malus do autor da chamada e de cada operação existente. O malus é o inverso do poder de remoção (autor da chamada) ou da resistência à remoção (operação atual). Para que o autor da chamada possa remover uma operação, ele precisa encontrar uma operação com malus maior do que o seu. Para ver mais detalhes sobre a estratégia de remoção, consulte a implementação de operation.rs. No Android 11 (API de nível 30) e versões anteriores, o KeyStore2 procura um slot de operação livre no daemon do Keystore. Para apps direcionados ao Android 11 (API de nível 30) e versões anteriores, ainda vai parecer que a inicialização de objetos de criptografia e assinatura sempre funciona. No entanto, pode levar mais tempo para realizar a operação. Todas as versões do Android se beneficiam da programação de slots mais justa e de ter uma chance melhor de concluir uma operação.

NATIVE_HEAP_ZERO_INIT

ID da mudança: 178038272
Estado padrão: desativada para todos os apps.

Ative a inicialização em zero automática para alocações de memória de heap nativas.

NATIVE_MEMTAG_ASYNC

ID da mudança: 145772972
Estado padrão: desativada para todos os apps

Ative a verificação assíncrona (ASYNC) de tags de memória nesse processo. Essa sinalização afeta apenas o hardware com suporte à extensão ARM Memory Tagging Extension (MTE).

NATIVE_MEMTAG_SYNC

ID da mudança: 177438394
Estado padrão: desativada para todos os apps.

Ativa a verificação síncrona (SYNC) de tags de memória nesse processo. Essa sinalização afeta apenas o hardware compatível com a extensão ARM Memory Tagging Extension (MTE). Se NATIVE_MEMTAG_ASYNC e essa opção estiverem ativadas, essa opção terá preferência e a MTE será ativada no modo SYNC.

NEVER_SANDBOX_DISPLAY_APIS

ID da mudança: 184838306
Estado padrão: desativada para todos os apps.

Quando ativada, impede que o sandbox da API Display seja aplicado a uma atividade com efeito letterbox ou SCM. As APIs Display vão continuar a fornecer limites de DisplayArea.

Para saber mais sobre essa mudança, consulte a seção na página Mudanças de comportamento do Android 12 sobre Métodos de exibição que foram descontinuados.

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

ID da mudança: 191514214
Estado padrão: desativada para todos os apps

Quando ativada, esse ID de mudança força os pacotes aplicados a ignorar o valor atual de android:resizeableActivity, bem como o SDK de destino igual ou menor que M e considerar a atividade como não redimensionável. Nesse caso, o valor de rotação e corte da câmera vai depender apenas da compensação necessária, considerando a rotação atual da tela.

OVERRIDE_CAMERA_ROTATE_AND_CROP_DEFAULTS

ID da mudança: 189229956
Estado padrão: desativada para todos os apps.

Quando ativada, esse ID de mudança força os pacotes aplicados a modificar o comportamento padrão de rotação e corte da câmera e sempre retornar CaptureRequest.SCALER_ROTATE_AND_CROP_NONE. O comportamento padrão e todas as combinações de substituição possíveis são discutidos na tabela abaixo.

OVERRIDE_MIN_ASPECT_RATIO

ID da mudança: 174042980
Estado padrão: desativada para todos os apps.

Essa mudança é a responsável por todas as mudanças que forçam uma determinada proporção mínima. A ativação dela possibilita que as proporções mínimas a seguir sejam aplicadas:

Quando essa mudança é ativada para um pacote de apps, a proporção mínima fornecida no manifesto do app é substituída pela maior proporção ativada, a menos que o valor do manifesto seja maior.

OVERRIDE_MIN_ASPECT_RATIO_LARGE

ID da mudança: 180326787
Estado padrão: desativada para todos os apps.

Quando OVERRIDE_MIN_ASPECT_RATIO também estiver ativado, ativar essa mudança para um pacote vai definir a proporção mínima da atividade como um valor alto, conforme definido por OVERRIDE_MIN_ASPECT_RATIO_LARGE_VALUE.

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

ID da mudança: 180326845
Estado padrão: desativada para todos os apps.

Quando OVERRIDE_MIN_ASPECT_RATIO também estiver ativado, ativar esta mudança para um pacote vai definir a proporção mínima da atividade como um valor médio, conforme definido por OVERRIDE_MIN_ASPECT_RATIO_MEDIUM_VALUE.

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

ID da mudança: 203647190
Estado padrão: ativada para todos os apps.

Quando o OVERRIDE_MIN_ASPECT_RATIO também estiver ativado, a ativação dessa mudança para um pacote limita outras mudanças que forçam a proporção mínima de uma atividade a um determinado valor, como OVERRIDE_MIN_ASPECT_RATIO_LARGE e OVERRIDE_MIN_ASPECT_RATIO_MEDIUM, para atividades que também têm orientação de retrato.

RATE_LIMIT_TOASTS

ID da mudança: 174840628
Estado padrão: essa mudança não pode ser alternada. Ela só é registrada pelo framework de compatibilidade.

Ativa a limitação de taxa para o número de chamadas Toast.show(), a fim de evitar sobrecarregar o usuário com muitos avisos em um período limitado. Qualquer tentativa de mostrar mais avisos do que o permitido em um período determinado fará com que o aviso seja descartado.

REJECT_NEGATIVE_NETWORK_ESTIMATES

ID da mudança: 253665015
Estado padrão: ativada para apps destinados ao Android 14 ou versões mais recentes.

Quando ativada, exige que os bytes estimados da rede não sejam negativos.

REQUIRE_NETWORK_CONSTRAINT_FOR_NETWORK_JOB_WORK_ITEMS

ID da mudança: 241104082
Estado padrão: ativada para apps destinados ao Android 14 ou mais recente.

Em apps destinados ao Android 14 e mais recentes, exige que o job de hospedagem especifique uma restrição de rede caso o JobWorkItem incluído indique o uso da rede.

REQUIRE_NETWORK_PERMISSIONS_FOR_CONNECTIVITY_JOBS

ID da mudança: 271850009
Estado padrão: ativada para apps destinados ao Android 14 ou versões mais recentes.

Para apps destinados ao Android 14 e versões mais recentes, exige que os apps especifiquem as permissões INTERNET e ACCESS_NETWORK_STATEs ao programar um job com uma restrição de conectividade.

THROW_ON_INVALID_DATA_TRANSFER_IMPLEMENTATION

ID da mudança: 255371817
Estado padrão: ativada para apps destinados ao Android 14 ou mais recente

Em apps destinados ao Android 14 e mais recentes, o sistema gera uma exceção quando um app não implementa corretamente todas as APIs de transferência de dados necessárias.

USE_EXPERIMENTAL_COMPONENT_ALIAS

ID da mudança: 196254758
Estado padrão: desativada para todos os apps.

Quando ativada, o sistema permite que o pacote "android" use alias de componentes.