Preparar o app para as mudanças de redimensionamento e orientação no Android 17
Leitura de 6 min
Com o lançamento do Android 16 em 2025, compartilhamos nossa visão de um ecossistema de dispositivos em que os apps se adaptam perfeitamente a qualquer tela, seja um smartphone, dobrável, tablet, computador, tela de carro ou XR. Os usuários esperam que os apps funcionem em qualquer lugar. Seja para realizar várias tarefas em um tablet, abrir um dispositivo para ler com mais conforto ou executar apps em um ambiente de modo janela para computador, os usuários esperam que a interface preencha o espaço de exibição disponível e se adapte à postura do dispositivo.
Fizemos mudanças significativas nas APIs de orientação e redimensionamento para facilitar o comportamento adaptável, além de oferecer uma desativação temporária para ajudar na transição. Muitos desenvolvedores já se adaptaram com sucesso a essa transição ao segmentar o nível desejado da API 36.
Agora, com o lançamento da versão Beta do Android 17, estamos passando para a próxima fase do nosso roteiro adaptativo: o Android 17 (nível 37 da API) remove a opção de desativação para desenvolvedores em relação às restrições de orientação e redimensionamento em dispositivos de tela grande (sw > 600 dp). Ao segmentar o nível desejado da API 37, seu app precisa ser capaz de se adaptar a vários tamanhos de tela.
As mudanças de comportamento garantem que o ecossistema Android ofereça uma experiência consistente e de alta qualidade em todos os formatos de dispositivo.
O que vai mudar no Android 17
Os apps destinados ao Android 17 precisam garantir a compatibilidade com a desativação gradual de atributos de manifesto e APIs de ambiente de execução introduzidos no Android 16. Sabemos que, para alguns apps, essa pode ser uma grande transição. Por isso, incluímos práticas recomendadas e ferramentas para ajudar a evitar problemas comuns mais adiante neste post do blog.
Nenhuma mudança nova foi introduzida desde o Android 16, mas a desativação para desenvolvedores não é mais possível. Lembrete: quando o app é executado em uma tela grande, ou seja, em que a menor dimensão da tela é maior ou igual a 600 dp, os seguintes atributos de manifesto e APIs são ignorados:
Observação: como mencionado anteriormente com o Android 16, essas mudanças não se aplicam a telas menores que sw 600 dp ou apps categorizados como jogos com base na flag android:appCategory.
| Atributos de manifesto/API | Valores ignorados |
| screenOrientation | portrait, reversePortrait, sensorPortrait, userPortrait, landscape, reverseLandscape, sensorLandscape, userLandscape |
| setRequestedOrientation() | portrait, reversePortrait, sensorPortrait, userPortrait, landscape, reverseLandscape, sensorLandscape, userLandscape |
| resizeableActivity | todos |
| minAspectRatio | todos |
| maxAspectRatio | todos |
Além disso, os usuários mantêm o controle. Nas configurações de proporção, os usuários podem ativar explicitamente o comportamento solicitado pelo app.
Preparar o app
Os apps precisarão oferecer suporte a layouts de paisagem e retrato para tamanhos de tela em toda a gama de proporções em que os usuários podem optar por usar apps, incluindo janelas redimensionáveis, já que não será mais possível restringir a proporção e a orientação para retrato ou paisagem.
Testar seu app
A primeira etapa é testar o app com essas mudanças para garantir que ele funcione bem em todos os tamanhos de tela.
Use o Android 17 Beta 1 com os emuladores das séries Pixel Tablet e Pixel Fold no Android Studio e defina o targetSdkPreview = “CinnamonBun”. Como alternativa, use o framework de compatibilidade de apps ativando a flag UNIVERSAL_RESIZABLE_BY_DEFAULT se o app ainda não tiver o nível 36 da API como destino.
Temos outras ferramentas para garantir que seus layouts se adaptem corretamente. É possível auditar automaticamente sua interface e receber sugestões para torná-la mais adaptável com a Verificação de interface do Compose, além de simular características de exibição específicas nos testes usando DeviceConfigurationOverride.
Para apps que historicamente restringem a orientação e a proporção, é comum ver problemas com visualizações de câmera distorcidas ou com orientação incorreta, layouts esticados, botões inacessíveis ou perda do estado do usuário ao processar mudanças de configuração.
Vamos analisar algumas estratégias para lidar com esses problemas comuns.
Garantir a compatibilidade da câmera
Um problema comum em dispositivos dobráveis no modo paisagem ou em cálculos de proporção em cenários como várias janelas, modo janela para computador ou telas conectadas é quando a visualização da câmera aparece esticada, girada ou cortada.
Verifique se a visualização da câmera não está esticada ou girada.
Esse problema costuma acontecer em dispositivos dobráveis e de tela grande porque os apps presumem relações fixas entre os recursos da câmera (como proporção e orientação do sensor) e do dispositivo (como orientação do dispositivo e orientação natural).
Para garantir que a prévia da câmera se adapte corretamente a qualquer tamanho ou orientação de janela, considere estas quatro soluções:
Solução 1: Jetpack CameraX (preferencial)
A solução mais simples e robusta é usar a biblioteca CameraX do Jetpack. O elemento de interface PreviewView foi projetado para lidar com todas as complexidades de visualização automaticamente:
PreviewViewajusta corretamente a orientação do sensor, a rotação do dispositivo e o dimensionamento.- A PreviewView mantém a proporção da imagem da câmera, normalmente centralizando e cortando (
FILL_CENTER). - Você pode definir o tipo de escala como
FIT_CENTERpara aplicar o efeito letterbox à visualização, se necessário.
Para mais informações, consulte Implementar uma prévia na documentação do CameraX.
Solução 2: CameraViewfinder
Se você estiver usando uma base de código Camera2, a biblioteca CameraViewfinder (compatível com versões anteriores até o nível 21 da API) é outra solução moderna. Ele simplifica a exibição da transmissão da câmera usando um TextureView ou SurfaceView e aplicando todas as transformações necessárias (proporção, escala e rotação) para você.
Para mais informações, consulte a postagem do blog Apresentação do visor da câmera e o guia para desenvolvedores Visualização da câmera.
Solução 3: implementação manual da Camera2
Se não for possível usar o CameraX ou o CameraViewfinder, calcule manualmente a orientação e a proporção e verifique se os cálculos são atualizados a cada mudança de configuração:
- Receba a orientação do sensor da câmera (por exemplo, 0, 90, 180, 270 graus) de
CameraCharacteristics. - Acessar a rotação atual da tela do dispositivo (por exemplo, 0, 90, 180, 270 graus)
- Use a orientação do sensor da câmera e os valores de rotação da tela para determinar as transformações necessárias para o
SurfaceViewouTextureView. - Verifique se a proporção da saída
Surfacecorresponde à proporção da visualização da câmera para evitar distorções.
Importante: o app de câmera pode estar sendo executado em uma parte da tela, no modo de várias janelas ou modo janela para computador ou em uma tela conectada. Por esse motivo, o tamanho da tela não deve ser usado para determinar as dimensões do visor da câmera. Em vez disso, use as métricas de janela. Caso contrário, a visualização da câmera pode ficar esticada.
Para mais informações, consulte o guia para desenvolvedores Visualização da câmera e o vídeo Seu app de câmera em diferentes formatos.
Solução 4: realizar ações básicas da câmera usando uma intent
Se você não precisa de muitos recursos de câmera, uma solução simples e direta é realizar ações básicas, como capturar uma foto ou um vídeo usando o app de câmera padrão do dispositivo. Nesse caso, basta usar uma Intent em vez de fazer a integração com uma biblioteca de câmera, para facilitar a manutenção e a adaptabilidade.
Para mais informações, consulte Intents de câmera.
Evite interfaces esticadas ou botões inacessíveis
Se o app pressupõe uma orientação específica do dispositivo ou uma proporção de tela, ele pode ter problemas quando usado em várias orientações ou tamanhos de janela.
Confira se os botões, campos de texto e outros elementos não estão esticados em telas grandes.
Talvez você tenha definido botões, campos de texto e cards como fillMaxWidth ou match_parent. Em um smartphone, isso fica ótimo. No entanto, em um tablet ou dobrável no modo paisagem, os elementos da interface se estendem por toda a tela grande. No Jetpack Compose, use o modificador widthIn para definir uma largura máxima para os componentes e evitar que o conteúdo seja esticado:
Box(
contentAlignment = Alignment.Center,
modifier = Modifier.fillMaxSize()
) {
Column(
modifier = Modifier
.widthIn(max = 300.dp) // Prevents stretching beyond 300dp
.fillMaxWidth() // Fills width up to 300dp
.padding(16.dp)
) {
// Your content
}
}Se um usuário abrir o app na orientação paisagem em um dobrável ou tablet, os botões de ação, como Salvar ou Login, na parte de baixo da tela, podem ser renderizados fora dela. Se o contêiner não for rolável, o usuário poderá ser impedido de continuar. No Jetpack Compose, é possível adicionar um modificador verticalScroll ao componente:
Column(
modifier = Modifier
.fillMaxSize()
.verticalScroll(rememberScrollState())
.padding(16.dp)
)Ao combinar restrições de largura máxima com a rolagem vertical, você garante que o app permaneça funcional e utilizável, não importa o tamanho da janela.
Consulte nosso guia sobre como criar layouts adaptáveis.
Preservar o estado com mudanças de configuração
Remover as restrições de orientação e proporção significa que o tamanho da janela do app vai mudar com muito mais frequência. Os usuários podem girar o dispositivo, dobrar/desdobrar ou redimensionar o app de forma dinâmica nos modos de tela dividida ou modo janela para computador.
Por padrão, essas mudanças de configuração destroem e recriam sua atividade. Se o app não gerenciar esse evento de ciclo de vida corretamente, os usuários terão uma experiência frustrante: as posições de rolagem serão redefinidas para o topo, os formulários preenchidos pela metade serão apagados e o histórico de navegação será perdido. Para garantir uma experiência adaptável perfeita, é fundamental que o app preserve o estado durante essas mudanças de configuração. Com o Jetpack Compose, você pode desativar a recriação e permitir que as mudanças no tamanho da janela recomponham a interface para refletir a nova quantidade de espaço disponível.
Consulte nosso guia sobre como salvar o estado da interface.
Segmentação do nível desejado da API 37 até agosto de 2027
Se o app tiver recusado essas mudanças ao segmentar o nível 36 da API, ele só será afetado pela remoção da desativação do Android 17 depois que segmentar o nível 37 da API. Para ajudar você a se planejar e fazer os ajustes necessários no seu app, confira o cronograma de quando essas mudanças vão entrar em vigor:
- Android 17: as mudanças descritas acima serão a experiência de referência para dispositivos de tela grande (menor largura de tela > 600 dp) em apps que usam o nível 37 da API. Os desenvolvedores não terão a opção de recusar.
Os prazos para segmentar um nível da API específico são específicos da app store. No Google Play, os novos apps e atualizações precisarão ter como nível desejado da API o 37, tornando esse comportamento obrigatório para distribuição em agosto de 2027.
Preparação para o Android 17
Consulte a página de mudanças do Android 17 para ver todas as mudanças que afetam os apps no Android 17. Para testar seu app, faça o download do Android 17 Beta 1 e atualize para o targetSdkPreview = “CinnamonBun” ou use o framework de compatibilidade de apps para ativar mudanças específicas.
O futuro do Android é adaptável, e estamos aqui para ajudar você a chegar lá. Enquanto você se prepara para o Android 17, recomendamos que consulte nossos guias para criar layouts adaptáveis e nossas diretrizes de qualidade para telas grandes. Esses recursos foram criados para ajudar você a lidar com vários formatos e tamanhos de janela com confiança.
Não espere. Comece a se preparar para o Android 17 hoje mesmo.
-
Notícias sobre produtosHoje, no Galaxy Unpacked, a Samsung revelou sua mais nova linha de dispositivos dobráveis e dispositivos wearables. Para os desenvolvedores, isso significa que a variedade de formatos, tamanhos de tela e posições de dispositivos que o app precisa aceitar está aumentando mais uma vez.
Fahd Imtiaz, Miguel Montemayor • Leitura de 3 min -
Notícias sobre produtosCom novos formatos, como o Pixel 10 Pro Fold, entrando no ecossistema Android, o desenvolvimento de apps adaptáveis é essencial para criar experiências de alta qualidade em smartphones, tablets e dobráveis.
Fahd Imtiaz, Miguel Montemayor • Leitura de 3 min -
Notícias sobre produtosApós mais de um ano de preparação conjunta com líderes do setor, parceiros regionais, App Distribution e comunidades do Android, nossas proteções ao usuário entraram em vigor em 30 de setembro para as lojas participantes no Brasil, na Indonésia, em Singapura e na Tailândia.
Matthew Forsythe • Leitura de 2 min
Receba os insights mais recentes sobre o desenvolvimento para Android na sua caixa de entrada toda semana.