Xcode 27.1 beta: seu app no simulador do iPhone Duo

O Xcode 27.1 beta (27A9269) saiu na sexta-feira, 18 de setembro de 2026, com o primeiro SDK do iOS 27.1 e um tipo de dispositivo iPhone Duo para o simulador, quatro dias depois do Xcode 27.0. O SDK traz todas as APIs de iPhone Duo que o guia de preparação da Apple cita, o perfil do tipo de dispositivo define as duas telas em 1398 por 2034 e 2007 por 2853 pixels em 3x, ou seja 466 por 678 e 669 por 951 pontos, e o runtime do simulador é um download à parte que o Xcode busca sob demanda. As próprias notas da Apple listam três coisas que o simulador ainda não faz, e um app de sondagem rodado nas três poses do Device Hub cai numa tela de 466 por 678 pontos fechado e numa de 951 por 669 aberto, regular nas duas classes de tamanho ali, e não reporta nenhuma região reservada em pose alguma, com UIScreen.main ainda respondendo pela tela externa enquanto o app está na interna.¹²⁴⁵⁶ {.answer-block}

TL;DR

• Datas e builds. O feed de lançamentos da Apple data o Xcode 27.1 beta (27A9269) na sexta-feira, 18 de setembro. xcodebuild -version imprime Xcode 27.1 e Build version 27A9269; os SDKs de iPhoneOS e de iPhoneSimulator se identificam os dois como iOS 27.1 build 24A94403; o compilador Swift reporta a mesma string de versão swiftlang-6.4.0.34.1 que o Xcode 27.0, e o linker o mesmo ld-27037.1. O xip tem 2.027.292.809 bytes e o app expandido ocupa 3,6 GiB, e ele se instala ao lado do Xcode 27.0 sem substituí-lo.¹⁴
• As APIs do Duo já estão no SDK. Os dez nomes que a minha checagem de 17 de setembro não achou no SDK 27.0 estão todos no SDK 27.1, entre eles ArrangementView e reservedRegions(kind:options:layoutDirectionBehavior:) no SwiftUICore, toolbarVerticalBehavior(_:) no SwiftUI, e UIArrangementViewController, preferredVerticalBarBehavior e verticalBarEdge no UIKit. O SwiftUI marca todos com @available(anyAppleOS 27.1, *); os headers do UIKit marcam o controlador de arranjo e os métodos de regiões reservadas com API_AVAILABLE(ios(27.1), tvos(27.1), visionos(27.1)), duas plataformas a mais do que as páginas de documentação listam.⁴
• O perfil do simulador põe os tamanhos de tela no papel. O tipo de dispositivo iPhone Duo (iPhone19,4, classe de produto V68, número de modelo A3447) define duas telas integradas: primary a 1398 por 2034 pixels, escala 3, e primary-1 a 2007 por 2853 pixels, escala 3, com orientação nativa de 270. Divididas por três, dão 466 por 678 e 669 por 951 pontos, e a cifra da tela interna é justamente o número que o meu post sobre o Duo para desenvolvedores inferiu em 10 de setembro a partir do tamanho de captura do App Store Connect. O perfil exige runtime 27.1 ou posterior.⁵
• O que o simulador faz com um app de verdade. O Device Hub expõe três poses, Closed (fechado), Book (livro) e Open (aberto), além de Rotate Right (girar à direita). Em Closed, a sonda recebe a tela externa: 466 por 678 pontos, largura compacta, o arranjo dividido empilhado. Em Open, recebe a interna: 951 por 669 pontos com orientação nativa em paisagem, regular nas duas classes de tamanho, insets de área segura de 34 de cada lado, o arranjo dividido lado a lado; girada, 669 de largura por 951 de altura e ainda regular nos dois eixos. Book deu ao app a mesma geometria de Open. Em todas as poses reservedRegions não devolveu nada, nem mesmo incluindo as regiões inativas, toolbarVerticalEdge ficou nil, a barra de ferramentas desenhou na horizontal e UIScreen.main.bounds continuou reportando 466 por 678 enquanto o app estava na tela interna.⁶
• O que o beta ainda não consegue fazer. As notas da Apple: “Initial Simulator launch can take several minutes.” (187708500), “StandBy is unavailable in the iPhone Duo Simulator runtime.” (187708663) e “Running and debugging most app extensions is unavailable in the iPhone Duo Simulator runtime.” (187708767), ou seja, a primeira inicialização do simulador pode levar vários minutos e nem o StandBy nem a maioria das extensões de app estão disponíveis nesse runtime. Some a isso dois Known Issues de Mac Catalyst para quem também publica o app no Mac, e uma coisa que a Apple não lista: o download do runtime falhou na minha primeira tentativa com Download failed. e funcionou na repetição.²³

