A era do iPhone redimensionável: prepare seu app antes de setembro

Como preparar um app de iPhone para telas redimensionáveis? O SDK contra o qual você faz o link é a linha que a Apple traça: o Device Hub do Xcode 27 trata explicitamente o modo de redimensionamento como não suportado para apps linkados contra o iOS 26 ou anterior, e toda entrada sobre redimensionamento nas notas de versão do iOS 27 vem condicionada a “compilado com o SDK do iOS 27”.¹² Depois: audite cada suposição de tamanho fixo (leituras de UIScreen.main.bounds, frames fixos no código, layouts condicionados à orientação), apoie-se nas classes de tamanho e nos contêineres do SwiftUI que se adaptam ao layout, e teste continuamente nos previews Resizable Canvas do Xcode 27 e no modo de redimensionamento do Device Hub.² O pré-requisito de orientação que travava o redimensionamento contínuo aparece como Fixed nas notas atuais, então o caminho está livre.¹

As betas de outono da Apple passaram o verão convergindo para uma única mensagem aos desenvolvedores de iPhone: pare de assumir um retângulo fixo. A evidência está no ferramental e nas notas de versão, não nos keynotes: o redimensionamento chega com o link para o SDK do iOS 27, o canvas de preview redimensiona à vontade, e as notas de versão removeram o último obstáculo estrutural conforme o ciclo de betas amadureceu. Seja qual for o hardware que chegar neste outono, o contrato de software já mudou.

TL;DR: o iOS 27 traz redimensionamento contínuo para apps compilados com o novo SDK; o Xcode 27 entrega as superfícies para testar isso (previews Resizable Canvas, modo de redimensionamento do Device Hub); e as notas de versão atuais — a edição da beta 7, com a beta 7 liberada em 24 de agosto — listam a condição de orientação como Fixed: ela saiu dos problemas conhecidos para os problemas resolvidos entre as edições da beta 4 e da beta 6, e as orientações declaradas não decidem mais se o seu app redimensiona.¹ O trabalho é sobretudo de subtração: encontre os lugares em que o seu layout acredita em um único tamanho de tela e remova essa crença. Abaixo, o checklist, na ordem em que eu o percorreria.

Por que agora

Três fatos datados acertam o relógio:

1. A beta 7 chegou em 24 de agosto, com o ciclo em sua fase de estabilidade: as betas tardias da Apple corrigem em vez de acrescentar, e as versões finais saíram em setembro todos os anos.¹
2. A fronteira do redimensionamento é o link com o SDK. As notas de versão do Xcode 27 descrevem entrar no modo de redimensionamento do Device Hub “com um app linkado contra um SDK do iOS 26 ou anterior” como algo “não suportado”.² O padrão atravessa também as notas do iOS: toda entrada sobre redimensionamento vem condicionada a “compilado com o SDK do iOS 27”. Recompile e você estará do lado redimensionável dessa linha; fique no SDK antigo e estará abrindo mão do rumo que a plataforma tomou.
3. A última trava estrutural caiu. Na era da beta 4, um app de iPad cujo UISupportedInterfaceOrientations omitia qualquer uma das quatro orientações era tratado como não redimensionável de forma contínua: um problema conhecido cuja solução documentada tinha um custo não documentado que detalhei no post sobre essa solução de contorno. Esse problema saiu dos problemas conhecidos e entrou nos resolvidos entre as edições da beta 4 e da beta 6 das notas, e a edição atual o marca como Fixed: “A partir do iOS 27, as orientações de interface suportadas não devem mais ser uma condição para o redimensionamento contínuo”. A lista de problemas conhecidos do UIKit nas notas da beta 7 está vazia.¹

Somando tudo: a plataforma agora espera que o seu layout seja função do contêiner, e não de uma ficha técnica de aparelho. O iPad ensinou essa lição primeiro com o multitarefa; o iOS 27 estende o mesmo contrato ao iPhone.

