iPhone Duo para desenvolvedores: o problema do 1.42 e a lacuna do SDK

O que o iPhone Duo muda para quem desenvolve para iOS? Duas telas com um formato que nenhum iPhone teve, Split View e multitarefa de duas janelas em um telefone pela primeira vez, StandBy em uma tela voltada para o ambiente, Touch ID no lugar do Face ID e uma data de lançamento em 23 de outubro, com o iOS 27.1. Nem as release notes do iOS 27 nem as do Xcode 27 mencionam o aparelho, nem no release candidate de 9 de setembro nem na versão final de 14 de setembro. A página para desenvolvedores da Apple marca o beta do Xcode 27.1 e o guia de preparação do app como “later this month” (15 de outubro: o Xcode 27.1 saiu como versão final, build 27A9275²⁴); o guia de design chegou às Human Interface Guidelines na mesma tarde, e seis Tech Talks já estão no ar com as regras: um app roda no aparelho sem recompilar, só o SDK do iOS 27.1 alcança a borda da tela, e a tela interna informa classes de tamanho regulares nas duas dimensões.^145131419 A ficha técnica dá os números, e os Tech Talks dão as regras.

A Apple anunciou o iPhone Duo em 9 de setembro de 2026 e publicou a ficha técnica no mesmo dia.¹² A história para desenvolvedores começou mais magra que a do consumidor: uma frase sobre SDKs e o Device Hub, outra sobre apps de terceiros que já se adaptaram, e seis semanas até o aparelho chegar às lojas. No começo da tarde, a Apple já tinha acrescentado uma página para desenvolvedores e seis Tech Talks e, às 4:10 da tarde no horário do Pacífico, o guia de design, com o beta do SDK e o guia de preparação ainda por vir.¹³¹⁴¹⁶ Essa lacuna é o motivo para fazer as contas agora, em vez de esperar por um projeto de exemplo.

TL;DR: O tamanho de captura de tela que o App Store Connect define para a tela interna, publicado na tarde do keynote, é de 2007 por 2853 pixels, o que dá 669 por 951 pontos em 3x sobre um painel de 1878 por 2670; minha inferência é que a tela renderiza a 669 por 951 e reduz cerca de 6.4 por cento em cada dimensão, como faziam os iPhones Plus, à espera do Device Hub. A proporção é 1.42, perto da raiz de dois do papel da série A.²¹⁷ A tela externa tem 1398 por 2034 pixels, 466 por 678 pontos em 3x sem redução, mais larga que a de um iPhone 18 Pro e mais de um quinto mais curta.²³¹⁷ Os Tech Talks da Apple definem as regras. Um app compilado sem o SDK do iOS 27 roda em um tamanho familiar quando o aparelho está aberto, o SDK do iOS 27 o estende até a esquerda da barra de status, e só o SDK do iOS 27.1 chega à borda da tela. A tela interna informa classes de tamanho regulares nos dois eixos. Um app que suporta múltiplas instâncias no iPad também as suporta aqui, com janelas novas reservadas à tela interna, e um acessório de captura de câmera coloca uma UI na tela externa enquanto o app permanece na interna.¹⁴ O StandBy roda em qualquer uma das telas “mesmo quando não está carregando”.¹ O aparelho usa Touch ID, então qualquer string com “Use Face ID” está errada nele.²

Atualização, 10 de setembro: o App Store Connect implica 669 por 951 pontos na tela interna

A primeira versão deste texto derivou 626 por 890 pontos para a tela interna dividindo por três os 1878 por 2670 pixels da ficha técnica. As especificações de captura de tela do App Store Connect trazem uma linha do iPhone Duo, acrescentada em 9 de setembro segundo as notas de versão do App Store Connect, carimbada às 3 da tarde no horário do Pacífico pelo feed de releases da Apple e vista por mim pela primeira vez na manhã de 10 de setembro: 1398 por 2034 pixels para a tela externa e 2007 por 2853 pixels para a tela interna. As especificações de app preview listam os mesmos dois tamanhos sob o título “Device resolutions”, separam “Rendered pixels” de “Physical pixels” nos telefones Plus de 5.5 polegadas (2208 por 1242 contra 1920 por 1080) e observavam que o envio de materiais do iPhone Duo “estará disponível ainda este ano”, envio que a Apple abriu em 5 de outubro de 2026 (corrigido em 7 de outubro).¹⁷ O tamanho da tela externa é exatamente 466 por 678 pontos em 3x, os próprios pixels do painel. O da tela interna é 669 por 951 pontos em 3x, cerca de 6.9 por cento a mais em cada dimensão do que o painel tem. Minha inferência, supondo uma escala de 3x, é que a tela interna renderiza a 669 por 951 pontos e reduz o resultado em cerca de 6.4 por cento em cada dimensão até 1878 por 2670; o Device Hub vai confirmar ou corrigir isso. O App Store Connect tem um precedente para esse arranjo: ele ainda pede capturas de 1242 por 2208 para os iPhones Plus de 5.5 polegadas, cujos painéis tinham 1080 por 1920, e as diretrizes da Apple listavam esses telefones como 414 por 736 pontos em 3x sobre o painel de 1080 por 1920.¹¹¹⁷ Um segundo artefato da Apple aponta na mesma direção: o pacote de molduras de produto do iPhone Duo que a Apple publicou em sua página de Design Resources tem um recorte de tela interna de 2853 por 2007 pixels dentro de uma moldura de 3093 por 2247, o tamanho do App Store Connect no pixel, enquanto o recorte da tela externa tem os 1398 pixels de largura do painel.¹⁸ A aritmética abaixo está corrigida para 669 por 951 em todo o texto. A proporção, as classes de tamanho, as regras do SDK e os tamanhos físicos não mudam; mudam as larguras em pontos, os números do letterbox e os tamanhos a testar no Device Hub. Se a inferência se confirmar, uma consequência merece atenção: com 669 pontos de largura em um painel de 430 ppi, um ponto mede o mesmo que na tela externa, cerca de 153 pontos por polegada nas duas, então texto e controles mantêm um mesmo tamanho físico conforme o aparelho se abre.