O que vem no beta?

O feed de lançamentos da Apple lista “Xcode 27.1 beta (27A9269)” na sexta-feira, 18 de setembro, às 10:00 PT, e um “TestFlight Update” na mesma tarde; as notas de versão do App Store Connect daquele dia dizem “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.” (você já 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 Overview das notas de versão nomeia a linha de SDK: “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. Xcode 27.1 beta supports on-device debugging in iOS 17 and later, tvOS 17 and later, watchOS 10 and later, and visionOS. Xcode 27.1 beta requires a Mac running macOS Tahoe 26.6 or later.”² Vale ler essa lista como ela está escrita: o iOS é a única plataforma em 27.1, o próprio SDKSettings.plist do SDK reporta a versão 27.1, e o App Store Connect chama o mesmo SDK de “iPadOS 27.1 beta”, um detalhe que o post sobre o Xcode 27 já carrega.

O download é menor do que o número de versão sugere. O xip tem 2.027.292.809 bytes, é assinado pela Apple com o certificado de Software Update e expande para um app de 3,6 GiB, o mesmo tamanho do Xcode 27.0; um xip --expand numa pasta, um rename para /Applications/Xcode-27.1-beta.app e o DEVELOPER_DIR apontando para lá são toda a instalação para trabalhar na linha de comando. A primeira chamada de xcodebuild sob o beta levou depois uns dois minutos instalando por conta própria os pacotes CoreTypes.pkg e XcodeSystemResources.pkg que vêm embutidos, o passo que xcodebuild -runFirstLaunch faz de forma explícita, e o segundo desses pacotes é o que deixa o tipo de dispositivo iPhone Duo no lugar.⁴ O que o app não contém é um runtime de simulador. O beta encontra os runtimes de iOS que já estão neste Mac, o 27.0 entre eles, e nenhum para o 27.1; xcodebuild -downloadPlatform iOS sob o beta nomeia a peça que falta como “iOS 27.1 Simulator (24A94401)” e a busca como imagem de disco cryptex pelo serviço de mobile assets da Apple, enquanto as imagens de disco da própria página de downloads para desenvolvedores param no iOS 18.2 Simulator Runtime.³⁴ A primeira tentativa terminou em DVTDownloadable: Download Failed com Error Domain=DVTDownloadableErrorDomain Code=41 "Download failed."; a segunda, com -buildVersion 24A94401, reportou o runtime em 7,85 GB, concluiu, e o simctl list runtimes então listou “iOS 27.1 (27.1 - 24A94401)”. Reserve o disco antes: o runtime é quatro vezes o tamanho do download do Xcode.³

A tela externa do simulador de iPhone Duo na primeira inicialização, 1398 por 2034 pixels: o bloco de status desce pela borda direita, o lado onde as Human Interface Guidelines da Apple colocam a Dynamic Island e a barra de status no iPhone Duo.¹⁰

O SDK 27.1 tem as APIs do Duo?

Em 17 de setembro eu procurei no SDK do iOS 27.0 os nomes que aparecem no guia “Preparing your app for iPhone Duo” da Apple e não achei nenhum dos dez que são específicos do dispositivo. A mesma busca contra o SDK 27.1, feita do mesmo jeito, uma busca de texto puro nas interfaces de módulo e nos headers, acha todos. As linhas são as substrings buscadas: sete delas cobrem nove dos dez nomes, porque os dois métodos reservedRegions dividem uma linha e os dois membros axisBehavior também, e as outras três são os tipos por trás dos nomes: ReservedRegion, ToolbarVerticalBehavior para toolbarVerticalBehavior(_:) e UIVerticalBarBehavior para preferredVerticalBarBehavior:⁴

Dois detalhes dessa tabela importam na hora de escrever o código. Os tipos do SwiftUI moram no SwiftUICore, o módulo que o import SwiftUI reexporta, então um import comum já acha todos; e os atributos de disponibilidade discordam da documentação quanto às plataformas. A interface do SwiftUICore declara ArrangementView, e a do SwiftUI declara toolbarVerticalBehavior(_:), as duas sob @available(anyAppleOS 27.1, *), que é a abreviação da Apple para todas as plataformas naquela versão, enquanto UIArrangementViewController.h e os métodos reservedRegionsOfKind: de UIView.h carregam API_AVAILABLE(ios(27.1), tvos(27.1), visionos(27.1)) junto de API_UNAVAILABLE(watchos); em UIVerticalBarEdge.h, o enum e o trait verticalBarEdge carregam esse mesmo par, enquanto os casos Leading e Trailing carregam API_AVAILABLE(ios(27.1)) API_UNAVAILABLE(visionos) API_UNAVAILABLE(watchos, tvos). As páginas de documentação da Apple para os cinco listam só iOS 27.1 e iPadOS 27.1, marcadas como beta.⁴⁷ Escreva contra o iOS e deixe o compilador te contar o resto.

Os três nomes que o guia usa e que já estavam no SDK 27.0 continuam iguais: presentationPlacement(_:) segue sob @available(anyAppleOS 27.0, *), backgroundExtensionEffect() continua ali desde o iOS 26, e dos dois casos de ToolbarItemPlacement que o guia cita, topBarPinnedTrailing fica sob @available(iOS 27.0, visionOS 27.0, *) e cancellationAction não carrega disponibilidade própria além da do tipo.⁴

O que o perfil do simulador diz sobre as duas telas?

O tipo de dispositivo que a Apple instala com o beta, iPhone Duo.simdevicetype, é um bundle comum dentro de /Library/Developer/CoreSimulator/Profiles/DeviceTypes, e suas duas property lists respondem perguntas que a ficha técnica tinha deixado em aberto.⁵

O profile.plist dá a identidade: identificador de modelo iPhone19,4, classe de produto V68, um alias com.apple.CoreSimulator.SimDeviceType.V68, minRuntimeVersion 27.1 e uma regra para criar o dispositivo por padrão nos runtimes de 27.1 em diante. O capabilities.plist dá o hardware: número de modelo A3447, HomeButtonType 2, DeviceSupportsDynamicIsland true, DeviceSupportsEnhancedMultitasking false, IsLargeFormatPhone true, um CompatibleDeviceFallback de iPhone18,3, um raio de canto de dispositivo de 59 e um array displays com duas entradas integradas e três virtuais.⁵

A primeira linha é a tela externa e bate pixel a pixel com a ficha técnica da Apple. A segunda é a tela interna, e a contagem de pixels dela é o tamanho de captura do App Store Connect, 2007 por 2853, e não os 1878 por 2670 do painel: o simulador renderiza a tela interna a 669 por 951 pontos em 3x, que é a aritmética que o meu post sobre o Duo para desenvolvedores fez em 10 de setembro e rotulou ali como uma inferência. Agora o próprio perfil da Apple carrega o número. A orientação nativa de 270 graus diz que a tela interna é nativa em paisagem, 951 pontos de largura por 669 de altura com o telefone aberto, o que bate com as dimensões que a Apple dá para o aparelho aberto. Os dois números restantes são valores do simulador, e não do hardware: as duas telas aparecem a 460 pixels por polegada e 60 Hz, sendo que a ficha técnica dá 430 ppi ao painel interno, então vale tratar hdpi como um marcador de lugar.⁵

O perfil também traz as formas. Cada tela referencia uma máscara de framebuffer, um PDF da área visível. A máscara da tela externa tem cantos assimétricos, os valores 8 do perfil numa borda longa e 59 na outra, na minha leitura o raio pequeno fica do lado que encontra a dobradiça central descrita no guia de design da Apple; a máscara da tela interna é um retângulo arredondado liso, com o valor de canto 55 do perfil e sem recorte para a câmera frontal, então a oclusão da câmera vem da API de regiões reservadas em tempo de execução, e não da forma do framebuffer.⁵¹⁰

O que o simulador mostra?

O dispositivo inicia fechado. Na primeira inicialização a tela externa mostra a Tela de Início e o framebuffer da interna está ligado, mas preto, e o simctl io enumerate lista as duas telas integradas pelos nomes do perfil, primary a 1398 por 2034 e primary-1 a 2007 por 2853, ao lado das virtuais de sempre.⁶ Instalei uma sonda SwiftUI de arquivo único que lê a geometria, as classes de tamanho, o valor de ambiente toolbarVerticalEdge e as regiões reservadas dos dois tipos com includeInactive, envolve um ArrangementView em cada um dos três estilos e põe seis itens numa barra de ferramentas de navegação.⁶

A sonda na tela externa, pose Closed: 466 por 678 pontos, largura compacta, o arranjo dividido empilhado, a barra de ferramentas na horizontal.

Em Closed, a sonda reporta o que um iPhone compacto reporta. UIScreen.main.bounds dá 466 por 678 pontos em escala 3, as classes de tamanho são largura compacta e altura regular, toolbarVerticalEdge é nil, o trait verticalBarEdge do UIKit lê como valor bruto 0, e as duas consultas de regiões reservadas devolvem arrays vazios mesmo incluindo as inativas, ou seja, a pose fechada não expõe ao app nem dobra nem câmera. O GeometryReader dentro da pilha de navegação mediu 386 por 510 pontos, com insets de área segura de 134 no topo e 34 embaixo e nenhum nas laterais; na minha leitura, os 80 pontos de largura que o sistema reteve são a faixa da direita onde fica o bloco de status. O arranjo dividido colocou a visualização primária acima da secundária, que é o caso mais alto do que largo descrito no guia da Apple, e a barra de ferramentas desenhou na horizontal no topo: Share e o botão Done com o tique ao lado do botão de mais opções, com as quatro ações secundárias ausentes da barra e, pelo placement delas, dentro do menu dela.⁶⁷

O Device Hub é onde as poses moram. Com o dispositivo Duo selecionado, a janela dele expõe Rotate Right, Closed, Book e Open como botões que a API de acessibilidade consegue pressionar, que foi como o resto desta seção foi conduzido.⁶

Open move o app para a tela interna na orientação nativa em paisagem. A sonda reporta largura regular e altura regular, o GeometryReader mede 803 por 515 pontos com insets de área segura de 134 no topo, 34 de cada lado e 20 embaixo, e faltam à largura os mesmos 80 pontos da pose fechada, na minha leitura de novo a faixa, agora à direita de uma tela de 951 pontos de largura e com o bloco de status dentro. O arranjo dividido põe as visualizações primária e secundária lado a lado, o caso mais largo do que alto do guia da Apple, e a barra de ferramentas desenha na horizontal no canto superior direito, de novo Share e Done ao lado do botão de mais opções, com as quatro ações secundárias ausentes da barra.⁶

Pose Open, tela interna, 2853 por 2007 pixels: regular nas duas dimensões, o arranjo dividido lado a lado, a faixa à direita.

Rotate Right deixa a tela interna em retrato. A sonda mede então 669 por 703 pontos, regular nas duas dimensões, com insets de 134 no topo e 34 embaixo e nenhum nas laterais; na minha leitura a faixa de 80 pontos foi para a borda superior, onde o bloco de status agora fica dentro de uma tarja preta, e o arranjo dividido continua lado a lado mesmo com o contêiner agora mais alto do que largo.⁶

A tela interna girada: 669 pontos de largura, ainda regular nos dois eixos, a faixa atravessando o topo.

Book, a pose parcialmente dobrada, é onde a API de regiões reservadas deveria justificar o próprio salário, e neste beta ela não justificou com a minha sonda. Sem nenhum app em primeiro plano, a tela interna depois do toque em Book mostrou a Tela de Início; relançada, a sonda reportou exatamente o que reportava em Open, 803 por 515 pontos, regular nas duas dimensões, e zero divisions e zero occlusions incluindo as regiões inativas, no SwiftUI e no UIKit. A pose fechada também reporta zero. Não encontrei nenhuma pose em que reservedRegions devolvesse uma dobra ou uma câmera, então um layout que se adapta à dobra é algo que o simulador deste beta não me deixou ver; o guia da Apple descreve a divisão como ativa “when iPhone Duo is partially open,” (quando o iPhone Duo está parcialmente aberto), e se isso é uma lacuna do beta ou uma lacuna da minha sonda é pergunta para o próximo beta.⁶⁷

Mais duas coisas se mantiveram em todas as poses. A barra de ferramentas nunca desenhou na vertical: toolbarVerticalEdge foi nil no SwiftUI e verticalBarEdge leu como valor bruto 0 no UIKit, fechado, aberto e girado, então as barras verticais descritas no guia da Apple não apareceram para a barra de ferramentas de uma pilha de navegação neste beta. E UIScreen.main.bounds respondeu 466 por 678 pontos, a tela externa, enquanto o app estava na tela interna, que é exatamente a armadilha contra a qual o guia da Apple alerta ao dizer para fazer os cálculos de layout “based on your scene or containing view’s bounds rather than screen dimensions” (com base nos bounds da sua cena ou da visualização que contém, e não nas dimensões da tela): a tela principal não é a tela em que você está. O compilador já avisa 'main' was deprecated in iOS 26.0 quando a sonda compila, e este aparelho é o motivo.⁶⁷

Um caminho para as outras poses não funciona. O simctl io screenConfig consegue desligar uma tela, e desligar a externa mantendo a interna ligada não abriu o telefone; derrubou o system shell do simulador, o simctl launch falhou em seguida com “The system shell probably crashed,” (o system shell provavelmente travou) e foi preciso reiniciar. As poses moram na janela do Device Hub.⁶

O que o beta ainda não consegue fazer

A Apple lista três limites em Simulator, Known Issues (problemas conhecidos), nas notas do próprio beta: “Initial Simulator launch can take several minutes.” (187708500), “StandBy is unavailable in the iPhone Duo Simulator runtime.” (187708663) e “Running and debugging most app extensions is unavailable in the iPhone Duo Simulator runtime.” (187708767).² O do StandBy pesa para quem tem widgets ou Live Activities pensados para ele: o anúncio da Apple diz que o telefone “enters StandBy on either the outer or inner display” (entra em StandBy na tela externa ou na interna) e o chama de “hub for widgets” (central de widgets), o post sobre o Duo para desenvolvedores cobre o que aparece ali, e até que um beta posterior derrube o limite, o StandBy neste aparelho é coisa para conferir em hardware.¹¹

Mais dois ficam em Mac Catalyst, Known Issues, e mordem qualquer app que adote essas APIs e também compile para o 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). (185924957)” (projetos que usam APIs específicas do iOS 27.1 mostram erros de compilação ao compilar para Mac Catalyst), com o workaround da Apple de #if !targetEnvironment(macCatalyst) em Swift ou #if !TARGET_OS_MACCATALYST em Objective-C, e “Projects that target iOS 27.1 show no Mac Catalyst run destination available. (187046347)” (projetos que miram o iOS 27.1 não mostram nenhum destino de execução de Mac Catalyst), com “Add a Mac Catalyst 27.0 minimum deployment in target settings.” como solução.² As notas do Xcode 27.2 beta acrescentam um terceiro pelo outro lado: “macOS, watchOS, tvOS, and visionOS SDKs in Xcode 27.2 incorrectly report 27.1 as a valid deployment target,” e “Mac Catalyst builds with a 27.1 or 27.2 deployment target may be unable to use newly introduced API.” (187160501), ou seja, esses SDKs reportam errado o 27.1 como deployment target válido e as compilações de Mac Catalyst com deployment target 27.1 ou 27.2 podem ficar sem conseguir usar a API recém-introduzida.⁸

