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

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 15. 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 15.

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 as mudanças alternáveis incluídas no framework de compatibilidade para mudanças relacionadas ao Android 15 e mudanças alternáveis que podem ajudar em testes gerais de apps.

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

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

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, o valor será false, porque o método CompatChanges#isChangeEnabled retornará true se o ID da mudança não estiver presente.

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. Ativar essa alteração permite que os seguintes fatores de escalonamento sejam aplicados:

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

DOWNSCALED_INVERSE

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

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

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

DOWNSCALE_30

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

Se 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. Se DOWNSCALED_INVERSE também estiver ativado, ativar esta 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

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

Se 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. Se DOWNSCALED_INVERSE também estiver ativado, ativar esta mudança para um pacote 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

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

Se 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. Se DOWNSCALED_INVERSE também estiver ativado, ativar esta mudança para um pacote 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

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

Se DOWNSCALED também estiver ativado, 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. Se DOWNSCALED_INVERSE também estiver ativado, ativar esta mudança para um pacote 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

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

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

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

Se DOWNSCALED também estiver ativado, 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. Se DOWNSCALED_INVERSE também estiver ativado, ativar esta mudança para um pacote 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

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

Se 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 60% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE também estiver ativado, ativar esta mudança para um pacote 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

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

Se DOWNSCALED também estiver ativado, 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. Se DOWNSCALED_INVERSE também estiver ativado, ativar esta mudança para um pacote 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

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

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

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

Se 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. Se DOWNSCALED_INVERSE também estiver ativado, ativar esta mudança para um pacote 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

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

Se DOWNSCALED também estiver ativado, ativar esta mudança para um pacote 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 esta mudança para um pacote 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

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

Se 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 85% da resolução vertical e horizontal da tela real. Se DOWNSCALED_INVERSE também estiver ativado, ativar esta mudança para um pacote 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

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

Se DOWNSCALED também estiver ativado, ativar esta mudança para um pacote 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 esta mudança para um pacote 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.

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_BOOT_COMPLETED_RESTRICTIONS

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

Quando ativada, desativa o início do serviço em primeiro plano em segundo plano de transmissões BOOT_COMPLETED para todos os tipos, exceto:

Para saber mais sobre essa mudança, consulte a seção na página de mudanças de comportamento do Android 15 sobre Restrições em broadcast receivers BOOT_COMPLETED iniciando serviços 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 com 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 flag substitui todos os padrões no nível do SO para apps. Ele fica desativado por padrão, o que significa que os padrões do SO têm precedência. Se essa sinalização e FORCE_ENABLE_HEVC_SUPPORT estiverem ativadas, o SO ignorará as duas.

FORCE_ENABLE_HEVC_SUPPORT

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

Forçar a ativação de um app para oferecer suporte ao recurso de mídia HEVC. Os apps precisam declarar no manifesto os recursos de mídia com suporte. Essa sinalização 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 para apps. Ele fica desativado por padrão, o que significa que os padrões do SO têm prioridade. Se essa sinalização e FORCE_DISABLE_HEVC_SUPPORT estiverem ativadas, o SO ignorará as duas.

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: 440042936
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ável.

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.

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 com suporte à extensão ARM Memory Tagging Extension (MTE). Se NATIVE_MEMTAG_ASYNC e essa opção estiverem ativadas, essa opção terá precedência e a MTE será ativada no modo SYNC.

OVERRIDE_ANY_ORIENTATION

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

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

OVERRIDE_ANY_ORIENTATION_TO_USER

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

Quando ativada, ativa SCREEN_ORIENTATION_USER, que substitui qualquer orientação solicitada pela atividade. Os apps de orientação corrigida podem ser substituídos para tela cheia em dispositivos de tela grande com ignoreOrientationRequest ativado com essa substituição.

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

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

Quando ativada, essa mudança força os pacotes aplicados a ignorar o valor atual de android:resizeableActivity, assim 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 depende 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, 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

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

Ativa SCREEN_ORIENTATION_REVERSE_LANDSCAPE para o app ao qual é aplicado. A menos que OVERRIDE_ANY_ORIENTATION também esteja ativado, SCREEN_ORIENTATION_REVERSE_LANDSCAPE será usado somente quando a atividade especificar a orientação de paisagem. Ativar essa mudança pode ajudar você a testar o comportamento do seu 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

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_EXCLUDE_PORTRAIT_FULLSCREEN

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

Quando ativada, modifica a restrição de proporção mínima na tela cheia no modo retrato para usar todo o espaço disponível na tela.

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 esta 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 OVERRIDE_MIN_ASPECT_RATIO também estiver ativado, essa mudança limitará qualquer outra mudança que force a proporção mínima de uma atividade a um determinado valor, como OVERRIDE_MIN_ASPECT_RATIO_LARGE e OVERRIDE_MIN_ASPECT_RATIO_MEDIUM, a atividades que também tenham a orientação retrato.

OVERRIDE_RESPECT_REQUESTED_ORIENTATION

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

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

OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR

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

Ativa SCREEN_ORIENTATION_NOSENSOR para o app ao qual é aplicado. A menos que a OVERRIDE_ANY_ORIENTATION também esteja ativada, a SCREEN_ORIENTATION_NOSENSOR será usada somente quando a atividade não especificar nenhuma outra orientação fixa.

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT

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

Ativa SCREEN_ORIENTATION_PORTRAIT para o app ao qual é aplicado. A menos que a OVERRIDE_ANY_ORIENTATION também esteja ativada, a SCREEN_ORIENTATION_PORTRAIT será usada somente quando a atividade não especificar nenhuma outra orientação fixa.

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 no número de chamadas Toast.show() para evitar sobrecarregar o usuário com muitos avisos em um tempo limitado. Qualquer tentativa de mostrar mais avisos do que o permitido em um determinado período faz com que o aviso seja descartado.

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.