AI Platform

折疊 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 和其他彈層定位。

實作時把失效邏輯放在正確的環境變化入口:

  1. 先記錄場景目前的幾何狀態,確認尺寸變化真的傳入目標 window。
  2. 對依賴 trait 的元件註冊 trait 變化,重新計算與外觀類別相關的內容。
  3. 對依賴容器尺寸的元件,在 view 或 layout 的尺寸更新流程中觸發重新排版。
  4. 對圖片、繪圖與媒體快取加入尺寸或 scale 的快取鍵,避免沿用舊結果。
  5. 對彈層重新檢查 source view、箭頭方向和可用邊界,不能只在初次呈現時定位。
  6. 將昂貴的圖片解碼、資料查詢或完整重建移出每次尺寸事件,必要時合併更新或延後處理。

測試狀態不應只取「窄」與「寬」兩個端點:

視窗狀態 主要觀察 失敗訊號
窄容器 單欄內容、文字換行、彈層 文字截斷或按鈕被推離畫面
寬容器 雙欄、側邊選單、集合版面 空白過大或輔助欄重疊
接近方形 圖片比例、工具列、媒體內容 以方向分支造成錯誤排列
連續拖動 快取失效、動畫、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 混合程式,及早檢查不同螢幕尺寸、方向與視窗狀態下的介面表現。