Xcode 27.1 beta : votre app dans le simulateur iPhone Duo

Xcode 27.1 beta (27A9269) est sorti le vendredi 18 septembre 2026 avec le premier SDK iOS 27.1 et un type d’appareil iPhone Duo pour le simulateur, quatre jours après Xcode 27.0. Le SDK embarque toutes les API iPhone Duo que nomme le guide de préparation d’Apple, le profil du type d’appareil définit les deux écrans à 1398 par 2034 et 2007 par 2853 pixels en 3x, soit 466 par 678 et 669 par 951 points, et le runtime du simulateur se télécharge à part, à la demande de Xcode. Les notes d’Apple listent trois choses que le simulateur ne sait pas encore faire, et une app sonde passée par les trois positions de Device Hub atterrit fermée sur un écran de 466 par 678 points et ouverte sur un écran de 951 par 669, regular dans les deux classes de taille, ne signale de régions réservées dans aucune position, et laisse UIScreen.main répondre pour l’écran externe alors que l’app tourne sur l’écran interne.¹²⁴⁵⁶ {.answer-block}

L’essentiel

• Dates et builds. Le flux Releases d’Apple date Xcode 27.1 beta (27A9269) du vendredi 18 septembre. xcodebuild -version affiche Xcode 27.1 et Build version 27A9269 ; les SDK iPhoneOS et iPhoneSimulator s’identifient tous deux comme iOS 27.1, build 24A94403 ; le compilateur Swift annonce la même chaîne de version swiftlang-6.4.0.34.1 que Xcode 27.0, et l’éditeur de liens le même ld-27037.1. Le xip pèse 2 027 292 809 octets, l’app décompressée 3,6 GiB, et elle s’installe à côté de Xcode 27.0 sans le remplacer.¹⁴
• Les API Duo sont dans le SDK. Les dix noms que ma vérification du 17 septembre n’avait pas trouvés dans le SDK 27.0 sont tous présents dans le SDK 27.1, parmi eux ArrangementView et reservedRegions(kind:options:layoutDirectionBehavior:) dans SwiftUICore, toolbarVerticalBehavior(_:) dans SwiftUI, ainsi que UIArrangementViewController, preferredVerticalBarBehavior et verticalBarEdge dans UIKit. SwiftUI les marque @available(anyAppleOS 27.1, *) ; les en-têtes d’UIKit marquent le contrôleur d’arrangement et les méthodes de régions réservées API_AVAILABLE(ios(27.1), tvos(27.1), visionos(27.1)), soit deux plateformes de plus que ce que listent les pages de documentation.⁴
• Le profil du simulateur fixe la taille des écrans. Le type d’appareil iPhone Duo (iPhone19,4, classe de produit V68, numéro de modèle A3447) définit deux écrans intégrés : primary à 1398 par 2034 pixels, scale 3, et primary-1 à 2007 par 2853 pixels, scale 3, avec une orientation native de 270. Divisés par trois, cela donne 466 par 678 et 669 par 951 points, la valeur interne étant précisément le nombre que mon billet Duo pour les développeurs avait déduit le 10 septembre de la taille des captures d’écran d’App Store Connect. Le profil exige le runtime 27.1 ou plus récent.⁵
• Ce que le simulateur fait d’une vraie app. Device Hub expose trois positions, Closed (fermé), Book (en livre) et Open (ouvert), plus Rotate Right (pivoter à droite). Fermée, l’app sonde obtient l’écran externe : 466 par 678 points, compact en largeur, l’arrangement scindé empilé. Ouverte, elle obtient l’écran interne : 951 par 669 points en paysage natif, regular dans les deux classes de taille, des marges de zone sûre de 34 de chaque côté, l’arrangement scindé côte à côte ; pivotée, 669 de large sur 951 de haut, et toujours regular des deux côtés. Book a donné à l’app la même géométrie qu’Open. Dans chaque position, reservedRegions n’a rien renvoyé, même en incluant les régions inactives, toolbarVerticalEdge est resté nil, la barre d’outils s’est dessinée horizontalement, et UIScreen.main.bounds a continué d’annoncer 466 par 678 alors que l’app était sur l’écran interne.⁶
• Ce que la bêta ne sait pas encore faire. Les notes d’Apple posent trois limites, le long premier lancement, l’absence de StandBy et la plupart des extensions d’app : « Initial Simulator launch can take several minutes. » (187708500), « StandBy is unavailable in the iPhone Duo Simulator runtime. » (187708663) et « Running and debugging most app extensions is unavailable in the iPhone Duo Simulator runtime. » (187708767). Ajoutez-y deux Known Issues sur Mac Catalyst pour quiconque livre aussi son app sur le Mac, et une chose qu’Apple ne liste pas : le téléchargement du runtime a échoué chez moi au premier essai avec Download failed. et n’a réussi qu’à la reprise.²³

