Mudanças no framework de compatibilidade (Android 14)

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

ACCESS_SHARED_IDENTITY

Concede acesso à identidade do app de abertura se ele tiver ativado o compartilhamento da identidade ao iniciar 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 aberta for o mesmo do app de abertura. 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.

ANR_PRE_UDC_APIS_ON_SLOW_RESPONSES

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

Em apps direcionados ao Android 14 (nível 34 da API) e versões 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

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

DEFAULT_RESCIND_BAL_PRIVILEGES_FROM_PENDING_INTENT_SENDER

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

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

Essa mudança é a responsável por todas as alterações de redução de escalonamento por buffer em cada app. A ativação dessa mudança permite que os seguintes fatores de escalonamento sejam aplicados:

• DOWNSCALE_30
• DOWNSCALE_35
• DOWNSCALE_40
• DOWNSCALE_45
• DOWNSCALE_50
• DOWNSCALE_55
• DOWNSCALE_60
• DOWNSCALE_65
• DOWNSCALE_70
• DOWNSCALE_75
• DOWNSCALE_80
• DOWNSCALE_85
• DOWNSCALE_90

Quando essa mudança é ativada para um pacote de apps, o app é forçado a ser redimensionado para o fator de escalonamento mais alto ativado. Por exemplo, 80% será usado se 80% e 70% (DOWNSCALE_80 e DOWNSCALE_70) estiverem ativados. Quando essa mudança e DOWNSCALED_INVERSE estão ativadas, DOWNSCALED_INVERSE tem precedência, e o fator de escalonamento é aplicado de forma inversa.

DOWNSCALED_INVERSE

Essa mudança é a responsável por todas as alterações de redução de escalonamento inverso por buffer em cada app. A ativação dessa mudança permite que os seguintes fatores de escalonamento sejam aplicados de forma inversa (ou seja, a resolução é redimensionada):

• DOWNSCALE_30
• DOWNSCALE_35
• DOWNSCALE_40
• DOWNSCALE_45
• DOWNSCALE_50
• DOWNSCALE_55
• DOWNSCALE_60
• DOWNSCALE_65
• DOWNSCALE_70
• DOWNSCALE_75
• DOWNSCALE_80
• DOWNSCALE_85
• DOWNSCALE_90

Quando essa mudança é ativada para um pacote de apps, o app é forçado a ser redimensionado para o fator de escalonamento mais baixo ativado. Por exemplo, 80% é usado se 80% e 70% (DOWNSCALE_80 e DOWNSCALE_70) estiverem ativados porque, quando aplicado de forma inversa, um fator de escalonamento de 80% é igual a 125%, o que é menor do que o escalonamento de 142,86% aplicado de forma inversa ao aplicar um fator de escalonamento de 70%. Quando essa mudança e DOWNSCALED estão ativadas, DOWNSCALED_INVERSE tem precedência, e o fator de escalonamento é aplicado de forma inversa.

DOWNSCALE_30

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

DOWNSCALE_35

Se a propriedade DOWNSCALED também estiver ativada, ativar essa mudança para um pacote vai forçar o app a presumir que ele está sendo executado em uma tela com 35% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE 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 285,71% da resolução vertical e horizontal da tela real.

DOWNSCALE_40

Se a propriedade DOWNSCALED também estiver ativada, ativar essa mudança para um pacote vai forçar o app a presumir que ele será executado em uma tela com 40% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE 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 250% da resolução vertical e horizontal da tela real.

DOWNSCALE_45

Se a propriedade DOWNSCALED também estiver ativada, ativar essa mudança para um pacote vai forçar o app a presumir que ele está sendo executado em uma tela com 45% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE 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 222,22% da resolução vertical e horizontal da tela real.

DOWNSCALE_50

Se a propriedade DOWNSCALED também estiver ativada, ativar essa mudança para um pacote vai forçar o app a presumir que ele está sendo executado em uma tela com 50% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE 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 200% da resolução vertical e horizontal da tela real.

DOWNSCALE_55

