Xcode 27.1 beta：把应用放进 iPhone Duo 模拟器

Xcode 27.1 beta（27A9269）于 2026 年 9 月 18 日星期五发布，带来第一个 iOS 27.1 SDK，以及一个供模拟器使用的 iPhone Duo 设备类型，距 Xcode 27.0 只有四天。这个 SDK 收齐了 Apple 适配指南点名的全部 iPhone Duo API；设备类型的配置文件把两块显示屏定义为 3 倍缩放下的 1398 × 2034 像素和 2007 × 2853 像素，也就是 466 × 678 点与 669 × 951 点；模拟器运行时则是单独的下载，由 Xcode 按需取回。Apple 自己的说明列出了模拟器目前还做不到的三件事。我把一个针对 27.1 SDK 链接的探针应用放进 Device Hub 的三种姿态里跑：合上时它占满 466 × 678 点的屏幕，栏沿 trailing 边缘竖向排列；展开时占满 951 × 669 点的屏幕，两个方向都是 regular，折痕以 division 的形式报告，摄像头和状态列以 occlusion 的形式报告；而当应用已经在内屏上时，UIScreen.main 答的仍然是外屏。（10 月 2 日更正：在此之前，这一段说探针没有看到任何保留区域；那个探针当时被链接成了 iOS 27.0 应用。）^1245613

TL;DR

• 日期与构建版本。 Apple 的 Releases 信息源把 Xcode 27.1 beta（27A9269）标在 9 月 18 日星期五。xcodebuild -version 打印 Xcode 27.1 和 Build version 27A9269；iPhoneOS 与 iPhoneSimulator 两个 SDK 都自称 iOS 27.1、构建版本 24A94403；Swift 编译器报出的版本字符串 swiftlang-6.4.0.34.1 与 Xcode 27.0 相同，链接器的 ld-27037.1 也一样。xip 为 2,027,292,809 字节，展开后的应用 3.6 GiB，并且是装在 Xcode 27.0 旁边，不会替换它。¹⁴（10月11日：Xcode 27.1 RC（27A9275）随后于 10 月 5 日发布，App Store Connect 不仅在 TestFlight 中、也在 App Store 上接受用它构建的版本。¹⁴）（10月15日：Xcode 27.1 已作为正式版发布，构建号 27A9275，与 RC 相同，App Store Connect 当天的条目以这个名称接受其构建上架商店。¹⁵）
• Duo API 已经在 SDK 里。 我在 9 月 17 日那次检查中没能在 27.0 SDK 里找到的十个名字，在 27.1 SDK 中全部出现，其中包括 SwiftUICore 的 ArrangementView 和 reservedRegions(kind:options:layoutDirectionBehavior:)、SwiftUI 的 toolbarVerticalBehavior(_:)，以及 UIKit 的 UIArrangementViewController、preferredVerticalBarBehavior 和 verticalBarEdge。SwiftUI 给它们标的是 @available(anyAppleOS 27.1, *)；UIKit 的头文件给 arrangement 控制器和保留区域方法标的是 API_AVAILABLE(ios(27.1), tvos(27.1), visionos(27.1))，比文档页面列出的多两个平台。⁴
• 模拟器的配置文件把屏幕尺寸写了下来。 iPhone Duo 设备类型（iPhone19,4，产品类 V68，型号 A3447）定义了两块内建显示屏：primary 为 1398 × 2034 像素、缩放 3，primary-1 为 2007 × 2853 像素、缩放 3，原生方向 270。各除以 3 就是 466 × 678 点和 669 × 951 点，其中内屏的数字，正是我那篇 Duo 开发者文章在 9 月 10 日从 App Store Connect 截图尺寸推算出来的值。配置文件要求运行时为 27.1 或更高。⁵
• 把真实应用放上去会怎样（10 月 2 日更正）。 Device Hub 提供三种姿态：Closed（合上）、Book（半开）、Open（展开），另加 Rotate Right（向右旋转）。针对 27.1 SDK 链接的探针，合上时拿到整块外屏，466 × 678 点，宽度 compact，工具栏和标签栏竖立在 trailing 边缘，toolbarVerticalEdge 读作 trailing，并报告两个活动的 occlusion 区域，分别是摄像头和状态列。展开时它拿到整块内屏，原生横向的 951 × 669 点，两个方向都是 regular，栏同样是竖向的，中间还有一条 40 点宽、纵贯屏幕的非活动 division，到 Book 姿态时变为活动；旋转之后是 669 × 951 点，栏为横向。应用在内屏上时，UIScreen.main.bounds 仍然报告 466 × 678。10 月 2 日之前，这一条给出的是屏幕尺寸 466 × 678 和 951 × 669，展开时左右安全区域内边距各 34，工具栏横向，任何姿态下都没有保留区域；正文给出的则是探针量到的区域，比屏幕窄 80 点（合上时 386 点，展开时 34 点内边距之内的 803 点）。这些全部来自一个被误链接成 iOS 27.0 应用的探针：那是 27.0 SDK 的应用会得到的结果，下面的更新列出了两种构建的数据。⁶¹²¹³
• 这个 beta 还做不到什么。 Apple 的说明写道：“Initial Simulator launch can take several minutes.”（187708500）、“StandBy is unavailable in the iPhone Duo Simulator runtime.”（187708663），以及“Running and debugging most app extensions is unavailable in the iPhone Duo Simulator runtime.”（187708767）。如果你的应用同时发往 Mac，还要再加上两条 Mac Catalyst 的 Known Issues。另外还有一件 Apple 没有列出的事：运行时下载在我第一次尝试时以 Download failed. 失败，重试才成功。²³