Que contient la bêta ?

Le flux Releases d’Apple liste « Xcode 27.1 beta (27A9269) » le vendredi 18 septembre à 10 h 00 PT, et un « TestFlight Update » le même après-midi ; les notes de version d’App Store Connect pour cette journée indiquent qu’il est désormais possible d’envoyer en test interne et externe des apps compilées avec Xcode 27.1 beta et le SDK pour iOS 27.1 beta ou iPadOS 27.1 beta : « 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. »¹ La section Overview des notes de version nomme la série 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. »² Lisez cette liste telle qu’elle est écrite : iOS est la seule plateforme en 27.1, le SDKSettings.plist du SDK annonce lui-même la version 27.1, et App Store Connect appelle ce même SDK « iPadOS 27.1 beta », une bizarrerie que traîne aussi le billet sur Xcode 27.

Le téléchargement est plus léger que le numéro de version ne le laisse croire. Le xip pèse 2 027 292 809 octets, signé par Apple sous son certificat Software Update, et se décompresse en une app de 3,6 GiB, la même taille que Xcode 27.0 ; xip --expand dans un dossier, un renommage en /Applications/Xcode-27.1-beta.app et un DEVELOPER_DIR qui pointe dessus, voilà toute l’installation pour travailler en ligne de commande. Le premier appel à xcodebuild sous la bêta a ensuite passé environ deux minutes à installer de lui-même les paquets embarqués CoreTypes.pkg et XcodeSystemResources.pkg, l’étape que xcodebuild -runFirstLaunch exécute explicitement, et c’est le second de ces paquets qui met en place le type d’appareil iPhone Duo.⁴ Ce que l’app ne contient pas, c’est un runtime de simulateur. La bêta trouve les runtimes iOS déjà présents sur ce Mac, dont 27.0, et aucun pour 27.1 ; sous la bêta, xcodebuild -downloadPlatform iOS nomme la pièce manquante « iOS 27.1 Simulator (24A94401) » et la récupère sous forme d’image disque cryptex via le service mobile-asset d’Apple, alors que les images disque de la page de téléchargement pour développeurs s’arrêtent au iOS 18.2 Simulator Runtime.³⁴ Le premier essai s’est terminé par DVTDownloadable: Download Failed avec Error Domain=DVTDownloadableErrorDomain Code=41 "Download failed." ; le second, avec -buildVersion 24A94401, a annoncé le runtime à 7,85 GB, est allé au bout, et simctl list runtimes a alors listé « iOS 27.1 (27.1 - 24A94401) ». Prévoyez l’espace disque en conséquence : le runtime pèse quatre fois le téléchargement de Xcode.³

L’écran externe du simulateur iPhone Duo au premier démarrage, 1398 par 2034 pixels : les indicateurs d’état descendent le long du bord droit, le côté où les Human Interface Guidelines d’Apple placent la Dynamic Island et la barre d’état sur l’iPhone Duo.¹⁰

Le SDK 27.1 contient-il les API Duo ?

Le 17 septembre, j’ai cherché dans le SDK iOS 27.0 les noms employés par le guide « Preparing your app for iPhone Duo » d’Apple et je n’ai trouvé aucun des dix noms propres à l’appareil. La même recherche menée de la même manière contre le SDK 27.1, une simple recherche de texte dans les interfaces de module et les en-têtes, les trouve tous. Les lignes sont les sous-chaînes recherchées : sept d’entre elles portent neuf des dix noms, les deux méthodes reservedRegions et les deux membres axisBehavior se partageant chacun une ligne, et les trois autres sont les types derrière ces noms, soit ReservedRegion, ToolbarVerticalBehavior pour toolbarVerticalBehavior(_:) et UIVerticalBarBehavior pour preferredVerticalBarBehavior :⁴