O checklist

1. Recompile com o SDK do iOS 27 e depois olhe de verdade

A adesão é a recompilação. Antes de mudar uma linha de código de layout, compile com o Xcode 27, abra o modo de redimensionamento do Device Hub e arraste. A maioria dos apps SwiftUI bem fatorados sobrevive a esse primeiro contato melhor do que seus autores esperam; o que quebra é instrutivo, e quebra sempre no mesmo punhado de lugares — que é justamente do que trata o resto deste checklist.

2. Cace as crenças de tamanho fixo

Os culpados clássicos, na ordem em que costumam morder:

• UIScreen.main.bounds usado como “o tamanho da tela”. Em um mundo redimensionável não existe o tamanho da tela, e UIScreen.main está formalmente descontinuado desde o iOS 26. Derive os tamanhos da sua window scene ou, no SwiftUI, do contêiner, via um GeometryReader usado com parcimônia ou um containerRelativeFrame(_:) usado deliberadamente.
• Frames fixos no código e números mágicos calibrados para aparelhos específicos (“390 pontos de largura significa iPhone”). Qualquer inferência de aparelho do tipo if width == <number> vai mentir para você.
• Layout condicionado à orientação em vez do tamanho. As verificações de orientação sempre foram um substituto; com o iOS 27 desacoplando orientações do redimensionamento, esse substituto virou oficialmente peso morto. Ramifique pelas classes de tamanho horizontal e vertical, que é para isso que elas existem.
• Cache de dimensões no lançamento. Tudo que é medido uma única vez na inicialização e guardado fica obsoleto depois do primeiro redimensionamento.

3. Deixe os contêineres adaptáveis fazerem o trabalho deles

O kit de layout moderno do SwiftUI foi feito exatamente para isso: ViewThatFits para escolher entre arranjos, containerRelativeFrame para dimensionar em relação ao contêiner em vez da tela, grids e frames flexíveis para tudo que fica no meio. Se o seu app vem da era do retângulo fixo, a refatoração de maior alavancagem costuma ser trocar um layout estrutural feito de GeometryReader mais aritmética por essas primitivas. Apps UIKit chegam ao mesmo resultado com classes de tamanho e as seções dirigidas pelo ambiente do UICollectionViewCompositionalLayout.

As mudanças de toolbar e de layout no iOS 27 empurram na mesma direção: o framework agora entrega controle explícito nos pontos em que o espaço acaba, e o espaço agora acaba dinamicamente.

4. Teste onde o redimensionamento realmente acontece

O Xcode 27 dá duas superfícies feitas para isso, ambas amadurecidas no início do ciclo de betas:

• O modo Resizable Canvas nos previews: não está mais restrito a proporções de tamanho específicas (a restrição caiu na beta 2), então dá para arrastar por toda a faixa de formatos que o seu app pode habitar.²
• O modo de redimensionamento do Device Hub para apps em execução, com as saídas de emergência corrigidas desde a beta 3 (sair do modo de redimensionamento por crash ou indo para segundo plano não trava mais a tela do aparelho até reiniciar).²

Faça uma passagem por cada tela principal em cada um deles. Os bugs que você encontrar vão se concentrar nas telas que faziam cache, supunham ou inferiam.

5. Reexamine as flags que você definiu anos atrás

UIRequiresFullScreen e declarações restritas de UISupportedInterfaceOrientations são como os apps historicamente se livraram das exigências do multitarefa do iPad. Nenhuma das duas está descontinuada, mas as duas agora são estruturais de formas novas: o ciclo de betas passou várias edições acertando como elas interagem com o redimensionamento contínuo, e os problemas conhecidos da era da beta 4 sobre o comportamento de redimensionamento do UIRequiresFullScreen agora aparecem como Fixed entre os problemas resolvidos.¹ Se essas chaves estão no seu Info.plist por causa de uma decisão tomada em 2019, este é o mês de tomar essa decisão de novo, de propósito. A análise do custo da solução de contorno cobre os efeitos colaterais do conjunto de orientações que vale conferir antes de ampliar qualquer coisa.

