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 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 como objetivo 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 o Modo de compatibilidade do dispositivo.

Observação: para que seu app ofereça a melhor experiência do usuário sem depender do fabricante do dispositivo ou 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 em telas grandes. O menu é implementado nas configurações do dispositivo em dispositivos de tela grande selecionados.

Em dispositivos que implementaram o menu de configuração, os usuários escolhem 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 uma substituição por app do fabricante do dispositivo (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 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 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, seu 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 podem 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, seu app precisa incluir a dependência da biblioteca Jetpack WindowManager.

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 na quantidade de espaço de exibição disponível.