Deux détails de ce tableau comptent pour la façon d’écrire le code. Les types SwiftUI vivent dans SwiftUICore, le module que import SwiftUI réexporte, un import ordinaire les trouve donc ; et les attributs de disponibilité contredisent la documentation sur les plateformes. L’interface SwiftUICore déclare ArrangementView, l’interface SwiftUI déclare toolbarVerticalBehavior(_:), toutes deux sous @available(anyAppleOS 27.1, *), le raccourci d’Apple pour toutes les plateformes à cette version, tandis que UIArrangementViewController.h et les méthodes reservedRegionsOfKind: dans UIView.h portent API_AVAILABLE(ios(27.1), tvos(27.1), visionos(27.1)) avec API_UNAVAILABLE(watchos) ; dans UIVerticalBarEdge.h, l’énumération et le trait verticalBarEdge portent la même paire, alors que les cas Leading et Trailing portent API_AVAILABLE(ios(27.1)) API_UNAVAILABLE(visionos) API_UNAVAILABLE(watchos, tvos). Les pages de documentation d’Apple pour ces cinq entrées ne listent qu’iOS 27.1 et iPadOS 27.1, marqués bêta.⁴⁷ Écrivez pour iOS et laissez le compilateur vous dire le reste.

Les trois noms employés par le guide qui étaient déjà dans le SDK 27.0 n’ont pas bougé : presentationPlacement(_:) se trouve toujours sous @available(anyAppleOS 27.0, *), backgroundExtensionEffect() est là depuis iOS 26, et des deux cas de ToolbarItemPlacement que nomme le guide, topBarPinnedTrailing se trouve sous @available(iOS 27.0, visionOS 27.0, *) tandis que cancellationAction ne porte aucune disponibilité propre au-delà de celle du type.⁴

Que dit le profil du simulateur sur les deux écrans ?

Le type d’appareil qu’Apple installe pour la bêta, iPhone Duo.simdevicetype, est un simple bundle placé sous /Library/Developer/CoreSimulator/Profiles/DeviceTypes, et ses deux listes de propriétés répondent à des questions que la fiche technique laissait ouvertes.⁵

profile.plist donne l’identité : identifiant de modèle iPhone19,4, classe de produit V68, un alias com.apple.CoreSimulator.SimDeviceType.V68, minRuntimeVersion 27.1, et une règle de création par défaut de l’appareil pour les runtimes à partir de 27.1. capabilities.plist donne le matériel : numéro de modèle A3447, HomeButtonType 2, DeviceSupportsDynamicIsland true, DeviceSupportsEnhancedMultitasking false, IsLargeFormatPhone true, un CompatibleDeviceFallback valant iPhone18,3, un rayon de coin d’appareil de 59, et un tableau displays avec deux entrées intégrées et trois virtuelles.⁵

La première ligne est l’écran externe et correspond pixel pour pixel à la fiche technique d’Apple. La seconde est l’écran interne, et son nombre de pixels est celui des captures d’écran d’App Store Connect, 2007 par 2853, plutôt que les 1878 par 2670 de la dalle : le simulateur rend l’écran interne à 669 par 951 points en 3x, soit exactement le calcul que mon billet Duo pour les développeurs avait posé le 10 septembre en le qualifiant de déduction. Le profil d’Apple porte désormais ce nombre. L’orientation native à 270 degrés dit que l’écran interne est nativement en paysage, 951 points de large sur 669 de haut quand le téléphone est ouvert, ce qui concorde avec les dimensions qu’Apple donne pour l’appareil ouvert. Les deux nombres restants sont des valeurs de simulateur et non de matériel : les deux écrans sont listés à 460 pixels par pouce et 60 Hz, alors que la fiche technique donne 430 ppp à la dalle interne, il faut donc traiter hdpi comme un espace réservé.⁵

