Xcode 27.1 beta：在 iPhone Duo 模擬器上跑您的 App

Xcode 27.1 beta（27A9269）於 2026 年 9 月 18 日（週五）推出，帶來第一個 iOS 27.1 SDK，以及模擬器可用的 iPhone Duo 裝置類型，比 Xcode 27.0 晚四天。這個 SDK 收錄了 Apple 準備指南點名的每一個 iPhone Duo API；裝置類型的設定檔把兩塊螢幕定義為 1398 × 2034 與 2007 × 2853 像素、scale 3，換算後是 466 × 678 與 669 × 951 點；模擬器執行環境則是另外的下載，由 Xcode 依需要抓取。Apple 自己的說明列出模擬器目前還做不到的三件事；而一支以 27.1 SDK 連結的探測 App 走過 Device Hub 的三種姿態後，闔上時填滿 466 × 678 點的螢幕，各列沿後緣排列，展開時填滿 951 × 669 點的螢幕，後者兩個 size class 都是 regular，摺疊處以分隔區域回報、相機與狀態直欄以遮蔽區域回報，而且 App 明明跑在內側螢幕上，UIScreen.main 仍然回答外側螢幕的數值。（10 月 2 日更正：在此之前，這一段寫的是探測 App 看不到任何保留區域；那支探測 App 當時被連結成了 iOS 27.0 App。）^1245613

重點摘要

• 日期與 build 編號。 Apple 的發佈摘要把 Xcode 27.1 beta（27A9269）繫在 9 月 18 日（週五）。xcodebuild -version 印出 Xcode 27.1 與 Build version 27A9269；iPhoneOS 與 iPhoneSimulator 兩份 SDK 都自稱 iOS 27.1、build 24A94403；Swift 編譯器回報的版本字串 swiftlang-6.4.0.34.1 與 Xcode 27.0 相同，連結器同樣是 ld-27037.1。xip 檔為 2,027,292,809 位元組，解開後的 App 是 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 當天的條目以這個名稱接受它的建置上架 App Store。¹⁵）
• 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 像素、scale 3，primary-1 為 2007 × 2853 像素、scale 3，原生方向 270。除以三之後分別是 466 × 678 與 669 × 951 點，其中內側那組數字，正是我在 9 月 10 日的 Duo 開發者文章裡，從 App Store Connect 的螢幕截圖尺寸推得的那組。設定檔要求執行環境 27.1 以上。⁵
• 模擬器面對真實 App 的表現（10 月 2 日更正）。 Device Hub 提供三種姿態，Closed（闔上）、Book（書本狀）與 Open（展開），外加 Rotate Right（向右旋轉）。以 27.1 SDK 連結的探測 App，闔上時拿到整塊外側螢幕，466 × 678 點、寬度 compact，工具列與標籤列立在後緣，toolbarVerticalEdge 讀出 trailing，並有兩個作用中的遮蔽區域，也就是相機與狀態直欄。展開時，它拿到整塊內側螢幕，以橫向為原生方向的 951 × 669 點，兩個 size class 都是 regular，各列同樣垂直，中央有一條寬 40 點、非作用中的分隔區域，到了 Book 姿態就轉為作用中；旋轉後為 669 × 951，各列改為橫向。App 在內側螢幕上時，UIScreen.main.bounds 仍持續回報 466 × 678。10 月 2 日之前，這一條列出的是螢幕尺寸 466 × 678 與 951 × 669，展開時左右各有 34 的安全區域邊距，工具列橫向，任何姿態都沒有保留區域；內文列出的則是探測 App 量到的範圍，比螢幕窄 80 點（闔上時 386 點，展開時在 34 點邊距之內為 803 點）。這些全都來自一支誤被連結成 iOS 27.0 App 的探測 App：那是 27.0 SDK 拿到的結果，下方的更新收錄了兩種建置。⁶¹²¹³
• 這個 beta 還做不到的事。 Apple 的說明列出三項限制，分別是漫長的首次啟動、缺席的 StandBy，以及大多數 App Extension：「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）。如果您的 App 同時也在 Mac 上推出，還要再加上兩則 Mac Catalyst 的 Known Issues；另外有一件 Apple 沒有列出來的事：執行環境的下載在我這裡第一次以 Download failed. 收場，重試才成功。²³