O que eu faria esta semana

1. Instale o beta ao lado do Xcode 27.0, e não por cima: expanda o xip, renomeie o app e aponte o DEVELOPER_DIR para ele nas compilações de linha de comando; nada nas notas do beta mexe no toolchain do 27.0, e o compilador e o linker carregam strings de versão idênticas.⁴
2. Comece o download do runtime antes de precisar dele, com xcodebuild -downloadPlatform iOS sob o beta, e repita se falhar; o runtime é o que torna o tipo de dispositivo iPhone Duo inicializável, e a Apple avisa que, por cima disso, a primeira inicialização leva minutos.²³
3. Compile uma vez contra o SDK 27.1 com o seu target de Mac Catalyst incluído, e leia os dois diagnósticos que a Apple cita antes de decidir se cerca a API nova com #if !targetEnvironment(macCatalyst) ou se sobe o mínimo do Catalyst para 27.0.²
4. Use os números do perfil como os tamanhos contra os quais pré-visualizar e testar: 466 por 678 pontos fechado, 669 por 951 aberto, com a tela interna nativa em paisagem. A nota de Previews do beta acrescenta um grupo Display ao seletor de overrides do canvas “for previewing content on a device’s alternative display.” (182598534), ou seja, para pré-visualizar conteúdo na tela alternativa de um aparelho.²⁵
5. Registre as regiões reservadas por pose durante o desenvolvimento: reservedRegions(kind:options:layoutDirectionBehavior:) com .includeInactive está documentado para devolver a dobra e a câmera como valores ReservedRegion que podem estar ativos ou inativos; neste beta toda pose devolveu nada, então uma linha de log em onChange(of: proxy.size) avisa o momento em que uma pose começa a reportá-las.⁶⁷