Le profil livre aussi les formes. Chaque écran référence un masque de framebuffer, un PDF de la zone visible. Le masque de l’écran externe a des coins asymétriques, les valeurs du profil donnant 8 sur un grand côté et 59 sur l’autre, et selon ma lecture le petit rayon se trouve du côté qui rejoint la charnière centrale que décrit le guide de design d’Apple ; le masque de l’écran interne est un simple rectangle arrondi, avec la valeur de coin 55 du profil et sans découpe pour la caméra frontale, l’occultation de la caméra vient donc de l’API de régions réservées à l’exécution, et non de la forme du framebuffer.⁵¹⁰

Que montre le simulateur ?

L’appareil démarre fermé. Au premier démarrage, l’écran externe affiche l’écran d’accueil et le framebuffer de l’écran interne est allumé mais noir, et simctl io enumerate liste les deux écrans intégrés sous les noms du profil, primary à 1398 par 2034 et primary-1 à 2007 par 2853, à côté des écrans virtuels habituels.⁶ J’ai installé une app sonde SwiftUI tenant dans un seul fichier, qui lit la géométrie, les classes de taille, la valeur d’environnement toolbarVerticalEdge et les régions réservées des deux sortes avec includeInactive, enveloppe une ArrangementView dans chacun des trois styles et place six éléments dans une barre d’outils de navigation.⁶

L’app sonde sur l’écran externe, position Closed : 466 par 678 points, compact en largeur, l’arrangement scindé empilé, la barre d’outils horizontale.

Fermée, l’app sonde annonce ce qu’annonce un iPhone compact. UIScreen.main.bounds vaut 466 par 678 points en scale 3, les classes de taille sont compact en largeur et regular en hauteur, toolbarVerticalEdge est nil, le trait verticalBarEdge d’UIKit se lit comme la valeur brute 0, et les deux requêtes de régions réservées renvoient des tableaux vides, même en incluant les régions inactives, la position fermée n’expose donc à l’app ni pliure ni caméra. Le GeometryReader placé dans la pile de navigation a mesuré 386 par 510 points, avec des marges de zone sûre de 134 en haut et 34 en bas, et aucune sur les côtés ; selon ma lecture, les 80 points de largeur que le système a gardés sont le bandeau de droite où logent les indicateurs d’état. L’arrangement scindé a placé la vue primaire au-dessus de la secondaire, le cas plus haut que large que décrit le guide d’Apple, et la barre d’outils s’est dessinée horizontalement en haut, avec Partager et le bouton Terminé en forme de coche à côté du bouton des actions supplémentaires, les quatre actions secondaires étant absentes de la barre et, vu leur placement, rangées dans son menu.⁶⁷

C’est dans Device Hub que vivent les positions. L’appareil Duo sélectionné, sa fenêtre expose Rotate Right, Closed, Book et Open sous forme de boutons que l’API d’accessibilité peut presser, et c’est ainsi qu’a été mené le reste de cette section.⁶

Open fait passer l’app sur l’écran interne, dans son orientation paysage native. L’app sonde annonce regular en largeur et regular en hauteur, le GeometryReader mesure 803 par 515 points avec des marges de zone sûre de 134 en haut, 34 de chaque côté et 20 en bas, et il manque à la largeur les mêmes 80 points qu’en position fermée, selon ma lecture le bandeau à nouveau, cette fois à droite d’un écran large de 951 points, avec les indicateurs d’état dedans. L’arrangement scindé place la vue primaire et la vue secondaire côte à côte, le cas plus large que haut du guide d’Apple, et la barre d’outils se dessine horizontalement en haut à droite, là encore Partager et Terminé à côté du bouton des actions supplémentaires, les quatre actions secondaires restant absentes de la barre.⁶

Position Open, écran interne, 2853 par 2007 pixels : regular dans les deux dimensions, l’arrangement scindé côte à côte, le bandeau à droite.

Rotate Right fait passer l’écran interne en portrait. L’app sonde mesure alors 669 par 703 points, regular dans les deux dimensions, avec des marges de 134 en haut et 34 en bas et aucune sur les côtés ; selon ma lecture, le bandeau de 80 points a migré vers le bord supérieur, où les indicateurs d’état logent maintenant dans une bande noire, et l’arrangement scindé reste côte à côte alors même que le conteneur est désormais plus haut que large.⁶