6. Reserve espaço para os efeitos de segunda ordem

Redimensionável significa que o seu texto quebra de outro jeito, suas imagens cortam de outro jeito, sua NavigationSplitView recolhe e expande ao sabor de alguém, e seus estados vazios cuidadosamente ajustados aparecem em proporções que você nunca visualizou no preview. Nada disso é difícil isoladamente. Tudo isso junto é o motivo de o checklist começar agora, e não na semana em que o hardware chegar.

O que eu pularia

Pule especular sobre aparelhos específicos. O contrato de redimensionamento está no SDK que você pode baixar hoje, documentado em notas de versão que você pode ler hoje, testável em um ferramental que saiu na primeira beta do Xcode 27. Se um iPhone dobrável chegar neste outono, os apps que fizeram a lista acima estão prontos; se chegar na primavera que vem, o mesmo trabalho já se paga no multitarefa do iPad e em qualquer outra coisa que a plataforma redimensionar depois. Preparar-se para o mecanismo vence preparar-se para o boato.

Principais conclusões

• A linha de adesão é o link com o SDK. Recompile com o SDK do iOS 27 e o redimensionamento vira problema e oportunidade do seu app; o Device Hub trata apps de SDK mais antigo no modo de redimensionamento como não suportados.²
• A trava de orientação caiu. As orientações declaradas não decidem mais o redimensionamento: o problema aparece como Fixed nas notas atuais, e a lista de problemas conhecidos do UIKit está vazia.¹
• O trabalho é apagar suposições, não adicionar recursos. Leituras de tamanho de tela, layouts com números mágicos, substitutos de orientação, caches de inicialização: encontre, troque por layout derivado do contêiner, pronto.
• Teste nas superfícies reais. Os previews Resizable Canvas e o modo de redimensionamento do Device Hub existem exatamente para isso; uma passagem por cada um, tela a tela, acha a maior parte do que vai morder.

FAQ

O meu app fica redimensionável automaticamente?

O link com o SDK é a fronteira que a Apple traça: as notas de versão do Xcode 27 chamam de não suportado o modo de redimensionamento com apps de SDK do iOS 26 ou anterior, e as notas do iOS condicionam todo comportamento de redimensionamento a compilar com o SDK do iOS 27.¹² O que acontece depois depende do seu layout: SwiftUI dirigido pelo contêiner se adapta na maior parte; suposições de tamanho fixo aparecem como bugs.

Ainda preciso declarar as quatro orientações para ser redimensionável de forma contínua?

Não: as notas de versão atuais marcam a condição de orientação como Fixed (ela caiu entre as edições da beta 4 e da beta 6), afirmando que “as orientações de interface suportadas não devem mais ser uma condição para o redimensionamento contínuo”.¹ As betas anteriores exigiam a solução das quatro orientações, que tinha efeitos colaterais em todo o app que vale a pena entender se você chegou a publicá-la.

O UIRequiresFullScreen está descontinuado agora?

Não. Ele continua sendo uma chave suportada, e os problemas conhecidos do ciclo de betas sobre o seu comportamento de redimensionamento aparecem como Fixed entre os problemas resolvidos das notas atuais.¹ Mas é exatamente o tipo de renúncia de anos atrás que vale a pena redecidir de forma deliberada em uma plataforma que pensa primeiro em redimensionamento.

Quando isso vira urgente?

As versões finais do iOS 27 são esperadas para setembro, e o ciclo de exigência de SDK do outono da Apple significa que os novos envios passam para o SDK do iOS 27 no cronograma habitual da Apple depois disso. O checklist acima é uma semana de trabalho concentrado para a maioria dos apps — tranquilamente concluído antes da temporada de lançamentos se começar agora.

Fontes