10 月 2 日更新：9 月的探測 App 被連結成了 iOS 27.0 App

本文從 9 月 21 日到 10 月 2 日所刊載的模擬器結果，量測無誤，描述卻錯了。它們是 iPhone Duo 模擬器面對一支以 iOS 27.0 SDK 建置的 App 時的表現，我卻把它們寫成面對以 27.1 建置的 App 時的表現。

哪裡出了錯。 探測 App 是一個 Swift 檔案，直接呼叫 swiftc -sdk <iPhoneSimulator27.1.sdk> 編譯而成。這個旗標送得到編譯器，卻送不到連結步驟；在那一步，驅動程式退回使用同一個 Xcode 裡的 macOS SDK，並把該 SDK 的版本寫進二進位檔：LC_BUILD_VERSION 讀出來是 sdk 27.0。iOS 正是依據這個數字，決定 App 能拿到哪些行為。10 月 2 日再執行一次，同一道指令以警告的形式印出了原因：「using sysroot for ‘macOS 27.0’ but targeting ‘arm64-apple-ios27.1.0-simulator’」（使用了「macOS 27.0」的 sysroot，目標卻是「arm64-apple-ios27.1.0-simulator」）；假如它在 9 月也印過這一行，我當時並沒有把它看成任何問題的原因。¹³

怎麼發現的。 10 月 2 日，我在同一個模擬器上執行了一支真正的 App，由 Xcode 27.1 beta 以同一份 SDK 建置。它的工具列與標籤列沿著外側螢幕的側邊立著，而探測 App 的各列當時是橫躺在頂端。對兩個二進位檔執行 otool -l，App 顯示 sdk 27.1，以 9 月那種方式重新建置的探測 App 則顯示 sdk 27.0。設定好 SDKROOT 再重新建置後，探測 App 讀出 sdk 27.1，行為也和那支 App 一致。另外，一個由 Xcode 27.0 本身、對著真正的 iOS 27.0 SDK 編譯的陽春版探測 App，拿到的視窗和那支標錯版本的探測 App 完全相同，所以 9 月的數字確實足以代表 27.0 建置的樣貌。¹³

重新執行。 同一份原始碼，以兩種方式連結，在每一種姿態下執行，使用同一個 Xcode 27.1 beta（27A9269）與執行環境（24A94401）：¹³

撤回的內容。 三項陳述，每一項對 27.0 建置都成立，對標記為 27.1 的建置則不成立：工具列從未直向繪製；reservedRegions 在任何姿態下都回傳空的結果；以及模擬器只把狀態直欄旁的那塊畫面交給 App。第四項錯在原因：我寫過，旋轉之後分割式 arrangement「stays side by side even though the container is now taller than it is wide」（即使容器已經高於寬，仍維持左右並排）。其實探測 App 裡的 arrangement view，在那塊畫面中本身就是寬大於高，而它是依自己的形狀來分割的；一個填滿旋轉後螢幕的 arrangement 會上下堆疊，正如 Apple 指南所說。第五項：重點摘要列出的是螢幕尺寸 466 × 678 與 951 × 669，內文列出的卻是探測 App 量到的範圍，窄了 80 點（闔上時 386 點，展開時在 34 點邊距之內為 803 點）；27.0 建置從來沒有拿到整塊螢幕。⁷¹³

仍然成立的內容。 模擬器那一節以外的一切：日期與 build 編號、SDK 符號表、裝置設定檔及其像素與點的尺寸、執行環境的下載，以及 Apple 的 Known Issues。那一節之內：螢幕尺寸、size class、Device Hub 提供的姿態、screenConfig 造成的當機，以及 UIScreen.main 的陷阱，後者在重新執行時以 27.1 標記同樣重現。被這次更新取代的 9 月 24 日說明曾猜測，那些零來自太早讀取區域，並承諾會在多個鉸鏈角度下重新執行。這個猜測錯了：27.0 建置不論問多久，都一個區域也拿不到。但它引用自 Molzahn 的那項觀察成立：正確連結的探測 App，在前六到九次計算中讀不到任何區域，之後則全部讀得到。鉸鏈角度的測試並沒有進行。¹²¹³