10 月 2 日更新：9 月的探针被链接成了 iOS 27.0 应用

本文从 9 月 21 日到 10 月 2 日所载的模拟器结果，测量是对的，描述是错的。它们是 iPhone Duo 模拟器对一个用 iOS 27.0 SDK 构建的应用所做的事。我却把它们当成了模拟器对用 27.1 构建的应用所做的事。

哪里出了错。 探针是单个 Swift 文件，通过直接调用 swiftc -sdk <iPhoneSimulator27.1.sdk> 编译。这个参数能传到编译器，却传不到链接这一步。在链接时，驱动程序退回到同一个 Xcode 里的 macOS SDK，并把那个 SDK 的版本记进了二进制文件：LC_BUILD_VERSION 读作 sdk 27.0。iOS 正是根据这个数字决定给应用哪些行为。10 月 2 日重新运行同一条命令，它会把原因作为警告打印出来：“using sysroot for ‘macOS 27.0’ but targeting ‘arm64-apple-ios27.1.0-simulator’”（目标是 arm64-apple-ios27.1.0-simulator，却在使用 macOS 27.0 的 sysroot）。如果 9 月时它也打印了这条警告，我并没有把它当成任何问题的原因。¹³

怎么发现的。 10 月 2 日，我在同一个模拟器上运行了一个真实应用，它由 Xcode 27.1 beta 用同一个 SDK 构建。它的工具栏和标签栏沿外屏侧边竖立，而探针的工具栏和标签栏当初是横躺在顶部的。对两个二进制文件运行 otool -l，应用显示 sdk 27.1，按 9 月的方式重新构建的探针显示 sdk 27.0。设置 SDKROOT 后重新构建，探针读作 sdk 27.1，表现也与那个应用一致。另外，用 Xcode 27.0 本身、针对真正的 iOS 27.0 SDK 编译的一个简化版探针，得到的窗口与被错误标记的那个版本相同，所以 9 月的数字确实如实反映了 27.0 构建的情况。¹³

重新运行。 同一份源码，两种方式链接，在每种姿态下，运行在同一个 Xcode 27.1 beta（27A9269）和运行时（24A94401）上：¹³

撤回的内容。 三条陈述，每一条对 27.0 构建都成立，对标记为 27.1 的构建都不成立：工具栏从未竖着画过；reservedRegions 在任何姿态下都什么也没返回；模拟器只把状态侧轨旁边的那块屏幕给了应用。第四条错在原因上：我写过，旋转后 split 形式的 arrangement“stays side by side even though the container is now taller than it is wide”（即便容器此时高大于宽，仍保持左右并排）。实际上，探针里的 arrangement 视图在那块屏幕中本身就是宽大于高，而它是按自己的形状来分栏的；一个填满旋转后屏幕的 arrangement 会上下堆叠，正如 Apple 指南所说。第五条：TL;DR 给出的是屏幕尺寸 466 × 678 和 951 × 669，而正文给出的是探针量到的区域，窄了 80 点（合上时 386 点，展开时 34 点内边距之内的 803 点）；27.0 构建从未拿到过整块屏幕。⁷¹³

仍然成立的内容。 模拟器一节之外的一切：日期与构建版本、SDK 符号表、设备配置文件及其像素和点尺寸、运行时下载、Apple 的 Known Issues。在这一节之内：屏幕尺寸、尺寸类别、Device Hub 提供的姿态、screenConfig 引发的崩溃，以及 UIScreen.main 陷阱；最后这一条在重新运行中以 27.1 标记再次复现。本次更新所取代的 9 月 24 日说明曾推测，那些 0 来自读取保留区域过早，并承诺在若干铰链角度下重新运行。这个推测是错的：27.0 构建无论询问多久都不会返回任何区域。但它从 Molzahn 那里引用的观察成立：正确链接的探针在前六到九次求值中读不到任何区域，此后则全部读到。按铰链角度的运行没有做。¹²¹³

