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 alguns dispositivos de tela grande. O QPR1 do Android 14 apresenta substituições de 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 de dispositivo.

Observação: para permitir que o app ofereça a melhor experiência do usuário sem depender do fabricante do dispositivo nem das substituições do usuário, siga as diretrizes de qualidade de apps para 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 exibição deles em telas grandes. O menu é implementado nas configurações do dispositivo em alguns dispositivos de tela grande.

Em dispositivos com o menu de configuração implementado, os usuários escolhem uma opção em uma lista de apps e definem a proporção do app como vários valores, como 4:3, 16:9 e tela cheia (os valores da 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 do fabricante do dispositivo por app (consulte OVERRIDE_MIN_ASPECT_RATIO). Se nenhuma substituição tiver sido aplicada ou o app a tiver desativado, 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 de proporção em dispositivos que implementaram a substituição:

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

• PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE (em inglês)

  Para desativar a 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_OVERRIDE"
          android:value="false"/>
  </application>
  

  Em dispositivos com o menu de configuração implementado, seu app é excluído da lista nas configurações do dispositivo. Por isso, os usuários não podem modificar 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 da compatibilidade com 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 com o menu de configuração implementado, 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 podem aplicar a substituição de tela cheia ao app.

  Definir essa propriedade como true não tem efeito.

  Cuidado: se PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE estiver 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 o app para telas grandes:não defina restrições de proporção no app. Use classes de tamanho de janela para oferecer suporte a diferentes layouts com base na quantidade de espaço de exibição disponível.