折疊 iPhone 發布前,iOS 27 API 先改什麼?(2026)
視窗一被拖寬,雙欄版面就重疊,或啟動後仍讀取錯誤的螢幕尺寸。
最快解法:不要等待折疊 iPhone 官宣,立即按「UIScene 生命周期 → 全域螢幕引用 → 空間判斷 → 動態尺寸更新 → Device Hub 驗證」的順序完成 iOS 27 API 遷移;不要呼叫或猜測 foldState、angleDegrees 等未公開欄位。
獲勝者:現在就按公開 API 改造,適合需要在 2026 年秋季前完成 UIKit 或混合架構版本的團隊;只有折疊裝置的正式尺寸與硬體專屬行為,才應等 Apple 官宣後再補測。 Apple 已公開說明 iPhone 應用會在 iPhone Mirroring 與 iPad 環境面對可調整視窗,相關要求可在 WWDC26 Session 278 核對。
這篇適合仍保留舊 AppDelegate 生命周期、UIScreen.main、userInterfaceIdiom 或固定寬高分支的 UIKit 維護者,也適合負責秋季版本排期、需要拆分風險與回滾範圍的技術主管。若程式已完全按容器空間佈局,讀者可直接跳到動態更新與測試階段。
先建立 API 遷移邊界
折疊 iPhone 的名稱、尺寸、價格、發布時間,以及內部程式碼中可能出現的折疊狀態欄位,截至 2026 年 8 月 20 日 都不是 Apple 已確認的公開開發介面。媒體對秋季發布窗口及相關欄位的解讀只能視為傳聞,不能成為目前的 API 設計依據。
已足以觸發改造的,是公開的可縮放視窗要求:應用不能再假設「iPhone 就是窄螢幕」,也不能把主螢幕尺寸當成目前內容容器。Apple 的 UIWindowScene 文件 可作為場景與視窗上下文的基準。
先在程式碼庫建立盤點表,不要一開始就大規模改 Constraint:
| 盤點項目 | 搜尋線索 | 先記錄的影響 |
|---|---|---|
| 舊生命周期 | application(_:didFinishLaunching:)、AppDelegate 視窗建立 |
啟動、URL、狀態恢復 |
| 全域螢幕引用 | UIScreen.main、nativeScale、bounds |
圖片、截圖、快取、外接顯示器 |
| 裝置與方向分支 | userInterfaceIdiom、interfaceOrientation |
雙欄、選單、內容密度 |
| 固定尺寸 | 320、375、固定寬高常量 |
截斷、重疊、錯誤換行 |
| 尺寸快取 | UIGraphicsImageRenderer、集合版面快取 |
視窗拖動後仍顯示舊內容 |
這份基線的價值不只是找出畫面問題,也能把「看似版面錯誤」與「啟動、URL 路由、狀態恢復失效」分開,避免發布前才發現工具程式仍依賴舊螢幕語意。
先完成 UIScene 生命周期
依賴關係
Scene 生命周期應先於版面改造,因為目前視窗的 scene、容器與幾何資訊都依賴正確的場景連線。如果先改畫面,後面才移動視窗建立或狀態恢復,測試結果可能只在單一冷啟動流程成立。
舊 UIKit 專案應依以下範圍拆分:
| 工作範圍 | 遷移位置 | 完成證據 |
|---|---|---|
| 視窗建立 | SceneDelegate 的連線回呼 | 冷啟動能取得正確 window |
| URL 與活動 | scene 的 URL 或 user activity 回呼 | 外部連結能進入指定畫面 |
| 前後景處理 | scene 狀態轉換回呼 | 返回前景後狀態未遺失 |
| 狀態恢復 | scene session 與 restoration 流程 | 終止後重新連線仍保留上下文 |
| 多場景邊界 | 每個 windowScene 個別處理 | 不把一個場景的資料寫入全域 |
最小遷移模式應保留公開 UIKit API 的語意,而不是只把 AppDelegate 方法搬到另一個檔案:
func scene(_ scene: UIScene,
willConnectTo session: UISceneSession,
options connectionOptions: UIScene.ConnectionOptions) {
guard let windowScene = scene as? UIWindowScene else { return }
let window = UIWindow(windowScene: windowScene)
window.rootViewController = makeRootViewController()
self.window = window
window.makeKeyAndVisible()
}
接著用最新 SDK 驗證冷啟動、背景返回、URL 開啟和狀態恢復。windowScene 應在場景上下文中取得,不能再透過全域單例猜測當前畫面。
再拆開 UIScreen.main 的用途
UIScreen.main 不能用一個替代 API 全面取代。它在舊程式中往往同時承擔「目前顯示器」、「像素比例」和「版面可用尺寸」三種不同責任;這正是 iPhone Mirroring 調整視窗後出現變形的常見根源。Apple 的 UIScreen 文件 可用來分辨顯示器層級資訊與視窗內容資訊。
| 原有用途 | 遷移方向 | 不應採用的做法 |
|---|---|---|
| 判斷目前顯示器或場景 | 從目前 UIWindowScene 取得上下文 |
以 UIScreen.main 推定目前頁面 |
| 取得縮放比例 | 讀取當前環境的 trait 或顯示相關資訊 | 將像素比例當成版面寬度 |
| 決定內容尺寸 | 使用當前 view、容器或 layout bounds | 把螢幕 bounds 寫入固定常量 |
| 建立截圖或縮圖 | 以實際渲染容器尺寸重算 | 沿用啟動時的全域尺寸快取 |
| 處理外接顯示器 | 按 scene 和 display 關係分流 | 假設所有內容都屬於主螢幕 |
因此,UIScreen.main 的搜尋結果要逐項分類:顯示器資訊保留在顯示器層,比例資訊交給 trait 語意,版面尺寸則下放到目前 view 或容器。對座標轉換有要求的頁面,也要按 UIWindowScene 座標空間文件 核對來源與目標座標系,不能只交換寬與高。
提醒: 如果主畫面已經正常,仍不能代表遷移完成;截圖、縮圖、媒體渲染、快取鍵和外接顯示器流程通常藏在工具層,必須與 UI 目標一併盤點。
將裝置分支改成空間語意
userInterfaceIdiom 適合描述裝置類別,卻不應單獨決定雙欄、側邊選單或內容密度。當同一應用可能出現在不同視窗比例時,「phone」不再等於「窄窗口」。這項改造的核心不是增加更多裝置名稱,而是改問目前容器能否容納某種版面。
interfaceOrientation 也要分開處理。相機預覽、運動感測器或需要真正方向資訊的功能仍可能需要方向;一般內容佈局則應優先採用 size class、容器 bounds 或可用空間。若某頁同時使用 UIKit 與 SwiftUI,應在元件邊界定義同一套空間語意,再把結果傳入另一種 UI 技術,避免 UIKit 判定寬版而 SwiftUI 仍按裝置類別顯示窄版。
建議把決策寫成可測試的條件:
- 可用寬度不足以容納主內容與輔助欄時,回退單欄,而不是檢查是否為 iPhone。
- 容器高度不足時,優先改為垂直排列,不以 portrait 字串直接切換整頁 Constraint。
- 選單能否常駐由容器空間決定;裝置類別只作分析或功能差異的輔助訊號。
- 固定寬高只保留在真正的資產比例、觸控最小尺寸或外部協定中,並避免把它當作整個頁面的尺寸。
- SwiftUI 的 size proposal 與 UIKit 的容器 bounds 必須在同一個組件契約中轉換。
FAQ:兩個高風險遷移點
(此處 FAQ 由頁面元資料提供,正文保留具體操作脈絡。)
補上動態尺寸更新
可縮放視窗的難點不在「初次顯示能否排版」,而在拖動過程中是否持續產生正確結果。需要檢查的對象包括 Auto Layout 約束、UICollectionView 或自訂 layout、繪圖快取、影片或圖片渲染尺寸,以及 alert、popover 和其他彈層定位。
實作時把失效邏輯放在正確的環境變化入口:
- 先記錄場景目前的幾何狀態,確認尺寸變化真的傳入目標 window。
- 對依賴 trait 的元件註冊 trait 變化,重新計算與外觀類別相關的內容。
- 對依賴容器尺寸的元件,在 view 或 layout 的尺寸更新流程中觸發重新排版。
- 對圖片、繪圖與媒體快取加入尺寸或 scale 的快取鍵,避免沿用舊結果。
- 對彈層重新檢查 source view、箭頭方向和可用邊界,不能只在初次呈現時定位。
- 將昂貴的圖片解碼、資料查詢或完整重建移出每次尺寸事件,必要時合併更新或延後處理。
測試狀態不應只取「窄」與「寬」兩個端點:
| 視窗狀態 | 主要觀察 | 失敗訊號 |
|---|---|---|
| 窄容器 | 單欄內容、文字換行、彈層 | 文字截斷或按鈕被推離畫面 |
| 寬容器 | 雙欄、側邊選單、集合版面 | 空白過大或輔助欄重疊 |
| 接近方形 | 圖片比例、工具列、媒體內容 | 以方向分支造成錯誤排列 |
| 連續拖動 | 快取失效、動畫、Constraint | 畫面閃爍、殘留舊尺寸或卡頓 |
發布前的分層驗證
Xcode 27 的 Device Hub 應先用來覆蓋窗口比例與重現尺寸變化;Xcode 27 的版本說明可在 Apple 的 Xcode 27 Release Notes 逐項核對工具行為。Previews 適合快速查看元件在不同容器下的狀態,但不應被當成完整硬體驗收。
發布前可勾選以下項目:
- [ ] 所有視窗建立、URL 處理和狀態恢復已從舊 AppDelegate 責任中拆出。
- [ ] 每個
UIScreen.main呼叫已標註為顯示器、比例或版面用途,並完成對應替換。 - [ ] 雙欄、選單和內容密度不再只由
userInterfaceIdiom決定。 - [ ] 一般版面不再以
interfaceOrientation作為唯一切換條件。 - [ ] SwiftUI 與 UIKit 元件使用一致的可用空間語意。
- [ ] 固定寬高、截圖、縮圖、快取鍵和媒體渲染流程已完成檢查。
- [ ] Device Hub 與 Previews 已覆蓋窄、寬、接近方形及連續拖動。
- [ ] 真實裝置已驗證 iPhone Mirroring 與 iPad 結果。
- [ ] 生命周期、版面語意和動態更新分成可獨立回滾的提交。
- [ ] 尚未把
foldState、angleDegrees或任何未公開欄位寫入程式碼。
建議採用三段提交,而非一次合併全部變更:第一段只處理生命周期,第二段處理螢幕與空間語意,第三段處理動態更新與測試修正。這樣若啟動風險、版面回歸或效能問題在測試中出現,團隊能回退單一範圍,不必撤銷整個秋季版本。
完成上述流程後,折疊 iPhone 若正式公布,只需要追加官方提供的裝置形態、尺寸與硬體依賴測試;核心版面仍以可用空間為依據,不必重新推翻整個架構。Apple 更新 beta、RC、正式版或硬體文件時,應重新檢查 WWDC26 Session 278 的官方說明 與 Xcode 版本行為。
如果團隊目前的 Mac 無法同時隔離 Xcode 27 與穩定版工程,現有方案通常會遇到共用環境污染、切換 SDK 造成的重建成本,以及 iPhone Mirroring、iPad 測試無法並行等問題;長期重負載或必須接實體周邊的團隊,則應評估自購 Mac 或固定實體設備。若需求是發布前數週的分支驗證、臨時回歸或隔離測試,租用 KuzCloud 的 Mac 環境更容易按測試週期拆分,並可先從 KuzCloud 的環境說明 了解連線與使用限制,再按實際排期查看可用方案。
用 KuzCloud 遠端 Mac,提早完成 iOS 多螢幕驗證
租用 KuzCloud 遠端 Mac,為 iOS 專案建立靈活的開發與測試環境。
針對 UIKit 與 SwiftUI 混合程式,及早檢查不同螢幕尺寸、方向與視窗狀態下的介面表現。