Se a propriedade DOWNSCALED também estiver ativada, ativar essa mudança para um pacote vai forçar o app a presumir que ele está sendo executado em uma tela com 55% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE 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 181,82% da resolução vertical e horizontal da tela real.

DOWNSCALE_60

Se a propriedade DOWNSCALED também estiver ativada, ativar essa mudança para um pacote vai forçar o app a presumir que ele está sendo executado em uma tela com 60% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE 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 166,67% da resolução vertical e horizontal da tela real.

DOWNSCALE_65

Se a propriedade DOWNSCALED também estiver ativada, ativar essa mudança para um pacote vai forçar o app a presumir que ele está sendo executado em uma tela com 65% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE 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 153,85% da resolução vertical e horizontal da tela real.

DOWNSCALE_70

Se a propriedade DOWNSCALED também estiver ativada, ativar essa mudança para um pacote vai forçar o app a presumir que ele está sendo executado em uma tela com 70% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE 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 142,86% da resolução vertical e horizontal da tela real.

DOWNSCALE_75

Se a propriedade DOWNSCALED também estiver ativada, ativar essa mudança para um pacote vai forçar o app a presumir que ele está sendo executado em uma tela com 75% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE 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 133,33% da resolução vertical e horizontal da tela real.

DOWNSCALE_80

Se a propriedade DOWNSCALED também estiver ativada, ativar essa 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. Se DOWNSCALED_INVERSE 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 125% da resolução vertical e horizontal da tela real.

DOWNSCALE_85

Se a propriedade DOWNSCALED também estiver ativada, ativar essa mudança para um pacote vai forçar o app a presumir que ele está sendo executado em uma tela com 85% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE 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 117,65% da resolução vertical e horizontal da tela real.

DOWNSCALE_90

Se a propriedade DOWNSCALED também estiver ativada, ativar essa mudança para um pacote vai forçar o app a presumir que ele será executado em uma tela com 90% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE 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 111,11% da resolução vertical e horizontal da tela real.

ENABLE_PLATFORM_MDNS_BACKEND

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

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

Em apps destinados ao Android 14 (nível 34 da API) 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

Em apps direcionados ao Android 14 (nível 34 da API) 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.

Para saber mais sobre essa mudança, consulte a seção na página Mudanças de comportamento do Android 14 sobre carregamento de código dinâmico mais seguro.

ENFORCE_STRICT_QUERY_BUILDER

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

EXACT_LISTENER_ALARMS_DROPPED_ON_CACHED

Alarmes exatos que esperam um callback AlarmManager.OnAlarmListener são descartados quando o app de chamada entra em um estado em cache.

Para saber mais sobre as mudanças nos alarmes exatos no Android 14, consulte Programar alarmes exatos não é permitido por padrão.

FGS_TYPE_CHECK_FOR_INSTANT_APPS

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

Quando ativada, os apps destinados ao Android 14 (nível 34 da API) e 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

Quando ativada, os apps direcionados ao Android 14 (nível 34 da API) e 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

Quando ativada, os apps direcionados ao Android 14 (nível 34 da API) 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

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. No entanto, essa flag 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 flag substitui todos os padrões no nível do SO para apps. Ela fica desativada por padrão, o que significa que os padrões do SO têm prioridade. Se essa flag e FORCE_ENABLE_HEVC_SUPPORT estiverem ativadas, o SO vai ignorar as duas flags.

FORCE_ENABLE_HEVC_SUPPORT

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. No entanto, essa flag pode ser usada para forçar um app a oferecer suporte a HEVC, evitando a transcodificação ao acessar mídias codificadas em HEVC. Definir essa flag substitui 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. Se essa flag e FORCE_DISABLE_HEVC_SUPPORT estiverem ativadas, o SO vai ignorar as duas flags.

FORCE_NON_RESIZE_APP

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

FORCE_RESIZE_APP

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

GWP_ASAN

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

Em apps destinados ao Android 14 (nível 34 da API) 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.

Para saber mais sobre essa mudança, consulte a seção na página de mudanças de comportamento do Android 14 sobre restrições a intents implícitas e pendentes.

MEDIA_PROJECTION_PREVENTS_REUSING_CONSENT

