Substituições por app de usuários 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 alguns dispositivos de tela grande. O QPR1 do Android 14 apresenta substituições do usuário, que permitem que os usuários apliquem substituições a 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 do dispositivo.

Observação: para que o app ofereça a melhor experiência do usuário sem depender de substituições do fabricante do dispositivo ou do usuário, siga as diretrizes de qualidade de apps para telas grandes.

Substituições do usuário

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

Em dispositivos que implementaram o menu de configuração, os usuários escolhem em uma lista de apps e definem a proporção do app para vários 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 um fabricante do dispositivo por substituição por app (consulte OVERRIDE_MIN_ASPECT_RATIO) ou, se nenhuma substituição tiver sido aplicada ou o app tiver desativado a substituição, o valor no manifesto do app.

Desativar as substituições

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

Observação: as tags de propriedade são constantes WindowProperties do Jetpack WindowManager, que podem não estar disponíveis ou testadas em todos os dispositivos.

• PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE

  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>
  

  Em 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 do app.

  Definir a propriedade como true não tem efeito.

  
  

• PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE

  Para desativar a opção de tela cheia da substituição de compatibilidade de 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>
  

  Em dispositivos que implementaram o menu de configuração, a opção de tela cheia é removida da lista de opções de proporção nas configurações do dispositivo. Os usuários não conseguem aplicar a substituição em tela cheia ao app.

  Definir essa propriedade como true não tem efeito.

  Atenção: se PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE for definido como false, essa propriedade não terá efeito.

Observação: para implementar as tags de propriedade, o app precisa incluir a dependência da biblioteca WindowManager do Jetpack.

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