如果您照著本文自己做了一支探測 App，請檢查一下：otool -l <app>/<binary> | grep -A4 LC_BUILD_VERSION。由 Xcode 建置的專案會被正確標記。手動編譯的檔案，則需要在 swiftc 執行前把 SDKROOT 匯出為模擬器 SDK。讓這個問題浮上檯面的實作範例收錄了三方比較，另外還有 iOS 26 的標記。

10 月 26 日更新：手機搭載 27.1 出貨，以及正式版 SDK 的編號

根據 Apple Newsroom 與 Apple 的安全性更新頁面，iPhone Duo 於 10 月 23 日（星期五）搭載 iOS 27.1 上架門市；安全性頁面只為「iPhone Duo」列出「iOS 27.1」，沒有公布的 CVE 條目；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 的 App 可以在沒有進行中的相機擷取工作階段時，同時使用兩塊螢幕。）（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」的 Mac Catalyst 條目沒有改變。iOS 27.2 發行說明中有一則 UIKit 條目提到 27.1，也就是 UIView 的預設版面邊距歸零；用同一份原始碼建置、在 iPhone Duo 模擬器的 27.1 執行環境上執行的探測 App，在 LC_BUILD_VERSION 標記為 sdk 27.0 時回報 8 點（正是上方 10 月 2 日更新所警告的手動編譯陷阱），標記為 sdk 27.1 時則回報零，所以這項變更除了取決於作業系統，也取決於二進位檔所連結的 SDK；完整表格請見 iOS 27.2 發行說明那篇文章。¹⁶

beta 裡有什麼？

Apple 的發佈摘要把 「Xcode 27.1 beta (27A9269)」 列在 9 月 18 日（週五）上午 10:00 PT，同日下午還有一則 「TestFlight Update」；App Store Connect 當天的發行說明則寫明，現在可以把用 Xcode 27.1 beta 搭配 iOS 27.1 beta 或 iPadOS 27.1 beta SDK 建置的 App，送交內部與外部測試：「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.」² 這份清單請照字面讀：只有 iOS 停在 27.1，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 的 App，和 Xcode 27.0 一樣大；用 xip --expand 解到某個資料夾、改名為 /Applications/Xcode-27.1-beta.app、再把 DEVELOPER_DIR 指過去，命令列工作的安裝就到此為止。接著在這個 beta 底下第一次呼叫 xcodebuild 時，它自行花了大約兩分鐘安裝隨附的 CoreTypes.pkg 與 XcodeSystemResources.pkg，也就是 xcodebuild -runFirstLaunch 會明確執行的那個步驟，而其中第二個套件，正是把 iPhone Duo 裝置類型放到位的那一個。⁴ App 裡沒有的東西，是模擬器執行環境。這個 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 上安置動態島與狀態列的位置。¹⁰

要怎麼取得 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 模擬器已知問題，因此 beta 不再是唯一一個說明涵蓋 Duo 模擬器的 Xcode 27.1；我沒有安裝 RC。¹⁴）（10 月 15 日：Xcode 27.1 以正式版推出，建置 27A9275，與 RC 相同，其說明列出同樣兩則 Duo 模擬器已知問題；我沒有安裝它。¹⁵）

1. Xcode 27.1 beta（27A9269），從開發者下載頁面取得，Apple 的 Releases 頁面把日期標在 9 月 18 日（週五）。展開 xip，把 App 以帶版本號的名稱（例如 /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 執行環境，所以無論它畫出什麼，都不是這裡測得的 size class、保留區域或外側螢幕行為的來源；若想在沒有執行環境的情況下檢查版面，這個 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, *) 之下，那是 Apple 用來代表「該版本的所有平台」的簡寫；而 UIArrangementViewController.h 以及 UIView.h 裡的 reservedRegionsOfKind: 方法，帶的是 API_AVAILABLE(ios(27.1), tvos(27.1), visionos(27.1)) 搭配 API_UNAVAILABLE(watchos)；在 UIVerticalBarEdge.h 裡，列舉與 verticalBarEdge trait 帶著同樣一組，Leading 與 Trailing 兩個 case 則帶著 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 case 中，topBarPinnedTrailing 掛在 @available(iOS 27.0, visionOS 27.0, *) 底下，cancellationAction 則除了型別本身的可用性之外沒有自己的標註。⁴

模擬器的裝置設定檔怎麼描述這兩塊螢幕？