Em apps destinados ao Android 14 (nível 34 da API) e mais recentes, é necessário pedir que o usuário dê consentimento antes de cada sessão de captura MediaProjection.

Para saber mais sobre essa mudança, consulte a seção na página de mudanças de comportamento do Android 14 sobre como o consentimento do usuário é necessário para cada sessão de captura MediaProjection.

NATIVE_HEAP_ZERO_INIT

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

NATIVE_MEMTAG_ASYNC

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

NATIVE_MEMTAG_SYNC

Ativa a verificação síncrona (SYNC) de tags de memória nesse processo. Essa flag afeta apenas o hardware com suporte à extensão ARM Memory Tagging (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.

OVERRIDE_ANY_ORIENTATION

Quando ativada, essa mudança permite que as seguintes substituições de orientação sejam aplicadas, independentemente da orientação solicitada pela atividade:

• OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE
• OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR
• OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

Quando ativada, essa 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

Quando ativada, essa 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.

OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE

Ativa SCREEN_ORIENTATION_REVERSE_LANDSCAPE no app em que ele é aplicado. A menos que OVERRIDE_ANY_ORIENTATION também esteja ativada, SCREEN_ORIENTATION_REVERSE_LANDSCAPE será usado somente quando a atividade especificar a orientação paisagem. Ativar essa mudança pode ajudar a testar o comportamento do app em busca de diferenças entre dispositivos em que a orientação paisagem corresponde a Surface.ROTATION_90 e dispositivos em que ela corresponde a Surface.ROTATION_270.

OVERRIDE_MIN_ASPECT_RATIO

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:

• OVERRIDE_MIN_ASPECT_RATIO_LARGE
• OVERRIDE_MIN_ASPECT_RATIO_MEDIUM
• OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

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_EXCLUDE_PORTRAIT_FULLSCREEN

Quando ativado, substitui a restrição de proporção mínima em tela cheia na orientação retrato para usar todo o espaço disponível na tela.

OVERRIDE_MIN_ASPECT_RATIO_LARGE

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

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 médio, conforme definido por OVERRIDE_MIN_ASPECT_RATIO_MEDIUM_VALUE.

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

Quando OVERRIDE_MIN_ASPECT_RATIO também estiver ativado, essa mudança limita outras mudanças que forcem 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.

OVERRIDE_RESPECT_REQUESTED_ORIENTATION

Quando ativada, essa mudança exclui os pacotes aplicados das restrições de ignorar orientação que os fabricantes de dispositivos podem definir.

OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR

Ativa SCREEN_ORIENTATION_NOSENSOR no app em que ele é aplicado. A menos que OVERRIDE_ANY_ORIENTATION também esteja ativada, SCREEN_ORIENTATION_NOSENSOR será usado somente quando a atividade não especificar nenhuma outra orientação fixa.

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT

Ativa SCREEN_ORIENTATION_PORTRAIT no app em que ele é aplicado. A menos que OVERRIDE_ANY_ORIENTATION também esteja ativada, SCREEN_ORIENTATION_PORTRAIT será usado somente quando a atividade não especificar nenhuma outra orientação fixa.

RATE_LIMIT_TOASTS

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 determinado período faz com que o aviso seja descartado.

REJECT_NEGATIVE_NETWORK_ESTIMATES

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

REQUIRE_NETWORK_CONSTRAINT_FOR_NETWORK_JOB_WORK_ITEMS

Em apps destinados ao Android 14 (nível 34 da API) 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

Em apps destinados ao Android 14 (nível 34 da API) e mais recentes, exige que os apps especifiquem as permissões INTERNET e ACCESS_NETWORK_STATE ao programar um job com uma restrição de conectividade.

THROW_ON_INVALID_DATA_TRANSFER_IMPLEMENTATION

Em apps destinados ao Android 14 (nível 34 da API) 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 ao especificar um job de transferência de dados iniciado pelo usuário.

Para saber mais sobre essa mudança, consulte a página que descreve como migrar serviços em primeiro plano para jobs de transferência de dados iniciados pelo usuário.

USE_EXPERIMENTAL_COMPONENT_ALIAS

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