Atualização, 15 de setembro: o Xcode 27 saiu sem o SDK do Duo

O feed Releases da Apple lista o Xcode 27 (27A266a), o iOS 27.0 (24A437) e o resto dos sistemas 27.0 na segunda-feira, 14 de setembro, e nenhuma das duas páginas de release notes finais menciona o aparelho: “Duo” não aparece nenhuma vez nas notas do iOS e iPadOS 27 nem nas do Xcode 27, obtidas em 15 de setembro pelo JSON de documentação da Apple, e o índice de release notes do Xcode continua listando uma única entrada 27.¹⁹ A página para desenvolvedores da Apple está igual ao dia 9 de setembro: “Xcode 27.1 beta. Get the latest SDKs to build, run, and test your app for iPhone Duo. Coming later this month”, com “Preparing your app for iPhone Duo” também em “Coming later this month”, e os Group Labs e as sessões de perguntas nas datas de setembro.¹⁹ A linha do App Store Connect de 9 de setembro também continuava de pé: “Support for uploading assets for iPhone Duo in App Store Connect will be available later this year.” A Apple abriu esses uploads em 5 de outubro de 2026 (corrigido em 7 de outubro).¹⁷ Então o calendário abaixo se manteve, com uma data que àquela altura já tinha ficado para trás. O iOS 27 chegou, o SDK 27.0 dentro do Xcode 27 é o que decide a redimensionabilidade hoje, e o SDK específico do Duo ainda está por vir (11 de outubro: ele saiu no Xcode 27.1 beta em 18 de setembro, e desde 5 de outubro o App Store Connect aceita para a App Store builds do Xcode 27.1 RC (27A9275) com o SDK do iOS 27.1²²²³; 15 de outubro: o Xcode 27.1 saiu como versão final, build 27A9275, o build do RC, e a entrada do App Store Connect do dia aceita os builds dele para a loja com esse nome²⁴); o que o toolchain final mudou nos projetos existentes está no post sobre o lançamento do Xcode 27.

Atualização, 17 de setembro: as release notes da Apple nomeiam a versão que traz o SDK do Duo

As release notes do Xcode 27.2 beta, publicadas com a onda de betas de 16 de setembro, são as primeiras release notes da Apple a atrelar o SDK a uma versão nomeada: “The iOS SDK and simulator support for iPhone Duo will be available later this month in an upcoming release of Xcode 27.1.” (o SDK do iOS e o suporte do simulador ao iPhone Duo estarão disponíveis no fim deste mês em uma próxima versão do Xcode 27.1).²⁰ O próprio beta do 27.2, Xcode 27.2 beta (27B5019j) com iOS 27.2 beta (24B5084k), não traz conteúdo algum sobre o Duo: a palavra aparece uma vez nas notas do Xcode 27.2 beta, naquela frase do Overview, e nenhuma vez nas notas do iOS e iPadOS 27.2 beta, e a seção Device Hub das notas do Xcode lista dois problemas conhecidos sobre entrada no simulador e teclados físicos que não nomeiam aparelho nenhum.²⁰ A página para desenvolvedores do iPhone Duo da Apple ainda lista o “Xcode 27.1 beta” em Tools and documentation como “Coming later this month”, mas um bloco dessa página mudou entre as minhas consultas de 15 e de 17 de setembro: “Preparing your app for iPhone Duo” não diz mais “Coming later this month” e agora linka para um guia já no ar em Technology Overviews.²⁰

O guia também nomeia a versão, duas vezes: “Build your app with Xcode 27.1 or later to use all of the available screen space on iPhone Duo. In earlier versions, your app doesn’t extend under the status bar and camera.” (compile seu app com o Xcode 27.1 ou posterior para usar todo o espaço de tela disponível no iPhone Duo; em versões anteriores, seu app não se estende sob a barra de status e a câmera) e “The iPhone Duo simulator in Device Hub requires Xcode 27.1, coming later this month.” (o simulador de iPhone Duo no Device Hub exige o Xcode 27.1, que chega no fim deste mês).²⁰ Ele não dá tamanhos em pontos, então os números de tela inferidos acima continuam sendo inferências; o que ele acrescenta é API. As arrangement views (ArrangementView no SwiftUI, UIArrangementViewController no UIKit) dispõem uma view primária e uma secundária em torno da dobra, nos estilos split ou overlay; as reserved regions (reservedRegions(kind:options:layoutDirectionBehavior:) em GeometryProxy, reservedRegions(kind:options:) em UIView) expõem a dobra e as câmeras como divisões e oclusões; e as barras verticais ganham toolbarVerticalBehavior(_:), toolbarVerticalEdge e axisBehavior(_:) no SwiftUI e preferredVerticalBarBehavior, verticalBarEdge e axisBehavior no UIKit.²⁰ Nenhum desses 10 nomes ocorre no SDK do iOS 27.0 que o Xcode 27 traz, nem na interface do módulo SwiftUI nem nos headers do UIKit, enquanto os outros nomes do guia já estão lá: presentationPlacement(_:) e preferredPlacement em 27.0, visibilityPriority em 27.0 nos dois frameworks, ToolbarOverflowMenu e topBarPinnedTrailing em 27.0, pinnedTrailingGroup e additionalOverflowItems desde o iOS 16, e backgroundExtensionEffect() desde o iOS 26 com UIBackgroundExtensionView.²¹ Então o guia descreve um SDK 27.1 que ainda não saiu, e a data de lançamento de 23 de outubro do iOS 27.1 e a lacuna do SDK continuam de pé como estão escritas. (19 de setembro: o beta saiu em 18 de setembro; veja a atualização abaixo.)

Atualização, 19 de setembro: o beta do 27.1 saiu, e as APIs do Duo têm uma versão