如果您照着本文自己做过探针，请检查一下：otool -l <app>/<binary> | grep -A4 LC_BUILD_VERSION。用 Xcode 构建的项目会被正确标记。手工编译的文件，需要在运行 swiftc 之前把 SDKROOT export 为模拟器 SDK。发现这个问题的实战示例里有三方对比，还加上了 iOS 26 标记的情况。

10 月 26 日更新：手机搭载 27.1 发售，以及正式版 SDK 的版本号

据 Apple 新闻编辑室和 Apple 的安全更新页面，iPhone Duo 于 10 月 23 日星期五搭载 iOS 27.1 进入零售店；安全更新页面列出的“iOS 27.1”只对应“iPhone Duo”，没有已公开的 CVE 条目；Releases 信息源从未出现过 iOS 27.1 条目，27.1 的发行说明页面也始终没有出现，索引只列出 27 和 27.2。在这台 Mac 上，Xcode 27.1（27A9275）自 10 月 15 日起就是正式版，iPhoneOS 与 iPhoneSimulator SDK 自称 iOS 27.1、构建版本 24A94232，比上文记录的 beta 的 24A94403 还小；iOS 27.1 模拟器运行时为 24A94425，xcrun simctl list runtimes -j 为它只列出一种受支持的设备类型，即 iPhone Duo；针对它 simctl create 一台 iPhone 16 Pro 会失败，报“Incompatible device”。iOS 27.2 于今天（10 月 26 日）发布（24B119，同一分钟还有第二个 iOS 27.2 构建 24B91020），而 Xcode 27.2 RC（27B48，10 月 19 日）的说明载有四条 iPhone Duo 条目：“Fixed: In the iPhone Duo simulator, an app using CameraCaptureAccessory can use both displays at the same time without an active camera capture session.”（已修复：在 iPhone Duo 模拟器中，使用 CameraCaptureAccessory 的应用可以在没有活动相机捕获会话的情况下同时使用两块显示屏。）（190155353）；“When switching between the inner and outer display of the iPhone Duo simulator, modifier keys such as Shift and Command might stop working.”（在 iPhone Duo 模拟器的内屏和外屏之间切换时，Shift 和 Command 等修饰键可能失灵。）（189465196），变通办法是“Click with the mouse on the currently visible screen.”（用鼠标点击当前可见的屏幕。）；以及两条沿用自 beta 的已知问题，现在都归在 Device Hub 下：截图“black for up to a few minutes after booting the device”（设备启动后最多几分钟内是黑的）（187146039），以及辅助功能工具“cannot convey screen content on an iPhone Duo within Device Hub”（无法在 Device Hub 内传达 iPhone Duo 上的屏幕内容）（187148389）。关于“APIs specific to iOS 27.1”（iOS 27.1 专有的 API）的 Mac Catalyst 条目没有变化。iOS 27.2 的说明里有一条 UIKit 条目点名了 27.1，即 UIView 默认布局边距归零；一个由同一份源码构建、在 iPhone Duo 模拟器的 27.1 运行时上运行的探针，在其 LC_BUILD_VERSION 标记为 sdk 27.0 时报告 8 点（也就是上文 10 月 2 日更新所警告的手工编译陷阱），标记为 sdk 27.1 时报告零，所以这项变化既取决于系统，也取决于二进制文件链接的 SDK；表格见 iOS 27.2 发行说明一文。¹⁶

这个 beta 里有什么？

Apple 的 Releases 信息源把“Xcode 27.1 beta (27A9269)”列在 9 月 18 日星期五上午 10 点（太平洋时间），当天下午还有一条“TestFlight Update”；App Store Connect 同日的发行说明写道：“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.”¹ 发行说明的 Overview 则点名了 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.”² 这份清单要照字面读：停在 27.1 的平台只有 iOS，SDK 自己的 SDKSettings.plist 报告的版本也是 27.1，而 App Store Connect 把同一个 SDK 叫作“iPadOS 27.1 beta”，这道别扭之处由那篇 Xcode 27 的文章一路带着。