L’écran interne pivoté : 669 points de large, toujours regular des deux côtés, le bandeau en haut.

Book, la position partiellement pliée, est là où l’API de régions réservées devrait justifier son existence, et dans cette bêta elle ne l’a pas fait pour mon app sonde. Sans app au premier plan, l’écran interne affichait l’écran d’accueil après l’appui sur Book ; relancée, l’app sonde a annoncé exactement ce qu’elle annonçait en Open, 803 par 515 points, regular dans les deux dimensions, et zéro division et zéro occlusion en incluant les régions inactives, en SwiftUI comme en UIKit. La position fermée annonce zéro elle aussi. Je n’ai pas trouvé de position où reservedRegions renvoie une pliure ou une caméra, une mise en page qui s’adapte à la pliure est donc quelque chose que le simulateur de cette bêta ne m’a pas laissé voir ; le guide d’Apple décrit la division comme active « when iPhone Duo is partially open » (quand l’iPhone Duo est partiellement ouvert), et savoir si c’est un manque de la bêta ou un manque de ma sonde est une question pour la prochaine bêta.⁶⁷

Deux autres constats ont tenu dans toutes les positions. La barre d’outils ne s’est jamais dessinée verticalement : toolbarVerticalEdge valait nil en SwiftUI et verticalBarEdge se lisait comme la valeur brute 0 en UIKit, fermé, ouvert et pivoté, les barres verticales que décrit le guide d’Apple ne sont donc pas apparues pour la barre d’outils d’une pile de navigation dans cette bêta. Et UIScreen.main.bounds répondait 466 par 678 points, l’écran externe, alors que l’app était sur l’écran interne, soit exactement le piège contre lequel met en garde le guide d’Apple quand il dit de fonder les calculs de mise en page « based on your scene or containing view’s bounds rather than screen dimensions » (sur les limites de votre scène ou de la vue contenante plutôt que sur les dimensions de l’écran) : l’écran principal n’est pas l’écran sur lequel vous êtes. Le compilateur annonce déjà 'main' was deprecated in iOS 26.0 à la compilation de la sonde, et cet appareil en est la raison.⁶⁷

Une voie vers les autres positions ne fonctionne pas. simctl io screenConfig peut éteindre un écran, et éteindre l’écran externe pendant que l’interne restait allumé n’a pas ouvert le téléphone ; cela a fait planter le shell système du simulateur, simctl launch a ensuite échoué avec « The system shell probably crashed. », et il a fallu redémarrer. Les positions vivent dans la fenêtre de Device Hub.⁶

Ce que la bêta ne sait pas encore faire

Apple pose trois limites sous Simulator, Known Issues, dans les notes de la bêta, le long premier lancement, l’absence de StandBy et la plupart des extensions d’app : « Initial Simulator launch can take several minutes. » (187708500), « StandBy is unavailable in the iPhone Duo Simulator runtime. » (187708663) et « Running and debugging most app extensions is unavailable in the iPhone Duo Simulator runtime. » (187708767).² La limite sur StandBy compte pour quiconque a des widgets ou des Live Activities prévus pour lui : l’annonce d’Apple dit que le téléphone « enters StandBy on either the outer or inner display » et parle d’un « hub for widgets », le billet Duo pour les développeurs détaille ce qui s’y affiche, et tant qu’une bêta ultérieure ne lève pas la limite, StandBy sur cet appareil reste à vérifier sur le matériel.¹¹

Deux autres figurent sous Mac Catalyst, Known Issues, et elles mordent toute app qui adopte ces API et se compile aussi pour le 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) », avec le contournement d’Apple #if !targetEnvironment(macCatalyst) en Swift ou #if !TARGET_OS_MACCATALYST en Objective-C, et « Projects that target iOS 27.1 show no Mac Catalyst run destination available. (187046347) », avec « Add a Mac Catalyst 27.0 minimum deployment in target settings. » pour contournement.² Les notes de la bêta Xcode 27.2 en ajoutent une troisième, venue de l’autre côté : « macOS, watchOS, tvOS, and visionOS SDKs in Xcode 27.2 incorrectly report 27.1 as a valid deployment target, » et « Mac Catalyst builds with a 27.1 or 27.2 deployment target may be unable to use newly introduced API. » (187160501).⁸