O Xcode 27.1 beta (27A9269) chegou ao feed de lançamentos da Apple na sexta-feira, 18 de setembro, dois dias depois da onda de betas 27.2 que o nomeou, e as notas dele abrem com a frase de SDK que este post esperava: “Xcode 27.1 beta includes Swift 6.4 and SDKs for iOS 27.1, iPadOS 27, tvOS 27, watchOS 27, macOS 27, and visionOS 27.” (o Xcode 27.1 beta inclui o Swift 6.4 e os SDKs do iOS 27.1, iPadOS 27, tvOS 27, watchOS 27, macOS 27 e visionOS 27)²² A Apple também reescreveu o Overview das notas do beta do 27.2 entre minhas coletas de 17 e 19 de setembro: a frase citada na atualização acima sumiu, e um aviso agora diz “Download Xcode 27.1 beta to get the iOS SDK and simulator support for iPhone Duo.” (baixe o Xcode 27.1 beta para obter o SDK do iOS e o suporte de simulador ao iPhone Duo)²² Em 19 de setembro, as páginas de documentação da Apple para ArrangementView, UIArrangementViewController, reservedRegions(kind:options:layoutDirectionBehavior:) em GeometryProxy, reservedRegions(kind:options:) em UIView e toolbarVerticalBehavior(_:), cinco dos dez nomes que a checagem de 17 de setembro não encontrou no SDK 27.0, listam a disponibilidade como iOS 27.1 e iPadOS 27.1, marcada como beta.²² Isso responde à pergunta da versão pelo lado da Apple; se o SDK do beta traz os dez nomes, e o que o simulador faz com eles, é a checagem que faço com o beta instalado, em um post que vem por aí. O App Store Connect aceitou os builds correspondentes no mesmo dia: “You can now submit apps built with Xcode 27.1 beta using the SDK for iOS 27.1 beta or iPadOS 27.1 beta for internal and external testing.” (agora você pode enviar apps compilados com o Xcode 27.1 beta usando o SDK do iOS 27.1 beta ou do iPadOS 27.1 beta para testes internos e externos)²² O “iPadOS 27” do Overview e o “iPadOS 27.1 beta” do App Store Connect não batem, e eu cito os dois em vez de escolher um.

As notas do beta também dizem o que o simulador do Duo ainda não faz, em Simulator, Known Issues: “Initial Simulator launch can take several minutes.” (a primeira inicialização do simulador pode levar vários minutos) (187708500), “StandBy is unavailable in the iPhone Duo Simulator runtime.” (o StandBy não está disponível no runtime do simulador do iPhone Duo) (187708663) e “Running and debugging most app extensions is unavailable in the iPhone Duo Simulator runtime.” (executar e depurar a maioria das app extensions não está disponível nesse runtime) (187708767); então o comportamento do StandBy descrito abaixo é, por enquanto, um teste em dispositivo, e, pela redação da Apple, a maioria das app extensions também.²² Dois Known Issues de Mac Catalyst nas mesmas notas importam para quem adota essas APIs em um app que também sai no Mac: “Projects that use APIs specific to iOS 27.1 show compile errors when building for Mac Catalyst (“undeclared identifier”, “not found”, “has no member”, “cannot find”, etc).” (projetos que usam APIs específicas do iOS 27.1 mostram erros de compilação ao compilar para Mac Catalyst) (185924957), com #if !targetEnvironment(macCatalyst) como solução da Apple, e “Projects that target iOS 27.1 show no Mac Catalyst run destination available.” (projetos que miram o iOS 27.1 não mostram nenhum destino de execução do Mac Catalyst) (187046347), com “Add a Mac Catalyst 27.0 minimum deployment in target settings.” (adicionar um deployment mínimo Mac Catalyst 27.0 nas configurações do target) como solução.²² O guia da Apple “Preparing your app for iPhone Duo” mudou entre as mesmas duas coletas. O parágrafo citado acima, “Build your app with Xcode 27.1 or later to use all of the available screen space on iPhone Duo. In earlier versions, your app doesn’t extend under the status bar and camera.”, agora diz “Build your app with the latest version of Xcode to use all of the available screen space on iPhone Duo. When you build with Xcode 26 and earlier, your app doesn’t extend under the status bar and camera.” (compile seu app com a versão mais recente do Xcode para usar todo o espaço de tela do iPhone Duo; compilado com o Xcode 26 ou anterior, o app não se estende sob a barra de status e a câmera), e a nota “The iPhone Duo simulator in Device Hub requires Xcode 27.1, coming later this month.” sumiu. Na página para desenvolvedores, o “Coming later this month” do cartão “Xcode 27.1 beta” virou “View betas,” e uma notícia de 18 de setembro, “Build for iPhone Duo with new resources,” adiciona kits de design do Figma e do Sketch para o iPhone Duo aos Apple Design Resources.²²

O que a Apple publicou, e o que não publicou

O comunicado dedica duas frases aos desenvolvedores. Os próprios apps da Apple “são otimizados para o iPhone Duo, e os desenvolvedores podem adaptar seus apps com facilidade usando as APIs novas e atualizadas nos SDKs mais recentes, e o suporte que está por vir ao iPhone Duo no Device Hub do Xcode”. E ainda: “Apps de terceiros, incluindo Netflix, Zoom e Slack, já estão aproveitando o design dobrável para entregar experiências imersivas que tiram o máximo da tela maior e das novas maneiras de usar o iPhone Duo.”¹

