折叠 iPhone 发布前,iOS 27 API 先改什么?(2026)
截至 2026 年 8 月 20 日,Apple 的 WWDC26 Session 278 已明确说明:使用最新 SDK 构建时,旧 AppDelegate 生命周期的应用可能无法启动,iPhone 应用还需要在 iPhone Mirroring 和 iPad 环境中适应动态窗口尺寸。(developer.apple.com)
获胜者:现在就按公开 API 做 iOS 27 API 迁移;适用条件是应用仍依赖旧生命周期、UIScreen.main、userInterfaceIdiom、interfaceOrientation 或固定宽高。 正确顺序是:先迁移 UIScene 生命周期,再清理全局屏幕引用,随后改写设备与方向判断,最后处理连续尺寸变化,并用 Device Hub 验证。折叠 iPhone 的名称、尺寸、价格、发布时间以及 foldState、angleDegrees 等字段尚未获得 Apple 的公开 API 身份,因此不应把它们写进生产代码。
这篇文章适合仍有旧 AppDelegate 生命周期或 UIScreen.main 调用的 UIKit 维护者,也适合依赖设备类型、方向或固定宽高切换布局的开发者。负责秋季版本排期的技术主管,则可以据此区分“现在必须做的公开 API 改造”和“硬件官宣后再补的形态测试”。
最后更新于 2026 年 8 月 20 日;API 状态与测试方法核实自 Apple Developer 的 WWDC26 Session 278、UIKit 文档和 Xcode 27 文档。秋季发布会日期及折叠设备信息仍属于未官宣内容,已通过至少两类媒体报道交叉复核。(developer.apple.com)
代码盘点:先确定迁移边界
不要先从“折叠后界面长什么样”开始设计。当前真正可执行的边界,是让应用不再假设自己永远运行在单一、固定、全屏的 iPhone 画布中。
第一轮检索应覆盖以下关键词,并把命中的文件、页面和测试用例登记下来:
AppDelegate
SceneDelegate
UIScreen.main
userInterfaceIdiom
interfaceOrientation
UIScreen.main.bounds
UIScreen.main.scale
固定宽度
固定高度
UIDevice.current
其中,UIScreen.main.bounds 可能出现在截图裁剪、缩略图生成、图片缓存键、弹窗定位和媒体渲染工具中;只修复视图控制器而不检查这些工具代码,通常只能解决表面布局问题。
| 盘点对象 | 典型旧写法 | 迁移目标 | 完成证据 |
|---|---|---|---|
| 应用启动 | AppDelegate 直接创建主窗口 |
UIScene 与 UIWindowSceneDelegate |
冷启动、后台恢复均通过 |
| 当前屏幕 | UIScreen.main |
当前 UIWindowScene 的 screen |
多场景或镜像环境下取值正确 |
| 缩放比例 | 从主屏幕读取 scale |
当前视图的 traitCollection.displayScale |
截图与绘制比例正常 |
| 布局尺寸 | 固定屏幕宽高 | 当前容器 bounds 或有效几何信息 |
窄、宽、近方形窗口均不截断 |
| 设备分支 | userInterfaceIdiom == .phone |
可用空间与容器能力 | 窄窗口不再强行采用手机布局 |
UIScreen.main 在 iOS 27 迁移中为什么需要重点清理?
问题不在于 UIScreen.main 立即消失,而在于它表达的是“设备主屏幕”,不是“当前应用场景实际拥有的窗口”。Apple 的说明指出,在可调整环境中,应用场景可能运行在另一块屏幕或不同窗口中,因此主屏幕尺寸不能代表当前布局空间。(developer.apple.com)
基础迁移:先完成 UIScene 生命周期
UIScene 必须先于布局改造完成,因为后续获取窗口、屏幕、场景几何和状态恢复上下文,都依赖场景对象。Apple 的场景模型以 UIWindowScene 管理一组界面,并由对应的场景代理协调交互。(developer.apple.com)
旧 UIKit 应用迁移到 UIScene 时,范围不只是把一个启动方法复制到 SceneDelegate。至少需要重新分配以下职责:
- 在应用配置中声明场景配置,并确认连接选项能够传递启动 URL 或用户活动。
- 将窗口创建、根视图控制器设置和
makeKeyAndVisible移入场景连接流程。 - 将打开 URL、通用链接和文档恢复逻辑拆分到场景级入口。
- 将前后台切换、暂存状态和场景断开处理放到对应的场景生命周期方法。
- 检查多窗口、iPhone Mirroring 和 iPad 运行时是否会创建不同场景实例。
- 用最新 SDK 完成冷启动、后台恢复、强制终止后恢复和 URL 启动测试。
最小迁移模式可以保持在公开 API 范围内:
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()
}
这段代码并不解决窗口适配本身,但它建立了“当前场景—当前窗口—当前布局上下文”的依赖链。若生命周期仍由旧 AppDelegate 管理,后续把尺寸判断改到视图层,很容易出现启动成功但恢复、镜像或多场景状态异常的情况。
屏幕引用:按用途拆开替换
清理 UIScreen.main 时,不能对所有调用做机械替换。先判断调用究竟需要哪一种信息,再选择对应上下文。
| 原调用目的 | 不建议继续使用 | 更合适的上下文 | 需要回归的功能 |
|---|---|---|---|
| 获取当前显示设备 | UIScreen.main |
windowScene.screen |
外接屏、镜像、多场景 |
| 获取绘制缩放比例 | UIScreen.main.scale |
当前视图的 traitCollection |
位图、截图、文本渲染 |
| 判断内容能否放下 | UIScreen.main.bounds |
当前容器 bounds |
双栏、工具栏、弹层 |
| 计算窗口坐标 | 主屏固定坐标 | UIWindowScene 的坐标空间 |
拖动、旋转、跨窗口 |
| 生成缓存键 | 固定屏幕尺寸 | 视图或渲染目标尺寸 | 缩略图、媒体缓存 |
Apple 的 UIScreen 文档本身也建议:如果需要屏幕对象,应从管理应用窗口的 UIWindowScene 获取;如果计算依赖屏幕尺寸,还要明确使用固定坐标空间还是当前坐标空间。(developer.apple.com)
例如,显示设备信息时可以从当前窗口得到屏幕:
guard let screen = view.window?.windowScene?.screen else { return }
let nativeScale = screen.nativeScale
但布局时不要把 screen.bounds 当作内容区域:
let availableWidth = view.bounds.width
let useSplitLayout = availableWidth >= 720
上面的阈值只是示例,实际项目应以设计系统、容器最小宽度和现有测试数据确定;没有来源或本站实测支撑时,不应把某个数字包装成 Apple 的官方断点。
需要同步检查 4 类隐性依赖:
- 截图与图片绘制:确认缩放比例来自当前渲染环境,而不是主屏幕。
- 缩略图与缓存:把实际目标尺寸纳入缓存键,避免窗口变窄后继续复用宽窗口图片。
- 弹层与菜单:使用当前窗口坐标转换,不要用设备屏幕坐标直接定位。
- 外接显示器与镜像:分别验证“屏幕对象正确”和“窗口内容尺寸正确”,两者不是同一个问题。
空间判断:替代设备与方向分支
iPhone 应用能够在 iPhone Mirroring 和 iPad 环境中面对可调整窗口后,userInterfaceIdiom == .phone 就不再等于“内容一定窄”。同样,interfaceOrientation 也不应继续承担双栏、菜单密度或按钮排列的主要判断职责。Apple 在 WWDC26 Session 278 中把设备类型和方向判断列为需要审计的旧适配方式。(developer.apple.com)
迁移时可以按这条规则处理:
- 决定显示单栏还是双栏:看当前容器可用宽度。
- 决定工具栏是否折叠:看容器宽度与控件最小布局需求。
- 决定文字、缩略图和间距密度:看 size class、容器尺寸和设计系统。
- 决定相机预览、传感器方向或视频旋转:保留必要的方向信息。
- 决定是否显示“手机版界面”:不要只依赖
userInterfaceIdiom。
窗口比例改变后出现内容变形,应该先排查哪一层?
先区分是“空间判断错误”还是“尺寸变化没有触发重新布局”。如果界面在窗口变窄时仍显示双栏,问题通常在设备类型分支;如果栏位已经切换但图片、集合视图或弹层仍保留旧尺寸,则要检查动态失效逻辑。
UIKit 与 SwiftUI 混合项目还需要统一语义。例如,UIKit 容器根据 bounds.width 采用双栏,而 SwiftUI 子视图又根据 horizontalSizeClass 强制单栏,两层判断可能在窗口拖动过程中产生冲突。较稳妥的做法是由组件边界提供“当前可用空间”或布局能力,子组件只消费统一结果,不各自猜测设备形态。
动态更新:处理连续窗口变化
固定尺寸改造完成后,仍然可能在拖动窗口时出现内容截断、集合视图错位或缓存未刷新。原因是窗口调整不是一次性的旋转事件,而是连续的几何变化过程。
需要重点检查:
- 约束优先级是否在窄窗口中形成冲突。
UICollectionViewFlowLayout或自定义布局是否在容器变化后失效。- 绘制缓存是否按新尺寸重新生成。
- 视频、图片和 Metal 渲染目标是否更新 drawable 或 viewport。
- 弹层、菜单和浮动按钮是否重新计算锚点。
- 键盘、输入框和安全区域变化是否与窗口变化同时发生。
对于布局对象,应把“重新计算”与“昂贵任务”分开。约束、边距和列数可以在尺寸变化时更新,但大图解码、模型重建和全量数据排序不应在每一次拖动事件中执行。连续调整窗口时,优先更新轻量几何状态,等尺寸稳定后再触发重任务。
窗口几何信息应从当前场景获取,而不是从设备型号推断:
guard let windowScene = view.window?.windowScene else { return }
let sceneFrame = windowScene.coordinateSpace.bounds
let contentSize = view.bounds.size
UIWindowScene 提供场景坐标空间和系统框架信息,可用于建立当前场景的几何上下文。(developer.apple.com)
建议将验证状态拆成 4 组:
- 窄窗口:检查文字换行、横向滚动、按钮压缩和弹层溢出。
- 宽窗口:检查双栏、工具栏扩展和媒体预览比例。
- 接近方形:检查以宽高比为前提的卡片、网格和分页逻辑。
- 连续拖动:检查中间状态是否闪烁、重叠、截断或复用过期缓存。
发布验证:Device Hub 与真实环境分层
Xcode 27 的 Device Hub 测试应分为“建立窗口状态、执行页面操作、记录回归证据”三步。先准备 iOS 27 或对应测试系统的运行环境,打开窗口调整能力,依次拖动到窄、宽和接近方形的状态;再用 Previews 快速观察组件边界,最后使用真实设备验证镜像和 iPad 运行结果。Xcode 27 的 Device Hub 支持管理和配对运行新系统的设备,模拟设备环境也提供可调整窗口的测试方式。(developer.apple.com)
建议把测试分成三层,而不是把模拟器结果当作最终结论:
- 组件层:用 Previews 或固定容器尺寸检查单个页面的布局边界。
- 应用层:用 Device Hub 检查导航、状态恢复、弹层和动态尺寸变化。
- 硬件层:用真实设备验证 iPhone Mirroring、外接屏、相机、传感器和媒体链路。
模拟环境适合快速发现约束冲突和空间判断错误,但不能替代真实硬件依赖项。尤其是相机预览、持续渲染、传感器方向、网络配对和镜像链路,必须在实际设备上完成至少一轮回归。
发布分支建议采用独立提交:
- 提交 1:仅迁移
UIScene生命周期。 - 提交 2:仅清理
UIScreen.main与屏幕尺寸工具调用。 - 提交 3:仅改写设备类型、方向和空间判断。
- 提交 4:仅加入动态尺寸失效和缓存更新。
- 提交 5:补充 Device Hub、Previews 与真实设备测试证据。
这样安排的价值在于:如果秋季 SDK 或硬件行为出现变化,团队可以单独回滚布局语义或动态更新逻辑,而不必把已经稳定的启动迁移一并撤回。折叠 iPhone 后续即使官宣,也应先追加官方设备形态测试,不要推翻已经基于可用空间建立的核心实现。
迁移检查清单:按依赖顺序收口
- [ ] 已记录所有 AppDelegate 启动、恢复、URL 处理和状态保存逻辑。
- [ ] 已完成
UIScene配置,并在最新 SDK 下通过冷启动测试。 - [ ] 已验证后台恢复、强制终止恢复和 URL 启动路径。
- [ ] 已检索并分类所有
UIScreen.main调用。 - [ ] 屏幕对象、缩放比例、布局尺寸和坐标空间已分别采用合适来源。
- [ ] 已检查截图、缩略图、缓存键和外接显示器工具代码。
- [ ] 已移除仅用
userInterfaceIdiom决定内容密度的关键分支。 - [ ] 已将不必要的
interfaceOrientation布局判断改为 size class、容器尺寸或可用空间判断。 - [ ] UIKit 与 SwiftUI 组件边界已统一空间语义。
- [ ] 约束、集合布局、绘制缓存、媒体渲染和弹层定位均能响应尺寸变化。
- [ ] 已覆盖窄、宽、近方形和连续拖动 4 类窗口状态。
- [ ] 已在 Xcode 27 Device Hub 和 Previews 中完成快速回归。
- [ ] 已在真实设备上验证 iPhone Mirroring 与 iPad 结果。
- [ ] 生命周期、布局语义和动态更新改造已拆成可独立回滚的提交。
- [ ] 代码库中没有调用或猜测
foldState、angleDegrees等未公开字段。
如果当前团队仍依赖固定 Windows 或 Linux 工作站,主要缺点通常不是“不能写 Swift”,而是 Xcode 27 与稳定版工程难以隔离、Apple 设备配对和镜像测试链路不完整,以及多人共享同一台 Mac 时无法稳定复现窗口状态。自购 Mac 适合长期、持续、重负载的团队;但对于发布前数周的迁移、双版本 SDK 并行和临时回归,单独购买硬件会增加采购、配置和闲置成本。
因此,若只是需要临时算力、隔离 Xcode 27 测试环境,或在秋季版本前安排一段可回滚的 Mac 开发节点,租赁 KuzCloud 的 Mac 环境通常比改造现有工作站更直接。开始前可先阅读 KuzCloud 帮助中心,确认远程连接与环境使用方式;再根据迁移周期查看 Mac 租赁方案,决定采用短期测试环境还是较长周期节点。
用 KuzCloud 远程 Mac,提前完成 iOS 27 适配验证
无需等待新设备到位,开通 KuzCloud 专属 Mac 节点即可立即搭建发布前测试环境。
物理独占的 Apple Silicon 算力与完整系统权限,适合验证窗口尺寸、可用空间和动态布局变化。