Apple 為這個 beta 安裝的裝置類型 iPhone Duo.simdevicetype，是放在 /Library/Developer/CoreSimulator/Profiles/DeviceTypes 下的一個普通 bundle，它的兩份 property list 回答了規格表留下的問題。⁵

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：模擬器以 3x、669 × 951 點來繪製內側螢幕，那正是我在 9 月 10 日的 Duo 開發者文章裡算出、並標明為推論的那筆算式。如今 Apple 自己的設定檔就寫著這個數字。270 度的原生方向說明內側螢幕原生是橫向的，手機展開時寬 951 點、高 669 點，這和 Apple 給展開狀態的尺寸吻合。剩下兩個數字則屬於模擬器而非硬體：兩塊螢幕在設定檔裡都寫成每英寸 460 像素、60 Hz，而規格表給內側面板的是 430 ppi，所以 hdpi 應當視為佔位值。⁵

設定檔連形狀也一併附上。每塊螢幕都指向一份 framebuffer 遮罩，也就是可視區域的 PDF。外側螢幕的遮罩四角不對稱，設定檔的值是長邊其中一側 8、另一側 59；依我的判讀，半徑較小的那一側，就是接上 Apple 設計指南所描述之中央轉軸的那一側。內側螢幕的遮罩則是單純的圓角矩形，用設定檔裡的圓角值 55，而且沒有為前置相機留下缺口，所以相機造成的遮蔽是執行期由保留區域 API 提供的，而不是來自 framebuffer 的形狀。⁵¹⁰

模擬器實際顯示什麼？

裝置開機時是闔上的。首次開機時外側螢幕顯示主畫面，內側螢幕的 framebuffer 是開著的但一片漆黑；simctl io enumerate 會用設定檔裡的名稱列出兩塊內建螢幕，primary 為 1398 × 2034、primary-1 為 2007 × 2853，旁邊則是一如往常的虛擬螢幕。⁶ 姿態就住在 Device Hub 裡。選取 Duo 裝置後，它的視窗會把 Rotate Right、Closed、Book 與 Open 顯示為按鈕，而這些按鈕可以用輔助使用 API 按下，本節的所有操作都是這麼驅動的；simctl 沒有姿態指令。⁶

探測 App 是一支單檔的 SwiftUI App：一個 tab view，裡面是帶有五個工具列項目的導覽堆疊；一塊讀數區，顯示幾何數值、size class、toolbarVerticalEdge 環境值、鉸鏈，以及用 includeInactive 取得的兩種保留區域；再加上一個 split 樣式的 ArrangementView。它在 body 的每一次計算時讀取區域，並每秒重新計算一次。以下數字來自 10 月 2 日以 27.1 SDK 連結後的重新執行；9 月那幾次誤以 27.0 連結的執行，放在後面自己的標題之下。¹³

以 27.1 SDK 連結

Closed。 App 拿到整塊外側螢幕：視窗為 466 × 678 點，寬度 compact、高度 regular。工具列與標籤列立在後緣、時鐘下方，toolbarVerticalEdge 讀出 trailing，UIKit 的 verticalBarEdge trait 讀出原始值 2。導覽堆疊裡的內容量到 382 × 562 點，安全區域邊距為上方 82、下方 34、後緣 84，後緣那 84 點就是那條直欄。回報的遮蔽區域有兩個，都是作用中：一個 37 點見方，位於外側相機所在處；另一個 84 × 170，蓋住相機以及各列上方的狀態直欄。這塊螢幕上沒有回報分隔區域。把它轉成橫放，是 678 × 466，兩個 size class 都是 compact，各列仍在後緣。¹³

Closed，27.1 SDK：整塊 466 × 678 點的螢幕，各列沿後緣排列。

Open。 App 以原生橫向移到內側螢幕：視窗為 951 × 669 點，兩個 size class 都是 regular，各列仍垂直位於後緣。內容量到 867 × 553，三個邊距和闔上時相同。回傳的區域有三個。一條寬 40 點的分隔區域，在螢幕正中央縱貫全高，從 x 455 到 495，兩側各有 20 點邊距，而且是非作用中的：手機是攤平的。一個 58 × 37、非作用中的遮蔽區域標出內側相機，Apple 的指南說這顆相機「stays hidden until the camera is active.」（在相機啟用之前都保持隱藏）。¹⁰ 一個 84 × 120、作用中的遮蔽區域蓋住狀態直欄。分割式 arrangement 把兩個窗格左右並排，平分寬度。¹³