A palavra que importa é “por vir”. As notas de versão do RC do iOS e do iPadOS 27 traziam títulos de RC quando foram consultadas em 9 de setembro, o dia em que o App Store Connect começou a aceitar builds feitas com os SDKs RC¹⁹, e não contêm nenhuma menção ao iPhone Duo. Nem as notas do RC do Xcode 27, que descrevem o Device Hub em detalhe, incluindo o modo de redimensionamento em que se apoia a lista de verificação do iPhone redimensionável deste site.⁴⁵ O índice da documentação da Apple também não mostra nenhuma página do iPhone Duo. O aparelho sai com o iOS 27.1, diz a Apple, e a página para desenvolvedores agora confirma o formato da espera: o “Xcode 27.1 beta”, descrito como a maneira de “compilar, executar e testar seu app para o iPhone Duo”, está “coming later this month”, assim como um guia chamado “Preparing your app for iPhone Duo”. O guia de design, “Designing for iPhone Duo”, dizia “coming soon” à 1:12 da tarde e já estava no ar nas Human Interface Guidelines às 4:10 da tarde no horário do Pacífico; suas regras estão na seção sobre o guia de design.¹³¹⁶ (17 de setembro: o guia está no ar; veja a atualização acima.²⁰)

O que a Apple publicou para desenvolvedores no primeiro dia

A página Get Ready for iPhone Duo foi ao ar no dia do keynote; o post de notícias para desenvolvedores da Apple que a anuncia está datado das 11:00 da manhã no horário do Pacífico, com o keynote ainda em andamento.¹³ Ela reúne seis Tech Talks, já disponíveis: “Prepare your app for iPhone Duo”, cuja descrição promete mostrar “como aderir à experiência em tela cheia”; “Raise the bar with iPhone Duo”, sobre navegação, barras de ferramentas e barras de abas; “Strike a pose with adaptive layouts on iPhone Duo”, sobre “padrões de design de deslocamento”; o Tech Talk sobre múltiplas telas e cenas, sobre “experiências de multijanela e multitela” e “tamanhos dinâmicos de janela”; “Build a great camera experience for iPhone Duo”, que nomeia uma “Virtual Front Camera”; e “Design for iPhone Duo”.¹⁴ As trilhas de legenda em inglês dos Tech Talks trazem as regras que o comunicado não trouxe, e este texto as cita com marcadores de tempo.

A página também agenda pessoas. Os Online Group Labs acontecem em 16 de setembro, às 8 da noite, e em 17 de setembro, às 8 da manhã, no horário do Pacífico; as sessões de perguntas e respostas no fórum de desenvolvedores sobre Photos e Camera, SwiftUI e UIKit acontecem em 23 de setembro; e os workshops presenciais estão “coming later this month”.¹³ O primeiro minuto do primeiro Tech Talk é a política de compatibilidade em três níveis. “Seu app vai funcionar no iPhone Duo mesmo que você não o tenha compilado com o SDK do iOS 27”, diz David Jackson, do time de UI Frameworks, em 0:29; fechado, “seu app vai usar o espaço de tela à esquerda da barra de status e da câmera” e, aberto, “seu app vai ter um tamanho e uma proporção familiares”. Com o SDK do iOS 27, “seu app vai se estender até a esquerda da área da barra de status na tela interna” (0:57). Só “quando você compila seu app com o SDK do iOS 27.1, seu app se estende até a borda da tela”, e “os botões padrão de navegação e de barra de ferramentas agora se dispõem verticalmente sob a barra de status” (1:05 a 1:11). O Tech Talk então aponta para o Xcode 27.1 e seu simulador de iPhone Duo no Device Hub, com “botões de controle na parte de baixo da tela para abrir, fechar, girar ou dobrar o iPhone Duo” (1:16 a 1:25); a página para desenvolvedores data esse Xcode para ainda este mês.¹³¹⁴

Até o SDK chegar, a ficha técnica, esses seis Tech Talks e o guia de design são a documentação. (19 de setembro: o Xcode 27.1 beta traz o SDK; veja a atualização acima.²²) (11 de outubro: o Xcode 27.1 RC (27A9275) veio em seguida, em 5 de outubro, e o App Store Connect aceita os builds dele para a App Store.²³) (15 de outubro: o Xcode 27.1 (27A9275) saiu como versão final, com o build do RC.²⁴) O primeiro Tech Talk, aqui mesmo:

Atualização de 11 de setembro. As notas de versão do RC do iOS 27 da Apple ganharam uma seção de Hardware Security que lista os modelos de iPhone com A20 Pro ou mais recente, o que inclui o iPhone Duo, entre os aparelhos contemplados pelo slice arm64e.x1 e pela aritmética de ponteiros verificada CPA2. O slice já está no RC do Xcode 27 hoje; arm64e.x1: o slice de aritmética de ponteiros verificada da Apple cobre o que o compilador emite e as quatro chaves que ligam a aplicação das verificações.

O que o guia de design acrescenta, 4 da tarde no horário do Pacífico

A página Designing for iPhone Duo da Apple entrou nas Human Interface Guidelines na tarde do keynote; a entrada no change log está datada de 9 de setembro de 2026 e diz “New page.”¹⁶ É um documento de design, e nomeia a maquinaria de layout que os Tech Talks descrevem.

Posições. As pessoas seguram o aparelho “parcialmente dobrado como um livro, apoiado sobre uma superfície ou em pé sobre as bordas”, e a resposta da Apple não é um layout por posição: “Um layout em compact width para a tela externa e um layout em regular width para a tela interna dão a você os fundamentos para todas as posições.”¹⁶ É a regra de classes de tamanho do primeiro Tech Talk, reformulada como orientação de design.

Regiões reservadas. A página define três áreas que o conteúdo evita. A região da câmera externa, no canto da tela externa, “está sempre presente e se expande para a Dynamic Island nas Live Activities”. A região da câmera interna “só está presente quando a câmera está ativa”, e “quando a câmera é ativada, a UI se afasta para indicar a presença da câmera”. A terceira é a dobra: “Quando o aparelho está parcialmente aberto, a região da dobra divide a tela interna em várias regiões utilizáveis, excluindo a região do centro, onde a tela se dobra.”¹⁶ A Apple diz que “componentes como alertas, menus de contexto e sheets se movem automaticamente para levar a dobra em conta”, orienta layouts em grade a “preferir um número par de colunas para que o conteúdo se divida de forma limpa” e afirma que “as APIs de reserved regions oferecem uma maneira de reposicionar o conteúdo para longe das regiões reservadas”. A página não linka documentação alguma para essas APIs; os links para desenvolvedores que ela traz são os tipos de prioridade de visibilidade e de menu de overflow das barras de ferramentas, os bar button items e seus grupos, split views, stacks, Label e insets de área segura, então as APIs de reserved regions e de arrangement ainda são coisa a ser entregue pelo beta do 27.1.¹⁶