下载比版本号给人的印象要小。xip 为 2,027,292,809 字节，由 Apple 的 Software Update 证书签名，展开后是一个 3.6 GiB 的应用，与 Xcode 27.0 同样大小；就命令行工作而言，用 xip --expand 展开到一个文件夹、重命名为 /Applications/Xcode-27.1-beta.app、再把 DEVELOPER_DIR 指过去，安装就到此为止。随后在 beta 下的第一次 xcodebuild 调用自行花了大约两分钟，安装随包附带的 CoreTypes.pkg 和 XcodeSystemResources.pkg，也就是 xcodebuild -runFirstLaunch 会显式执行的那一步；而其中第二个包，正是把 iPhone Duo 设备类型安放到位的那一个。⁴ 应用里没有的，是模拟器运行时。beta 找到了这台 Mac 上已有的各个 iOS 运行时，其中有 27.0，却没有 27.1；在 beta 下运行 xcodebuild -downloadPlatform iOS，它把缺失的那块称为“iOS 27.1 Simulator (24A94401)”，并通过 Apple 的 mobile-asset 服务以 cryptex 磁盘映像的形式取回，而开发者下载页面上的磁盘映像本身还停在 iOS 18.2 Simulator Runtime。³⁴ 第一次尝试以 DVTDownloadable: Download Failed 和 Error Domain=DVTDownloadableErrorDomain Code=41 "Download failed." 告终；第二次加上 -buildVersion 24A94401，把运行时报告为 7.85 GB，顺利跑完，随后 simctl list runtimes 里就列出了“iOS 27.1 (27.1 - 24A94401)”。磁盘空间要预留够：这个运行时是 Xcode 下载量的四倍。³

iPhone Duo 模拟器首次启动时的外屏，1398 × 2034 像素：状态区沿右侧边缘竖着排列，正是 Apple 的 Human Interface Guidelines 在 iPhone Duo 上安放 Dynamic Island 与状态栏的那一侧。¹⁰

怎样获取 iPhone Duo 模拟器？

一共三步，没有一步是网页上的下载按钮。Apple 只在 Xcode 里提供这个模拟器，而且只在 27.1 beta 里：27.2 beta 的说明中有一段旁注写道“Download Xcode 27.1 beta to get the iOS SDK and simulator support for iPhone Duo.”（下载 Xcode 27.1 beta，即可获得 iPhone Duo 的 iOS SDK 和模拟器支持）。⁸（10月11日：Xcode 27.1 RC（27A9275）已于 10 月 5 日发布，其说明列出了同样的 iPhone Duo Simulator 已知问题，因此说明涵盖 Duo 模拟器的 Xcode 27.1 已不再只有 beta；我还没有安装 RC。¹⁴）（10月15日：Xcode 27.1 已作为正式版发布，构建号 27A9275，与 RC 相同，其说明列出了同样两个 Duo 模拟器已知问题；我也没有安装它。¹⁵）

1. Xcode 27.1 beta（27A9269），从开发者下载页面获取，Apple 的 Releases 信息源把它标在 9 月 18 日星期五。展开 xip，把应用以带版本号的名称（例如 /Applications/Xcode-27.1-beta.app）移到 Xcode 27.0 旁边，并在命令行工作时把 DEVELOPER_DIR 指向它；这个 beta 要求 macOS Tahoe 26.6 或更高版本。¹²
2. iOS 27.1 运行时，xip 里并不包含。在 DEVELOPER_DIR 指向 beta 的情况下运行 xcodebuild -downloadPlatform iOS，它会取回让 iPhone Duo 设备类型可以启动的 27.1 运行时；Apple 的说明还提醒，除了下载之外，Simulator 首次启动“can take several minutes”（可能要花上几分钟）。我第一次尝试失败了，重试后成功，所以请先重试，再去排查原因。²³
3. Device Hub，设备和它的姿态都在这里。添加或选中 iPhone Duo 设备，启动它，然后使用姿态按钮 Closed、Book 和 Open，以及 Rotate Right；simctl 没有姿态命令。下文按姿态给出的尺寸和截图都来自这条路径。⁶

Apple 没有浏览器版本。搜索“iPhone Duo simulator online”找到的页面并没有运行 Apple 的 iOS 27.1 运行时，所以无论它画出什么，都不是这里测得的尺寸类别、保留区域或外屏行为的来源；如果想在没有运行时的情况下检查布局，这个 beta 为 Xcode 的 Previews 画布加了一个面向备用显示屏的 Display 分组。²

27.1 SDK 里有 Duo API 吗？

9 月 17 日，我按 Apple 那份“Preparing your app for iPhone Duo”指南里的名字去搜 iOS 27.0 SDK，专属于这台设备的十个一个也没找到。同样的搜索、同样的做法，也就是对模块接口和头文件做一次朴素的文本搜索，换到 27.1 SDK 上就全都找得到。表中的行是搜索用的子串：其中七行承载了十个名字里的九个，因为两个 reservedRegions 方法共用一行，两个 axisBehavior 成员也共用一行；另外三行是这些名字背后的类型，即 ReservedRegion、对应 toolbarVerticalBehavior(_:) 的 ToolbarVerticalBehavior，以及对应 preferredVerticalBarBehavior 的 UIVerticalBarBehavior。⁴