Ce que je ferais cette semaine

1. Installez la bêta à côté de Xcode 27.0 plutôt que par-dessus : décompressez le xip, renommez l’app et faites pointer DEVELOPER_DIR dessus pour les compilations en ligne de commande ; rien dans les notes de la bêta ne change la toolchain 27.0, et le compilateur comme l’éditeur de liens portent des chaînes de version identiques.⁴
2. Lancez le téléchargement du runtime avant d’en avoir besoin, avec xcodebuild -downloadPlatform iOS sous la bêta, et recommencez s’il échoue ; c’est le runtime qui rend le type d’appareil iPhone Duo amorçable, et Apple prévient que le premier lancement prend en plus plusieurs minutes.²³
3. Compilez une fois contre le SDK 27.1 avec votre cible Mac Catalyst incluse, et lisez les deux diagnostics que nomme Apple avant de décider s’il faut clôturer la nouvelle API avec #if !targetEnvironment(macCatalyst) ou relever le minimum Catalyst à 27.0.²
4. Prenez les nombres du profil comme les tailles à prévisualiser et à tester : 466 par 678 points fermé, 669 par 951 ouvert, avec un écran interne nativement en paysage. La note Previews de la bêta ajoute un groupe Display au sélecteur de surcharges du canevas, « for previewing content on a device’s alternative display. » (182598534)²⁵
5. Journalisez les régions réservées position par position pendant le développement : reservedRegions(kind:options:layoutDirectionBehavior:) avec .includeInactive est documenté comme renvoyant la pliure et la caméra sous forme de valeurs ReservedRegion pouvant être actives ou inactives ; dans cette bêta, aucune position n’en a renvoyé, une ligne de journal dans onChange(of: proxy.size) vous dira donc à quel instant une position commence à les signaler.⁶⁷

Questions fréquentes

Le simulateur iPhone Duo est-il dans Xcode 27.1 beta ?

Oui. La bêta installe un type d’appareil iPhone Duo, com.apple.CoreSimulator.SimDeviceType.iPhone-Duo, dont le profil exige un runtime iOS 27.1 que Xcode télécharge séparément via xcodebuild -downloadPlatform iOS. Les notes d’Apple préviennent que le premier lancement « can take several minutes » (peut prendre plusieurs minutes) et que StandBy ainsi que la plupart des extensions d’app sont indisponibles dans ce runtime.²³⁵

Comment installer Xcode 27.1 beta à côté de Xcode 27 ?

Décompressez le xip avec xip --expand, déplacez l’app obtenue sous un nom versionné du type /Applications/Xcode-27.1-beta.app, et réglez DEVELOPER_DIR sur son dossier Contents/Developer pour xcodebuild, xcrun et swiftc. La bêta exige macOS Tahoe 26.6 ou plus récent, le même plancher que Xcode 27.0.²⁴

Quelle est la taille de l’écran interne de l’iPhone Duo en points ?

669 par 951 points, d’après le profil d’appareil du simulateur, qui définit l’écran interne à 2007 par 2853 pixels en scale 3 avec une orientation nativement en paysage ; l’écran externe fait 466 par 678 points, issus de 1398 par 2034 pixels en scale 3.⁵

Xcode 27.1 beta modifie-t-il le SDK iOS 27.0 ou la toolchain de Xcode 27 ?

Non. Le compilateur Swift et l’éditeur de liens annoncent les mêmes chaînes de version que Xcode 27.0, et les notes de version de la bêta comptent trois sections, Mac Catalyst, Previews et Simulator, dont aucune ne touche à la toolchain. Le SDK iOS 27.1 est un ajout, identifié comme le build 24A94403 dans le SDK appareil comme dans le SDK simulateur.²⁴

Quand l’iPhone Duo sort-il, et sous quel système ?

Le 23 octobre, sous iOS 27.1, d’après la news d’Apple du 16 septembre : « When iPhone Duo becomes available on October 23, it will run iOS 27.1. »⁹

Sources