Arrangement views. Um novo container que “guarda duas views dentro de si” e “as organiza dinamicamente com base no tamanho da tela, na orientação e nas regiões reservadas”, em dois tipos: um split arrangement que “divide horizontalmente quando o arrangement é mais largo do que alto, e divide verticalmente quando o arrangement é mais alto do que largo”, e um overlay arrangement: “Quando a tela está parcialmente dobrada, as views se movem para ocupar cada lado; caso contrário, a view primária se move sobre a view secundária.” A Apple mapeia layouts existentes nesses tipos: pilhas lado a lado viram um split arrangement, um ZStack em camadas vira um overlay, e a Apple acrescenta: “Uma arrangement view faz o layout do conteúdo, mas não cuida da navegação, então coloque containers de navegação como navigation split views e tab views em volta dela, e não dentro dela.”¹⁶

Controles verticais. Barras de ferramentas, barras de abas e controles de navegação vão para a lateral em todas as posições, exceto “a tela interna em retrato, que tem espaço vertical suficiente para manter as barras horizontais padrão”. No Split View, “cada um posiciona os controles ao longo de sua borda externa, então o app da esquerda tem os controles à esquerda”. A regra de ordenação: “Reserve o topo do eixo vertical para os controles de navegação principais, como Back ou Close, seguidos das ações de destaque, como Done.” O overflow corre “de baixo para cima por padrão”, e você muda isso com uma prioridade de visibilidade por item, os tipos ToolbarItemVisibilityPriority e UIBarButtonItemVisibilityPriority que a página linka. “Labels que incluem texto permanecem em uma barra horizontal, então prefira um símbolo sempre que um funcionar.”¹⁶

Orientação e jogos. “Você pode optar por travar a orientação em retrato ou em paisagem, mas preencha a tela conforme a posição do aparelho muda.” Para jogos: “Prefira mudar a proporção a usar letterboxing ou pillarboxing em jogos; se não der para evitar o letterboxing ou o pillarboxing, acrescente arte à área de preenchimento para ajudar a experiência a parecer em tela cheia.”¹⁶ É o problema do 16:9 da seção abaixo, respondido pelo lado do design. A leitura de design do guia e dos três Tech Talks que o acompanham, deslocamento, arrangements e o eixo vertical, está em Projetando para o iPhone Duo.

As duas telas, em pontos

Quadro da transmissão do evento da Apple de 9 de setembro de 2026, 10:58 da manhã no horário do Pacífico: a dobradiça e as câmeras traseiras no corpo dobrável.

A ficha técnica da Apple publica resoluções em pixels e densidades de pixels; a especificação de captura de tela do App Store Connect, publicada no dia seguinte ao keynote, publica as dimensões das capturas, e as duas divergem para a tela interna.²¹⁷ A tabela divide os tamanhos de captura por três, a escala que as diretrizes da Apple listam para o painel idêntico de 1206 por 2622 do iPhone 17 Pro, 402 por 874 pontos.¹¹ Trate as colunas de pontos como aritmética a partir dos números da Apple, não como especificação, até o Device Hub informá-los.

Duas coisas saltam dessa tabela. A tela interna não é um telefone maior. Com 669 pontos de largura em retrato, ela é 229 pontos mais larga que um iPhone 18 Pro Max em retrato e, em paisagem, é mais alta do que qualquer iPhone é em paisagem; sua proporção de 1.42 não chega nem perto dos 2.17 da linha Pro. A tela externa também não é um telefone pequeno. Ela é 64 pontos mais larga que a de um iPhone 18 Pro e 196 pontos mais curta, um formato que nenhum iPhone lançado teve.

O comunicado da Apple acrescenta o fato que a tabela esconde: “As duas telas compartilham a mesma proporção, então o conteúdo escala proporcionalmente, garantindo continuidade visual.”¹ As contagens de pixels dão 1.42 e 1.45, cerca de 2 por cento de diferença, então uma imagem ou um quadro de vídeo composto para a tela interna cabe na externa com uma lasca de margem. Layout é outra história, porque as duas telas informam classes de tamanho diferentes: a tela externa é compact width como todo outro iPhone em retrato, e a tela interna é regular nas duas dimensões, como cobre a seção sobre classes de tamanho. O primeiro Tech Talk descreve o que isso faz com uma split view: “Quando o iPhone Duo está fechado, as colunas colapsam em uma navegação de pilha única. Quando aberto, as colunas aparecem tanto lado a lado quanto como overlays” (5:19).¹⁴ Os dois formatos são novos no iPhone; para o seu código, eles são uma proporção em duas classes de tamanho.

As dimensões da Apple resolvem a forma padrão de segurar o aparelho. Aberto, ele tem 6.48 polegadas de largura por 4.64 de altura, então a orientação natural da tela interna é 951 pontos de largura por 669 de altura; fechado, tem 3.31 polegadas de largura por 4.64 de altura, então a tela externa é retrato. Aberto, tem 0.21 polegada de espessura e pesa 8.96 onças.² A Apple também moveu a Dynamic Island para ficar na vertical, na lateral das duas telas, e empurrou o Dock, os controles da Tela Bloqueada e a navegação do app para a lateral “para maximizar o espaço vertical para o conteúdo”.¹ Então conte com insets de área segura assimétricos nas bordas leading e trailing: o primeiro Tech Talk diz que “barras verticais criam insets leading e trailing” e manda “evitar supor que os insets em lados opostos são iguais” (6:18, 7:24).¹⁴ Qualquer view que suponha que a ilha fica no topo vai estar errada aqui.