Perguntas frequentes

O simulador de iPhone Duo está no Xcode 27.1 beta?

Está. O beta instala um tipo de dispositivo iPhone Duo, com.apple.CoreSimulator.SimDeviceType.iPhone-Duo, cujo perfil exige um runtime de iOS 27.1 que o Xcode baixa à parte com xcodebuild -downloadPlatform iOS. As notas da Apple avisam que a primeira inicialização “can take several minutes” (pode levar vários minutos) e que nem o StandBy nem a maioria das extensões de app estão disponíveis nesse runtime.²³⁵

Como instalo o Xcode 27.1 beta ao lado do Xcode 27?

Expanda o xip com xip --expand, mova o app resultante para um nome com versão, como /Applications/Xcode-27.1-beta.app, e aponte o DEVELOPER_DIR para a pasta Contents/Developer dele nos comandos xcodebuild, xcrun e swiftc. O beta exige macOS Tahoe 26.6 ou posterior, o mesmo piso do Xcode 27.0.²⁴

Qual é o tamanho da tela interna do iPhone Duo em pontos?

669 por 951 pontos, segundo o perfil de dispositivo do simulador, que define a tela interna como 2007 por 2853 pixels em escala 3 com orientação nativa em paisagem; a tela externa tem 466 por 678 pontos, a partir de 1398 por 2034 pixels em escala 3.⁵

O Xcode 27.1 beta muda o SDK do iOS 27.0 ou o toolchain do Xcode 27?

Não. O compilador Swift e o linker reportam as mesmas strings de versão do Xcode 27.0, e as notas de versão do beta têm três seções, Mac Catalyst, Previews e Simulator, e nenhuma delas encosta no toolchain. O SDK do iOS 27.1 é um acréscimo, identificado como build 24A94403 tanto no SDK de dispositivo quanto no de simulador.²⁴

Quando o iPhone Duo chega, e com o quê?

Em 23 de outubro, com o iOS 27.1, segundo o post de notícias da Apple de 16 de setembro: “When iPhone Duo becomes available on October 23, it will run iOS 27.1.” (quando o iPhone Duo ficar disponível em 23 de outubro, ele rodará o iOS 27.1).⁹

Fontes