这张表里有两处细节会影响你怎么写代码。其一，SwiftUI 的那些类型住在 SwiftUICore 里，而这个模块由 import SwiftUI 再导出，所以普通的 import 就能找到它们；其二，可用性属性在平台范围上与文档不一致。SwiftUICore 接口声明 ArrangementView、SwiftUI 接口声明 toolbarVerticalBehavior(_:)，两者都在 @available(anyAppleOS 27.1, *) 之下，而 anyAppleOS 是 Apple 用来表示“该版本的所有平台”的简写；与此同时，UIArrangementViewController.h 以及 UIView.h 里的 reservedRegionsOfKind: 方法带的是 API_AVAILABLE(ios(27.1), tvos(27.1), visionos(27.1)) 加上 API_UNAVAILABLE(watchos)；在 UIVerticalBarEdge.h 中，枚举和 verticalBarEdge 特性带着同一组标注，而 Leading 与 Trailing 两个成员带的是 API_AVAILABLE(ios(27.1)) API_UNAVAILABLE(visionos) API_UNAVAILABLE(watchos, tvos)。Apple 这五个名字的文档页面，都只列出 iOS 27.1 和 iPadOS 27.1，并标记为 beta。⁴⁷ 照着 iOS 写，其余的让编译器告诉你。

指南用到的名字里，已经存在于 27.0 SDK 的那三个没有变化：presentationPlacement(_:) 仍在 @available(anyAppleOS 27.0, *) 之下，backgroundExtensionEffect() 从 iOS 26 起就一直在；至于指南点名的两个 ToolbarItemPlacement 成员，topBarPinnedTrailing 在 @available(iOS 27.0, visionOS 27.0, *) 之下，而 cancellationAction 除了类型本身的可用性之外没有另行标注。⁴

模拟器的配置文件怎么说这两块屏？

Apple 随 beta 装上的设备类型 iPhone Duo.simdevicetype，是 /Library/Developer/CoreSimulator/Profiles/DeviceTypes 下一个朴素的 bundle，而它的两个属性列表回答了规格表留着没说的问题。⁵

profile.plist 给出身份：型号标识符 iPhone19,4，产品类 V68，别名 com.apple.CoreSimulator.SimDeviceType.V68，minRuntimeVersion 为 27.1，还有一条规则，让 27.1 及以上的运行时默认创建这台设备。capabilities.plist 给出硬件：型号 A3447，HomeButtonType 为 2，DeviceSupportsDynamicIsland 为 true，DeviceSupportsEnhancedMultitasking 为 false，IsLargeFormatPhone 为 true，CompatibleDeviceFallback 为 iPhone18,3，设备圆角半径 59，以及一个包含两个内建条目和三个虚拟条目的 displays 数组。⁵

第一行是外屏，与 Apple 的规格表逐像素吻合。第二行是内屏，而它的像素数是 App Store Connect 的截图尺寸 2007 × 2853，而非面板自身的 1878 × 2670：模拟器把内屏按 3 倍缩放渲染成 669 × 951 点，这正是那篇 Duo 开发者文章在 9 月 10 日做过、并明确标注为推断的那道算术。如今 Apple 自己的配置文件带上了这个数字。270 度的原生方向说明内屏是原生横向的，设备展开时宽 951 点、高 669 点，这与 Apple 给出的展开状态尺寸一致。剩下两个数字属于模拟器而非硬件：两块屏都写着每英寸 460 像素、60 Hz，而规格表给内屏面板的是 430 ppi，所以请把 hdpi 当作占位值。⁵

配置文件还带来了形状。每块显示屏都引用一个帧缓冲遮罩，也就是一份描述可见区域的 PDF。外屏的遮罩四角并不对称，配置文件里的值是一条长边 8、另一条长边 59；依我的判断，半径小的那一侧就是 Apple 设计指南所说的、与中间铰链相接的那一侧。内屏的遮罩则是一个普通的圆角矩形，用的就是配置文件里 55 的圆角值，并且没有为前置摄像头留挖空；也就是说，摄像头造成的遮挡来自运行时的保留区域 API，而不是帧缓冲的形状。⁵¹⁰

模拟器里能看到什么？

设备以合上的状态启动。首次启动时外屏显示主屏幕，内屏的帧缓冲亮着却是黑的；simctl io enumerate 会按配置文件里的名字把两块内建屏幕都列出来，primary 为 1398 × 2034，primary-1 为 2007 × 2853，与那些常见的虚拟屏并排。⁶ 姿态住在 Device Hub 里。选中这台 Duo 设备后，它的窗口会把 Rotate Right、Closed、Book 和 Open 显示为辅助功能 API 可以按下的按钮，本节的全部内容都是这么驱动出来的；simctl 没有切换姿态的命令。⁶

探针是一个单文件的 SwiftUI 应用：一个标签视图，里面是带五个工具栏项目的导航堆栈；一块读数区，显示几何信息、尺寸类别、toolbarVerticalEdge 环境值、铰链，以及带 includeInactive 的两类保留区域；还有一个 split 样式的 ArrangementView。它在每次 body 求值时读取保留区域，并每秒重新求值一次。下面的数字来自 10 月 2 日的重新运行，针对 27.1 SDK 链接；9 月那几次被误链接成 27.0 的运行，放在后面单独的标题下。¹³