O problema do 1.42, e o presente do 1.42

Uma proporção de 1.42 está a cerca de meio por cento da raiz quadrada de dois, a proporção do papel da série A, que mantém suas proporções quando dobrado ao meio. Um comentário no topo da discussão do Hacker News notou isso, e é um bom jeito de pensar no aparelho: dobre a tela interna e você tem dois painéis do mesmo formato.⁹

Para vídeo em 16:9, a proporção cobra o seu preço. Em paisagem, a largura de 951 pontos limita um quadro 16:9 na tela interna, então ele renderiza a 951 por 535 pontos e deixa 134 pontos de letterbox divididos acima e abaixo, um quinto da tela sem uso. Em um iPhone 18 Pro em paisagem, é a altura de 402 pontos que limita o mesmo quadro, então ele renderiza a 715 por 402 pontos. Em termos físicos, a partir das densidades da Apple, isso é uma imagem de 6.21 polegadas de largura no Duo contra uma de 4.66 polegadas no Pro, cerca de 77 por cento mais área, com um letterboxing que você não tem como evitar.²³ Apps de vídeo ganham uma imagem maior e uma borda preta maior ao mesmo tempo.

Para tudo que não é vídeo, a proporção é o presente. Documentos, feeds, e-mail, código e layouts de dois painéis são justamente os formatos para os quais o papel da série A existe. O keynote mostrou exatamente esses layouts, uma conversa de mensagens ao lado de uma mensagem de e-mail, uma página dupla de revista e um app de chat de equipe espalhado pela tela interna, e o comunicado da Apple cita o Slack, uma conversa com a Siri ao lado de outro conteúdo, e o Split View com dois apps lado a lado.¹ O texto sobre o evento registra os quadros do keynote com marcadores de tempo. Uma NavigationSplitView que colapsa em layouts de iPhone em compact width pode mostrar colunas lado a lado ou sobrepostas na tela interna em regular width do Duo, que é o assunto da próxima seção.

Classes de tamanho: a tela interna é regular nos dois eixos

O primeiro Tech Talk dá os valores. “Na tela externa, como em outros modelos de iPhone, o iPhone Duo tem classe de tamanho vertical regular e classe de tamanho horizontal compacta em retrato, e classes de tamanho vertical e horizontal compactas em paisagem” (3:08). “Na tela interna, o espaço adicional permite mostrar mais conteúdo, como barras laterais. Por isso, ela tem classes de tamanho horizontal e vertical regulares” (3:20).¹⁴ Para contexto, todo iPad na tabela de classes de tamanho da Apple informa largura regular em retrato, até o iPad mini de 768 pontos naquela tabela, então a tela interna de 669 pontos entra na coluna do iPad, não na do iPhone.¹¹

O mesmo Tech Talk fecha duas portas. “A tela interna não respeita as orientações de interface que você suporta. Assim como com o Idiom, evite verificar a orientação da interface para decisões de layout. Use classes de tamanho no lugar” (3:46 a 3:55), e “em um aparelho com duas telas, evite referenciar a tela principal no seu código” (3:57).¹⁴ O código seguro lê horizontalSizeClass do ambiente, ou a trait collection no UIKit, e monta o layout a partir disso.⁸ Esse também é um passo da lista de verificação, que aposenta as verificações de orientação em favor das classes de tamanho, porque o iOS 27 desacopla orientação de redimensionabilidade.

A multitarefa chega ao iPhone

Quadro da transmissão do evento da Apple de 9 de setembro de 2026, 11:09 da manhã no horário do Pacífico: uma bateria em cada metade e o A20 Pro na placa.

O comunicado da Apple lista o Split View para dois apps lado a lado “no iPhone pela primeira vez”, duas janelas do mesmo app “como o Safari”, e pares de apps salvos.¹ O Tech Talk sobre múltiplas telas e cenas confirma o mecanismo: “O iPhone Duo é o primeiro iPhone a suportar múltiplas instâncias da UI do seu app. Se o seu app suporta isso no iPad, também vai suportar no iPhone Duo” (3:38).¹⁴ No iPad, esse suporte é a chave UIApplicationSupportsMultipleScenes no scene manifest, mais o ciclo de vida de cena via UIWindowScene, então um app de iPhone que deixou a chave em false para não ter que coordenar estado entre janelas deve contar com revisitar essa decisão.⁷ Há uma regra específica do Duo: “Na tela externa do iPhone Duo, não é possível criar janelas novas. Esse comportamento é reservado à tela interna”, então “trate os erros ao solicitar cenas novas”, e a ação UIWindowSceneActivation “se oculta automaticamente quando janelas novas não estão disponíveis” (3:53 a 4:11).¹⁴

O mesmo Tech Talk acrescenta os scene accessories, que “permitem que seu app mostre conteúdo em várias telas ao mesmo tempo”, e um específico do Duo: “o CameraCaptureAccessory permite que você coloque uma UI adicional na tela externa, enquanto a UI principal do seu app fica na tela interna”, disponível “quando seu app está em tela cheia na tela interna e tem uma sessão de câmera ativa” (4:26 a 5:19).¹⁴ O próprio ciclo de vida baseado em cenas deixou de ser opcional: as notas do RC do iOS 27 afirmam que “apps compilados com o SDK mais recente precisam adotar o ciclo de vida baseado em cenas ou não conseguem ser iniciados”, assunto do texto sobre a exigência de cenas.⁴⁷

