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 dispositivos de tela grande selecionados. O QPR1 do Android 14 apresenta substituições de usuário, que permitem aplicar 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 oferecer a melhor experiência do usuário no seu app 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 de 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 aparelhos 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 da tela do app para vários valores, como 4:3, 16:9 e tela cheia. Os valores de proporção da tela 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) ou, se nenhuma substituição foi aplicada ou o app desativou a substituição, o valor no manifesto do app.

Desativar as substituições

O QPR1 do Android 14 é compatível com as seguintes tags PackageManager.Property, que permitem desativar ou modificar o menu de configuração da proporção da tela 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 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 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 da tela 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 da tela 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 da tela nas configurações do dispositivo. Os usuários não conseguem aplicar a substituição de tela cheia ao seu app.

  Definir essa propriedade como true não tem efeito.

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