针对 27.1 SDK 链接

Closed。 应用拿到整块外屏：窗口为 466 × 678 点，宽 compact、高 regular。工具栏和标签栏竖立在时钟下方的 trailing 边缘，toolbarVerticalEdge 读作 trailing，UIKit 的 verticalBarEdge 特性读作原始值 2。导航堆栈内的内容为 382 × 562 点，安全区域内边距为顶部 82、底部 34、trailing 一侧 84，这 84 点就是侧轨。系统报告了两个 occlusion 区域，都是活动的：一个是外屏摄像头所在处 37 点见方的区域，另一个是栏上方覆盖摄像头和状态列的 84 × 170 区域。这块屏幕上没有报告 division。横过来之后是 678 × 466，两个尺寸类别都是 compact，栏仍在 trailing 边缘。¹³

Closed，27.1 SDK：整块 466 × 678 点的屏幕，栏沿 trailing 边缘竖向排列。

Open。 应用移到内屏，处于其原生的横向方向：951 × 669 点的窗口，两个尺寸类别都是 regular，栏仍竖立在 trailing 边缘。内容为 867 × 553，三处内边距不变。系统返回三个区域。一条 40 点宽的 division 在屏幕中部纵贯上下，从 x 455 到 495，两侧各有 20 点边距，它是非活动的：手机是平的。一个 58 × 37 的非活动 occlusion 标出内屏摄像头，按 Apple 设计规范的说法，这颗摄像头“stays hidden until the camera is active.”（在摄像头启用之前一直隐藏）。¹⁰ 一个 84 × 120 的活动 occlusion 覆盖状态列。split 形式的 arrangement 把两个窗格左右并排，平分宽度。¹³

Open，27.1 SDK：951 × 669 点，折痕被报告为一条纵贯中部的非活动 division。

Book。 Device Hub 的 Book 姿态把铰链报告为部分展开，127 度。窗口尺寸不变。变的是 division：框架相同，现在是活动的。split 形式的 arrangement 随之把分隔线移到折痕上，并让那条 40 点的带子空着，于是主窗格止于 x 455，次窗格从 495 开始。在这个姿态下弹出的表单会偏离中心，移到 leading 一侧的那一半。¹³

Book，27.1 SDK：division 变为活动，split 形式的 arrangement 让折痕处空着。

旋转。 在展开状态下按 Rotate Right，得到 669 × 951 点的窗口，两个尺寸类别仍是 regular，栏回到横向：toolbarVerticalEdge 为 nil，工具栏位于顶部时钟旁边，标签栏浮在底部。这与 Apple 的设计规范一致，规范在竖屏的内屏上保留“standard horizontal bars”（标准的横向栏）。¹⁰ 同样三个区域在旋转后的坐标空间中报告：division 现在是一条横贯中部、高 40 点的带子，平放时非活动，Book 时活动。探针的 arrangement 视图在那块屏幕中宽大于高，所以仍保持左右并排。¹³

Open 并旋转，27.1 SDK：栏为横向，折痕现在是一条横带。

有两件事在每种姿态下都成立。其一，保留区域到得晚：每次启动时，探针 body 的前六到九次求值读不到任何区域，之后的每一次都能全部读到，所以只在第一次布局时问一次的视图，得到的是一个空答案。Sven-Eric Molzahn 的 DuoProbe 测试夹具在 9 月 20 日就记录了这一现象，以及那条 40 点的带子：“reservedRegions is empty on the first geometry evaluation and populated on a later one”（reservedRegions 在第一次几何计算时为空，在之后的某次计算中才有内容）。SwiftLee 9 月 22 日的模拟器指南补充说“Holding Option ⌥ reveals a slider that you can use to control the hinge angle of the device with precision”（按住 Option ⌥ 会出现一个滑块，可以用它精确控制设备的铰链角度），这个滑块我没有用过。¹² 其二，当应用在内屏上时，UIScreen.main.bounds 答的是 466 × 678 点，也就是外屏，这正是 Apple 指南提醒要把布局计算“based on your scene or containing view’s bounds rather than screen dimensions”（基于场景或所在视图的 bounds，而不是屏幕尺寸）时所警告的陷阱：主屏幕并不是你正身处的那块屏幕。窗口场景自己的屏幕，报告的才是应用实际所在的那块显示屏。⁷¹³

通往其他姿态的路，有一条是走不通的。simctl io screenConfig 可以把某块屏幕断电，但在内屏亮着的情况下把外屏断电，并不会让手机展开；它反而让模拟器的 system shell 崩溃，随后的 simctl launch 以“The system shell probably crashed.”失败，只能重启。姿态住在 Device Hub 的窗口里。⁶