Open，27.1 SDK：951 × 669 點，摺疊處以一條縱貫中央、非作用中的分隔區域回報。

Book。 Device Hub 的 Book 姿態把鉸鏈回報為部分展開，角度 127 度。視窗大小不變，改變的是分隔區域：框不變，但轉為作用中。分割式 arrangement 隨之把分隔線移到摺疊處，並讓那條 40 點的帶子空著，因此主要窗格止於 x 455，次要窗格從 495 開始。在這個姿態下呈現的 sheet，會偏離中央，移到前緣那一半。¹³

Book，27.1 SDK：分隔區域轉為作用中，分割式 arrangement 讓摺疊處空著。

旋轉後。 在手機展開時按下 Rotate Right，得到 669 × 951 點的視窗，兩個 size class 仍是 regular，各列則回到橫向：toolbarVerticalEdge 為 nil，工具列位於頂端、時鐘旁邊，標籤列浮在底部。這和 Apple 的設計指引一致，指引在內側螢幕直向時保留「standard horizontal bars」（標準的橫向列）。¹⁰ 同樣三個區域會在旋轉後的座標空間中回報：分隔區域如今是一條橫跨中央、高 40 點的橫帶，攤平時非作用中，Book 時作用中。探測 App 的 arrangement view 在那塊畫面中寬大於高，因此維持左右並排。¹³

Open 並旋轉，27.1 SDK：各列橫向，摺疊處如今是一條橫帶。

有兩件事在每一種姿態下都成立。第一，區域來得晚：每次啟動時，探測 App 的 body 前六到九次計算都讀不到任何區域，之後的每一次則全部讀得到，所以只在第一次版面配置時問一次的檢視，得到的是空的答案。Sven-Eric Molzahn 的 DuoProbe 測試夾具在 9 月 20 日就記錄了這一點（「reservedRegions is empty on the first geometry evaluation and populated on a later one」，reservedRegions 在第一次幾何計算時為空，之後的計算才有內容），也記錄了那條 40 點的帶子；SwiftLee 9 月 22 日的模擬器指南則補充「Holding Option ⌥ reveals a slider that you can use to control the hinge angle of the device with precision」（按住 Option ⌥ 會出現一個滑桿，可精確控制裝置的鉸鏈角度），這個滑桿我沒有用過。¹² 第二，App 明明跑在內側螢幕，UIScreen.main.bounds 卻回答 466 × 678 點，也就是外側螢幕，這正是 Apple 指南提醒的陷阱，它要開發者把版面計算建立在 「based on your scene or containing view’s bounds rather than screen dimensions」（依據您的 scene 或容器檢視的 bounds，而非螢幕尺寸）：主螢幕並不是您所在的那塊螢幕。視窗 scene 自己的螢幕，回報的才是 App 實際所在的那塊。⁷¹³

有一條通往其他姿態的路走不通。simctl io screenConfig 可以把某塊螢幕的電源關掉，但在內側螢幕保持開啟的情況下關掉外側螢幕，並不會讓手機展開；它反而弄垮了模擬器的系統 shell，接下來的 simctl launch 以 「The system shell probably crashed.」 失敗，只能重新開機。姿態還是住在 Device Hub 的視窗裡。⁶

以 27.0 SDK 連結

以下是本節到 10 月 2 日為止所刊載的數字，9 月 19 日與 20 日以一支只有導覽堆疊、沒有 tab view 的探測 App 量得，10 月 2 日再以目前這支重新量過。它們描述的是以 Xcode 27.0 建置的 App 在這個模擬器上拿到什麼。⁶¹³

闔上時，視窗在 466 點寬的螢幕上只有 386 點寬：系統把那條 80 點的直欄留給自己，在黑底上畫出時鐘與狀態，App 的工具列則橫躺在頂端。展開時，視窗為 871 × 669，右側同樣少了 80 點，安全區域邊距左右各 34。展開並旋轉時，那 80 點改從頂端扣掉。每一種姿態下，size class 都和 27.1 建置相同，toolbarVerticalEdge 為 nil，verticalBarEdge 讀出原始值 0，兩種保留區域查詢都回傳空陣列，連非作用中的區域一起納入也一樣，而且不論探測 App 持續問多久都是如此；Book 與 Open 無從分辨。