O Split View com dois apps é tarefa do sistema, não sua, mas entrega ao seu app uma largura arbitrária no meio da sessão. A redimensionabilidade contínua, assunto da lista de verificação, decide se o seu app recebe essas atualizações de redimensionamento ou um único salto para um novo tamanho quando o arraste termina; as notas da Apple dizem que cada redimensionamento de um app não contínuo “deve ser entregue como uma mudança discreta” com os bounds atualizados.⁴ O portão é o SDK contra o qual você faz o link e a ausência de UIRequiresFullScreen: compile com o SDK do iOS 27, deixe essa chave de fora, e o fluxo de redimensionamento é seu para tratar. A technote da Apple sobre a chave descontinuada dá o outro ramo: com o SDK do iOS 27, a chave “não exclui mais o seu app do redimensionamento” e, em vez disso, “o sistema redimensiona a cena do seu app de forma discreta”, então “a cena não muda de tamanho enquanto as pessoas arrastam a janela”.¹² O Tech Talk acrescenta a ruga do Duo: “O iPhone Duo vai continuar respeitando a chave UI requires full screen, mas seu app ainda vai ser redimensionado quando alguém abrir ou fechar o iPhone Duo”, e ele “respeita as orientações de interface que você suporta, mas seu app vai escalar na tela interna, inclusive na multitarefa em Split View” (4:36 a 4:49).¹⁴

O StandBy na tela externa é uma superfície de widgets

Quadro da transmissão do evento da Apple de 9 de setembro de 2026, 11:05 da manhã no horário do Pacífico: a posição de barraca que a Apple mostrou para o StandBy.

O comunicado da Apple diz que o StandBy roda em qualquer uma das telas “mesmo quando não está carregando”, com novos visuais de Calendário e Tempo e mais personalização.¹ Um telefone dobrável apoiado em uma mesa é uma tela voltada para o ambiente, e o StandBy a preenche com widgets. Widgets e Live Activities são as duas formas de um app aparecer ali; as diretrizes da Apple listam o StandBy entre os lugares em que uma Live Activity aparece.¹⁵ Um app sem nenhum dos dois fica ausente dessa superfície. O texto sobre a superfície de widgets defende que um único App Intent alimenta todos os posicionamentos; o iPhone Duo acrescenta um posicionamento que está sempre à vista.

Os recursos de câmera na tela externa, Duo Preview, Kid Cue e Duo FaceTime, são recursos do sistema.¹ Apps de câmera de terceiros ganham duas coisas, segundo o Tech Talk de câmera. Uma “Virtual Front Camera”, um “novo dispositivo de AV Capture que alterna automaticamente entre as câmeras físicas externa e interna”, usando a câmera frontal da tela interna quando o aparelho está aberto e a externa quando está fechado, com os tipos de dispositivo “built-in outer ultrawide” e “built-in inner ultrawide” para acesso direto (1:14 a 2:04). E o CameraCaptureAccessory do Tech Talk sobre cenas, que coloca a sua UI na tela externa enquanto a captura acontece na interna; como diz aquele Tech Talk, “isso permite que você mostre conteúdo a uma pessoa enquanto tira uma foto dela ou a grava” (5:09).¹⁴

Touch ID, não Face ID

A ficha técnica lista um sensor de impressão digital Touch ID e uma câmera FaceTime sob a tela, e nenhum Face ID.² Todo iPhone desde o iPhone SE de 2022 saiu com Face ID, e muitos apps deixaram essas palavras fixas no código. LAContext.biometryType informa .touchID, .faceID ou .none depois que canEvaluatePolicy roda, e as strings localizadas, os SF Symbols e o texto de onboarding deveriam todos derivar disso.⁶ Apps que já rodam no iPad e no Mac costumam acertar nisso; apps só de iPhone muitas vezes não.

O calendário

• 14 de setembro: o iOS 27.0 (24A437) e o Xcode 27 (27A266a) chegaram, sem SDK para o Duo; o SDK 27.0 que decide a redimensionabilidade é o do Xcode 27.¹⁰⁵¹⁹
• 18 de setembro: o iPhone 18 Pro chega, com o iOS 27.¹⁰
• Ainda em setembro: o beta do Xcode 27.1, que a página para desenvolvedores da Apple descreve como a maneira de “compilar, executar e testar seu app para o iPhone Duo”, mais o guia “Preparing your app for iPhone Duo”; o guia de design já está nas Human Interface Guidelines. Group Labs em 16 e 17 de setembro e sessões de perguntas e respostas no fórum em 23 de setembro.¹³¹⁶ (17 de setembro: o guia está no ar; veja a atualização acima.²⁰) (19 de setembro: o Xcode 27.1 beta saiu em 18 de setembro; veja a atualização de 19 de setembro acima.²²)
• 5 de outubro: o Xcode 27.1 RC (27A9275), e o App Store Connect abre a App Store para builds feitos com ele e com o SDK do iOS 27.1 (11 de outubro).²³
• 15 de outubro: o Xcode 27.1 (27A9275), a versão final, com o número de build do RC; a entrada do App Store Connect do dia aceita os builds dele para a loja e para o TestFlight com esse nome.²⁴
• 16 de outubro: as pré-vendas do iPhone Duo abrem às 5 da manhã no horário do Pacífico.¹
• 23 de outubro: o iPhone Duo chega às lojas, com o iOS 27.1.¹

O que fazer nestas seis semanas

1. Faça o link contra o SDK do iOS 27, deixe UIRequiresFullScreen de fora do Info.plist e aceite o redimensionamento contínuo em vez de saltos discretos de tamanho. A lista de verificação é a auditoria.
2. Para decisões de layout, troque as verificações de screen bounds, de device idiom e de orientação de interface por classes de tamanho e onGeometryChange; a tela interna não respeita as orientações que você suporta e, quando o código precisa de uma tela, o Tech Talk manda “acessá-la dinamicamente a partir da window scene” em vez da tela principal (4:14).
3. Ative múltiplas cenas se o app aguentar, teste duas janelas em um iPad primeiro, e trate uma solicitação de cena recusada, já que a tela externa não abre janelas novas.
4. Rode o app no modo de redimensionamento do Device Hub a 669 por 951, a 951 por 669 e a 466 por 678, já que esses são os formatos em pontos que os tamanhos do App Store Connect implicam. O Resizable Canvas nos previews alcança todos eles hoje; o simulador de iPhone Duo do Xcode 27.1 acrescenta controles de abrir, fechar, girar e dobrar quando chegar. (19 de setembro: o beta já saiu, com os limites do simulador citados na atualização acima.²²)
5. Publique um widget, se o app ainda não tiver um.
6. Derive o texto de biometria do biometryType.
7. Assista aos seis Tech Talks e leia “Designing for iPhone Duo” agora; juntos, eles descrevem as classes de tamanho, as regras de cena, as regiões reservadas, as arrangement views, os controles verticais e o acessório de câmera. O Xcode 27.1, versão final desde 15 de outubro, é onde você implementa e testa tudo isso.¹⁴¹⁶²⁴