针对 27.0 SDK 链接

以下是本节在 10 月 2 日之前所载的数字：9 月 19 日和 20 日用一个有导航堆栈、没有标签视图的探针测得，10 月 2 日又用当前的探针重测了一遍。它们描述的是用 Xcode 27.0 构建的应用在这个模拟器上得到的东西。⁶¹³

Closed 时，窗口在 466 点宽的屏幕上只有 386 点宽：系统把 80 点的侧轨留给自己，在那里以黑底绘制时钟和状态，应用的工具栏横躺在顶部。Open 时，窗口为 871 × 669，右侧同样少了 80 点，左右安全区域内边距各 34。Open 并旋转时，这 80 点改从顶部扣除。在每种姿态下，尺寸类别都与 27.1 构建相同，toolbarVerticalEdge 为 nil，verticalBarEdge 读作原始值 0，两次保留区域查询即便算上非活动区域、无论探针持续询问多久，都返回空数组；Book 与 Open 毫无区别。

Closed，以 27.0 链接：应用止步于侧轨，工具栏保持横向。

Open，以 27.0 链接：两个方向都是 regular，侧轨被系统占着。

旋转，以 27.0 链接：横贯顶部的那条带子属于系统。

这个 beta 还做不到什么

Apple 在 beta 自己的说明中，于 Simulator、Known Issues 下列了三条限制：“Initial Simulator launch can take several minutes.”（187708500）、“StandBy is unavailable in the iPhone Duo Simulator runtime.”（187708663），以及“Running and debugging most app extensions is unavailable in the iPhone Duo Simulator runtime.”（187708767）。² 其中 StandBy 那条，对于做了相应小组件或实时活动的人很要紧：Apple 的发布稿说这台手机“enters StandBy on either the outer or inner display”（在外屏或内屏上进入 StandBy），并把它称作“hub for widgets”（小组件的中枢）；那里会出现什么，那篇 Duo 开发者文章已经讲过。在后续 beta 解除这条限制之前，这台设备上的 StandBy 只能到真机上去验（10月15日：正式版的说明仍列有这一条¹⁵）。¹¹

另外两条位于 Mac Catalyst、Known Issues 之下，会咬到任何既采用这些 API、又要为 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)”，Apple 给的绕行办法是在 Swift 中用 #if !targetEnvironment(macCatalyst)、在 Objective-C 中用 #if !TARGET_OS_MACCATALYST；以及“Projects that target iOS 27.1 show no Mac Catalyst run destination available. (187046347)”，绕行办法是“Add a Mac Catalyst 27.0 minimum deployment in target settings.”。² Xcode 27.2 beta 的说明又从另一个方向补上第三条：“macOS, watchOS, tvOS, and visionOS SDKs in Xcode 27.2 incorrectly report 27.1 as a valid deployment target,”以及“Mac Catalyst builds with a 27.1 or 27.2 deployment target may be unable to use newly introduced API.” (187160501)。⁸

这周我会做什么

1. 把 beta 装在 Xcode 27.0 旁边，而不是覆盖它：展开 xip、重命名应用，再把 DEVELOPER_DIR 指向它用于命令行构建。beta 的说明里没有任何一项改动 27.0 的工具链，编译器和链接器的版本字符串也完全相同。⁴
2. 在真正需要之前就开始下载运行时：在 beta 下执行 xcodebuild -downloadPlatform iOS，失败就重试。正是这个运行时让 iPhone Duo 设备类型可以启动，而且 Apple 还警告说首次启动要再花上几分钟。²³
3. 带上 Mac Catalyst 目标，对着 27.1 SDK 构建一次，并在决定是用 #if !targetEnvironment(macCatalyst) 把新 API 围起来、还是把 Catalyst 最低部署版本提到 27.0 之前，先读一读 Apple 点名的那两条诊断。²
4. 把配置文件里的数字当作预览和测试的尺寸：合上 466 × 678 点，展开 669 × 951 点，内屏原生横向。beta 的 Previews 说明还在画布的覆盖选择器里加了一个 Display 分组，“for previewing content on a device’s alternative display.”（用于在设备的另一块显示屏上预览内容）(182598534)²⁵
5. 在会被反复读取的地方读取保留区域：在视图的 body 里通过几何代理读取，或者在每次几何变化时读取，绝不要只在第一次布局时读一次。带 .includeInactive 的 reservedRegions(kind:options:layoutDirectionBehavior:) 在探针的前六到九次求值中什么也没返回，之后的每一次都返回这块屏幕上的全部区域（合上时是摄像头和状态列；展开时是折痕、内屏摄像头和状态列），所以第一次求值时缓存下来的值，在这个视图的整个生命周期里都是空数组。另外，在相信这一切之前，先确认构建被标记为 27.1 SDK：otool -l <app>/<binary> | grep -A4 LC_BUILD_VERSION。⁷¹³

