Substituições de usuários por app em telas grandes

O Android oferece substituições que mudam o comportamento configurado dos apps.

Os fabricantes de dispositivos podem aplicar substituições a apps em determinados dispositivos de tela grande. O QPR1 do Android 14 apresenta as substituições do usuário, que permitem que os usuários apliquem substituições aos apps nas configurações do dispositivo.

As substituições por app têm o objetivo de melhorar a experiência do usuário em dispositivos de tela grande. Os apps podem desativar algumas substituições.

Para mais informações sobre substituições por app, consulte Modo de compatibilidade com telas grandes.

Substituições do usuário

O QPR1 do Android 14 apresenta um novo menu de configuração que permite aos usuários mudar a proporção dos apps para melhorar a forma como eles são mostrados em telas grandes. O menu é implementado nas configurações do dispositivo em alguns dispositivos de tela grande.

Nos dispositivos que implementaram o menu de configuração, os usuários escolhem em uma lista de apps e definem a proporção deles com diversos valores, como 4:3, 16:9 e tela cheia. Os valores de proporção são configurados pelo fabricante do dispositivo. Os usuários também podem redefinir a proporção para o padrão do app, que é o valor especificado por uma substituição por app do fabricante do dispositivo (consulte OVERRIDE_MIN_ASPECT_RATIO). Se nenhuma substituição tiver sido aplicada ou o app tiver desativado a substituição, use o valor no manifesto do app.

Desativar as substituições

O QPR1 do Android 14 oferece suporte às tags PackageManager.Property abaixo, que permitem desativar ou modificar o menu de configuração da proporção em dispositivos que implementaram a substituição:

• PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE (em inglês)

  Para desativar a substituição de compatibilidade da proporção do usuário, adicione a propriedade ao manifesto do app e defina o valor como false:

  <application>
      <property
          android:name="android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE"
          android:value="false"/>
  </application>
  

  Nos dispositivos que implementaram o menu de configuração, o app é excluído da lista de apps nas configurações do dispositivo. Assim, os usuários não podem substituir a proporção dele.

  Definir a propriedade como true não tem efeito.

  
  

• PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE (em inglês)

  Para desativar a opção de tela cheia da substituição de compatibilidade da proporção do usuário, adicione a propriedade ao manifesto do app e defina o valor como false:

  <application>
      <property
          android:name="android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE"
          android:value="false"/>
  </application>
  

  Nos dispositivos que implementaram o menu de configuração, a opção "Tela cheia" é removida da lista de opções de proporção nas configurações. Os usuários não podem aplicar a substituição de tela cheia ao app.

  Definir essa propriedade como true não tem efeito.

Otimizar o app para telas grandes:não defina restrições de proporção. Use classes de tamanho de janela para oferecer suporte a diferentes layouts com base na quantidade de espaço de exibição disponível.