Orientação, proporção e capacidade de redimensionamento do app

Os apps Android são executados em dispositivos de todos os tipos: smartphones, tablets, dobráveis, dispositivos ChromeOS, carros, TVs e até XR. Para se adaptar a esse ambiente variado, o app precisa oferecer suporte a todos os formatos de dispositivo e tamanhos de tela.

O Android 16 (nível 36 da API) permite que os apps se adaptem a diferentes formatos e tamanhos de tela, substituindo as restrições de orientação, proporção e redimensionamento. As substituições se aplicam a dispositivos com menor largura >= 600 dp, que define o seguinte:

  • Tablets
  • Telas internas de dispositivos dobráveis com tela grande
  • Modo janela para computador (em todos os formatos)

Os apps que têm como nível desejado da API o 36 são redimensionáveis e podem entrar no modo de várias janelas (equivalente a resizeableActivity="true") se a menor largura da tela for >= 600 dp.

O app é exibido com efeito letterbox em um dispositivo de tela grande aberto antes do Android 16, mas em tela cheia quando direcionado ao Android 16. O app mostra mais notícias em tela cheia do que em letterbox.
Figura 1. O feed de notícias para desenvolvedores, que antes aparecia em formato letterbox em dispositivos de tela grande (à esquerda), agora é executado em tela cheia ao segmentar o Android 16 (à direita).

O Android 16 aplica um modelo consistente de design de app adaptável que otimiza a experiência do usuário, respeitando as preferências de orientação do dispositivo, proporção e tamanho da tela.

Alterações

Os seguintes atributos de manifesto e APIs são ignorados para apps direcionados ao Android 16 (nível 36 da API) em telas grandes:

Atributo ou API Valores ignorados
screenOrientation portrait, landscape, reversePortrait, reverseLandscape, sensorPortrait, sensorLandscape, userPortrait, userLandscape
resizeableActivity todos
minAspectRatio todos
maxAspectRatio todos
setRequestedOrientation()

getRequestedOrientation()
portrait, landscape, reversePortrait, reverseLandscape, sensorPortrait, sensorLandscape, userPortrait, userLandscape

Exceções

As exceções às mudanças do Android 16 incluem:

  • Telas menores que sw600dp (a maioria dos smartphones, dispositivos flip e telas externas de dobráveis de tela grande)

  • Jogos, com base na flag android:appCategory

    Publique seu jogo usando Android App Bundles e a Assinatura de apps do Google Play, permitindo que o Google Play gerencie a flag e ofereça os benefícios dos pacotes de apps automaticamente. Consulte também a Visão geral do manifesto do app.

  • O usuário ativa o comportamento padrão do app nas configurações de proporção

Desativar

Para desativar o comportamento do nível 36 da API, declare a propriedade de manifesto PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY.

Para desativar uma atividade específica, defina a propriedade no elemento <activity>:

<activity ...>
    <property
        android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY"
        android:value="true" />
    ...
</activity>

Para desativar o recurso em todo o app, defina a propriedade no elemento <application>:

<application ...>
    <property
        android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY"
        android:value="true" />
    ...
</application>

Se o app for direcionado ao Android 16 (nível 36 da API) ou mais recente, essa propriedade não vai bloquear a orientação da tela nem impedir a rotação em telas grandes.

Testes

Para testar se o app é afetado pelas mudanças do Android 16, use os emuladores das séries Pixel Tablet e Pixel Fold no Android Studio e defina targetSdkPreview = "Baklava" no arquivo build.gradle do módulo do app.

Ou use o framework de compatibilidade de apps nos seus dispositivos de teste ativando a flag UNIVERSAL_RESIZABLE_BY_DEFAULT (consulte Ferramentas do framework de compatibilidade).

É possível automatizar os testes com o framework de teste Espresso e as APIs de teste do Jetpack Compose.

Guia de implementação

Os apps que restringem a orientação do dispositivo, a proporção ou a capacidade de redimensionamento podem ter problemas de exibição no Android 16, como layouts sobrepostos. Para oferecer uma experiência do usuário ideal em smartphones, dobráveis, tablets, dispositivos ChromeOS e muito mais, crie um app responsivo e adaptável.

Lista de verificação de prontidão

Use a lista de verificação a seguir para garantir que o app esteja pronto para as mudanças do Android 16:

  • Evite componentes de interface esticados: layouts projetados para telas de smartphone padrão no modo retrato podem não se ajustar a outras proporções. Por exemplo, os elementos da interface que preenchem toda a largura da tela podem parecer esticados na orientação paisagem. Adicione uma largura máxima aos componentes para evitar que eles se estiquem.
  • Ative a rolagem de layouts: se os layouts não rolarem, talvez os usuários não consigam acessar botões ou outros elementos da interface que estão fora da tela na orientação paisagem. Ative a rolagem nos layouts do app para verificar se todo o conteúdo está acessível, independentemente da altura da tela.
  • Verifique a compatibilidade da câmera nos modos retrato e paisagem: as visualizações do visor da câmera que assumem uma proporção e orientação específicas em relação ao sensor da câmera podem resultar em visualizações esticadas ou invertidas em telas não compatíveis. Verifique se os visores giram corretamente com as mudanças de orientação. Permita que os visores se ajustem às proporções da interface que são diferentes da proporção do sensor.
  • Preservar o estado durante mudanças no tamanho da janela: a remoção das restrições de orientação e proporção pode resultar em mudanças frequentes no tamanho da janela do app em resposta à forma como os usuários preferem usar um app, por exemplo, girando, dobrando ou desdobrando um dispositivo ou redimensionando um app no modo de várias janelas ou modo janela para computador. Mudanças de configuração, como mudanças de orientação e redimensionamento de janela, causam a recriação de atividades (por padrão). Para oferecer uma experiência ideal ao usuário, preserve o estado do app para que ele retenha dados (como entradas de formulário) e os usuários possam manter o contexto.
  • Use classes de tamanho de janela: ofereça suporte a diferentes tamanhos e proporções de janela sem personalizações específicas do dispositivo. Presuma que os tamanhos das janelas vão mudar com frequência. Use classes de tamanho de janela para caracterizar as dimensões da janela e aplique um layout adaptável adequado.
  • Criar layouts responsivos: nas classes de tamanho de janela, os layouts responsivos se ajustam às mudanças nas dimensões da tela para sempre criar uma apresentação ideal do app.

Para um guia prático sobre como criar layouts adaptáveis no Compose, consulte o codelab Criar apps adaptáveis com o Jetpack Compose. Se você estiver migrando um app que usa visualizações, consulte Estratégia de adoção do Compose.

Cronograma

  • Android 16 (2025): o suporte a todas as orientações e proporções e ao redimensionamento de apps é a experiência básica para dispositivos de tela grande (largura de tela menor >= 600 dp) para apps que segmentam o nível desejado da API 36. No entanto, os desenvolvedores podem desativar essa opção.
Nível desejado da API Dispositivos aplicáveis Desativação permitida para desenvolvedores
36 (Android 16) Dispositivos com tela grande (menor largura de tela >= 600 dp) Sim

Os prazos para segmentar níveis específicos de API são específicos de cada app store. O Google Play vai exigir que os apps sejam direcionados ao nível desejado da API 36 a partir de agosto de 2026.

Outros recursos