Principais conclusões

Para quem desenvolve para iOS: - O App Store Connect dimensiona a tela interna do iPhone Duo em 2007 por 2853 pixels, 669 por 951 pontos em 3x, sobre um painel de 1878 por 2670; a externa fica em 466 por 678. Proporção de 1.42, e nenhum dos dois formatos existe em qualquer outro iPhone.²¹⁷ - Vídeo em 16:9 ganha cerca de 77 por cento em área sobre o iPhone 18 Pro na tela interna e perde um quinto dessa tela para o letterboxing; documentos e layouts de dois painéis são os que mais ganham.²³ - Split View, duas janelas de um mesmo app e pares de apps chegam ao iPhone com o aparelho; um app que suporta múltiplas instâncias no iPad as suporta aqui, com janelas novas apenas na tela interna.¹¹⁴ - Touch ID, não Face ID. Derive do biometryType.²⁶

Para decisões de produto: - O StandBy na tela externa significa que um widget ou uma Live Activity passa a ser o mínimo para existir no aparelho.¹¹⁵ - O SDK do Duo não está nas notas do RC do iOS 27 nem nas do Xcode 27; a Apple data o beta do Xcode 27.1 para o fim de setembro; seis Tech Talks e as diretrizes “Designing for iPhone Duo” já estão disponíveis hoje.^45131416 (19 de setembro: o Xcode 27.1 beta saiu em 18 de setembro.²²)

Perguntas frequentes

Meu app atual roda no iPhone Duo?

Roda, em três níveis. O Tech Talk da Apple: “Seu app vai funcionar no iPhone Duo mesmo que você não o tenha compilado com o SDK do iOS 27”, aberto em “um tamanho e uma proporção familiares”; com o SDK do iOS 27, ele se estende “até a esquerda da área da barra de status na tela interna”; com o SDK do iOS 27.1, ele “se estende até a borda da tela”.¹⁴ A UIRequiresFullScreen continua sendo respeitada, mas o app é redimensionado quando o aparelho abre ou fecha. A technote da Apple sobre a chave descontinuada enuncia a regra geral para o SDK do iOS 27: a chave “não exclui mais o seu app do redimensionamento” e “o sistema redimensiona a cena do seu app de forma discreta”.¹²¹⁴

Que classes de tamanho o iPhone Duo informa?

Tela externa: vertical regular e horizontal compacta em retrato, compactas nas duas em paisagem, como nos outros iPhones. Tela interna: regular nas duas, segundo o Tech Talk da Apple.¹⁴

Quais são as dimensões das telas em pontos?

A ficha técnica da Apple dá os pixels do painel, e a especificação de captura de tela do App Store Connect lista as dimensões das capturas em pixels: 2007 por 2853 para a tela interna e 1398 por 2034 para a externa, o que em 3x dá 669 por 951 e 466 por 678 pontos. Supondo uma escala de 3x, isso implica que a tela interna renderiza a 669 por 951 e reduz cerca de 6.4 por cento em cada dimensão até seu painel de 1878 por 2670, o arranjo que a Apple listava para os iPhones Plus; isso é uma inferência, e o Device Hub vai confirmá-la ou corrigi-la quando o beta do Xcode 27.1 chegar.²¹¹¹⁷

Já existe um simulador de iPhone Duo ou um perfil no Device Hub?

Não no RC do Xcode 27. O comunicado da Apple chama o suporte no Device Hub de algo “por vir”, a página para desenvolvedores data o beta do Xcode 27.1 como “later this month”, e o primeiro Tech Talk mostra os controles de abrir, fechar, girar e dobrar do simulador do Xcode 27.1.¹⁵¹³¹⁴ (19 de setembro: o Xcode 27.1 beta (27A9269) saiu em 18 de setembro; veja a atualização acima.²²) (15 de outubro: o Xcode 27.1, a versão final, build 27A9275, lista nas notas os problemas conhecidos do iPhone Duo Simulator.²⁴)

O que a Apple publicou para desenvolvedores até agora?

Uma página Get Ready for iPhone Duo, seis Tech Talks e um cronograma: Group Labs em 16 e 17 de setembro, perguntas e respostas no fórum em 23 de setembro, workshops e o beta do Xcode 27.1 “later this month”, a página “Designing for iPhone Duo” nas Human Interface Guidelines, e o guia “Preparing your app for iPhone Duo” marcado como previsto para ainda este mês.¹³¹⁴¹⁶ (17 de setembro: o guia está no ar; veja a atualização acima.²⁰) (19 de setembro: o beta também já saiu.²²)

O iPhone Duo tem Face ID?

Não. A ficha técnica lista um sensor de impressão digital Touch ID.²

Quando as APIs do Duo chegam?

Com o beta do Xcode 27.1, que a página para desenvolvedores da Apple diz estar “coming later this month”. O aparelho chega em 23 de outubro, com o iOS 27.1.¹¹³ (19 de setembro: o beta saiu em 18 de setembro.²²) (11 de outubro: o RC, Xcode 27.1 RC (27A9275), saiu em 5 de outubro, e o App Store Connect aceita os builds dele para a App Store.²³) (15 de outubro: a versão final, o Xcode 27.1 (27A9275), com o número de build do RC.²⁴)

Fontes