常见问题

Xcode 27.1 beta 里有 iPhone Duo 模拟器吗？

有。这个 beta 会装上一个 iPhone Duo 设备类型，即 com.apple.CoreSimulator.SimDeviceType.iPhone-Duo，它的配置文件要求一个 iOS 27.1 运行时，而该运行时由 Xcode 通过 xcodebuild -downloadPlatform iOS 单独下载。Apple 的说明提醒，首次启动“can take several minutes”（可能要花上几分钟），并且在该运行时中无法使用 StandBy 和大多数 App Extension。²³⁵

如何获取 iPhone Duo 模拟器？

安装 Xcode 27.1 beta，在该 beta 下用 xcodebuild -downloadPlatform iOS 下载 iOS 27.1 运行时，然后在 Device Hub 里选择 iPhone Duo 设备，姿态就是那里的按钮。27.2 beta 并不包含它；Apple 的 27.2 说明把开发者指向 27.1 beta，以获得“the iOS SDK and simulator support for iPhone Duo.”（iPhone Duo 的 iOS SDK 和模拟器支持）。²³⁸（10月11日：Xcode 27.1 RC（27A9275）已于 10 月 5 日发布，其说明列出了同样的 iPhone Duo Simulator 已知问题，因此说明涵盖 Duo 模拟器的 Xcode 27.1 已不再只有 beta；我还没有安装 RC。¹⁴）（10月15日：Xcode 27.1 已作为正式版发布，构建号 27A9275，与 RC 相同，其说明列出了同样两个 Duo 模拟器已知问题；我也没有安装它。¹⁵）

有在线的 iPhone Duo 模拟器吗？

Apple 没有提供。在 RC 推出之前，这个模拟器只随 Xcode 27.1 beta 提供，运行的是 Apple 的 iOS 27.1 运行时；打着这个名字的浏览器页面画的是别的东西。如果只想快速检查布局，beta 的 Previews 画布提供了面向备用显示屏的 Display 分组。²（10月11日：Xcode 27.1 RC（27A9275）已于 10 月 5 日发布，其说明列出了同样的 iPhone Duo Simulator 已知问题，因此说明涵盖 Duo 模拟器的 Xcode 27.1 已不再只有 beta；我还没有安装 RC。¹⁴）（10月15日：Xcode 27.1 已作为正式版发布，构建号 27A9275，与 RC 相同，其说明列出了同样两个 Duo 模拟器已知问题；我也没有安装它。¹⁵）

怎样把 Xcode 27.1 beta 装在 Xcode 27 旁边？

用 xip --expand 展开 xip，把得到的应用移成一个带版本号的名字，例如 /Applications/Xcode-27.1-beta.app，再为 xcodebuild、xcrun 和 swiftc 把 DEVELOPER_DIR 设到它的 Contents/Developer 文件夹。这个 beta 要求 macOS Tahoe 26.6 或更高，与 Xcode 27.0 的门槛相同。²⁴

iPhone Duo 内屏按点算是多大？

669 × 951 点。模拟器的设备配置文件把内屏定义为缩放 3 下的 2007 × 2853 像素，且原生方向为横向；外屏则是缩放 3 下的 1398 × 2034 像素，合 466 × 678 点。⁵

Xcode 27.1 beta 会改动 iOS 27.0 SDK 或 Xcode 27 的工具链吗？

不会。Swift 编译器和链接器报出的版本字符串与 Xcode 27.0 相同，而这个 beta 的发行说明只有 Mac Catalyst、Previews 和 Simulator 三节，没有一节触及工具链。iOS 27.1 SDK 是新增的，在设备端和模拟器端的 SDK 中都标识为构建版本 24A94403。²⁴

iPhone Duo 什么时候发售，运行什么系统？

10 月 23 日，运行 iOS 27.1，依据是 Apple 9 月 16 日的新闻稿：“When iPhone Duo becomes available on October 23, it will run iOS 27.1.”⁹（10 月 26 日：确实如此，而且 iOS 27.1 没有在其他任何设备上发布；Apple 的安全页面只把它列给 iPhone Duo，这台 Mac 上的 27.1 模拟器运行时也只接受 iPhone Duo 这一种设备类型。¹⁶）

本站相关内容：Duo 开发者文章给出了这篇文章拿去和 SDK 对照的参数表数字与 API 清单；为 iPhone Duo 做设计的文章读的是 Apple 的设计指南；可调整大小的 iPhone 检查清单正是这些配置文件数字要喂进去的布局功课；Xcode 27 汇总文章收着按日期编排的 beta 小节；Xcode 27 构建失败文章讲的是这个 beta 没有动过的工具链；iOS 27 发行说明文章则在追 27.x 的构建。

参考来源