Closed，以 27.0 連結：App 停在直欄前，工具列維持橫向。

Open，以 27.0 連結：兩個維度都是 regular，直欄由系統保留。

旋轉後，以 27.0 連結：橫跨頂端的那條帶子屬於系統。

這個 beta 還做不到的事

在這個 beta 自己的說明裡，Apple 於 Simulator、Known Issues 之下列出三項限制，分別是漫長的首次啟動、缺席的 StandBy，以及大多數 App Extension：「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」，並稱之為 「hub for widgets」，Duo 開發者文章寫過那裡會顯示什麼；在後續 beta 解除這道限制之前，這台裝置上的 StandBy 只能拿實機來確認（10 月 15 日：正式版的說明仍列出這一項¹⁵）。¹¹

另外兩項落在 Mac Catalyst、Known Issues 之下，凡是採用這些 API 又同時為 Mac 建置的 App 都會被咬到：「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、替 App 改名，再把 DEVELOPER_DIR 指向它來做命令列建置；beta 的說明裡沒有任何一項會動到 27.0 的工具鏈，而且編譯器與連結器帶的版本字串完全相同。⁴
2. 在真正需要之前就先開始下載執行環境，在 beta 底下執行 xcodebuild -downloadPlatform iOS，失敗就重試；正是這個執行環境讓 iPhone Duo 裝置類型能夠開機，而且 Apple 已經先說了，首次啟動還要再多花上好幾分鐘。²³
3. 把 Mac Catalyst target 一併納入，對著 27.1 SDK 建置一次，先讀過 Apple 點名的那兩則診斷訊息，再決定要用 #if !targetEnvironment(macCatalyst) 把新 API 圍起來，還是把 Catalyst 的最低版本提高到 27.0。²
4. 就拿設定檔裡的數字當作預覽與測試的尺寸：闔上 466 × 678 點、展開 669 × 951 點，內側螢幕原生橫向。這個 beta 的 Previews 項目還替畫布的覆寫選單加上了一個 Display 群組，「for previewing content on a device’s alternative display.」（182598534）²⁵
5. 在會被再次讀取的地方讀取保留區域：在檢視的 body 裡透過幾何 proxy 讀取，或在每一次幾何變化時讀取，絕不要只在第一次版面配置時讀一次。reservedRegions(kind:options:layoutDirectionBehavior:) 搭配 .includeInactive，在探測 App 的前六到九次計算中什麼也沒回傳，之後的每一次則回傳該螢幕擁有的每一個區域（闔上時是相機與狀態直欄；展開時是摺疊處、內側相機與狀態直欄），所以從第一次計算快取下來的值，在該檢視的整個生命週期裡都會是空陣列。而在相信這些結果之前，請先確認建置標記的是 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 模擬器已知問題，因此 beta 不再是唯一一個說明涵蓋 Duo 模擬器的 Xcode 27.1；我沒有安裝 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 模擬器已知問題，因此 beta 不再是唯一一個說明涵蓋 Duo 模擬器的 Xcode 27.1；我沒有安裝 RC。¹⁴）（10 月 15 日：Xcode 27.1 以正式版推出，建置 27A9275，與 RC 相同，其說明列出同樣兩則 Duo 模擬器已知問題；我沒有安裝它。¹⁵）

如何把 Xcode 27.1 beta 裝在 Xcode 27 旁邊？

用 xip --expand 解開 xip，把解出來的 App 移成帶版本的名稱，例如 /Applications/Xcode-27.1-beta.app，再把 DEVELOPER_DIR 設為它的 Contents/Developer 資料夾，供 xcodebuild、xcrun 與 swiftc 使用。這個 beta 需要 macOS Tahoe 26.6 或更新版本，和 Xcode 27.0 的下限相同。²⁴

iPhone Duo 內側螢幕以點為單位有多大？

669 × 951 點，依據模擬器的裝置設定檔，它把內側螢幕定義為 2007 × 2853 像素、scale 3，原生方向為橫向；外側螢幕則是 1398 × 2034 像素、scale 3，換算為 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 中都標示為 build 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 的建置。

資料來源