AI Platform

折叠 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。至少需要重新分配以下职责:

  1. 在应用配置中声明场景配置,并确认连接选项能够传递启动 URL 或用户活动。
  2. 将窗口创建、根视图控制器设置和 makeKeyAndVisible 移入场景连接流程。
  3. 将打开 URL、通用链接和文档恢复逻辑拆分到场景级入口。
  4. 将前后台切换、暂存状态和场景断开处理放到对应的场景生命周期方法。
  5. 检查多窗口、iPhone Mirroring 和 iPad 运行时是否会创建不同场景实例。
  6. 用最新 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 强制单栏,两层判断可能在窗口拖动过程中产生冲突。较稳妥的做法是由组件边界提供“当前可用空间”或布局能力,子组件只消费统一结果,不各自猜测设备形态。

动态更新:处理连续窗口变化

固定尺寸改造完成后,仍然可能在拖动窗口时出现内容截断、集合视图错位或缓存未刷新。原因是窗口调整不是一次性的旋转事件,而是连续的几何变化过程。

需要重点检查:

  1. 约束优先级是否在窄窗口中形成冲突。
  2. UICollectionViewFlowLayout 或自定义布局是否在容器变化后失效。
  3. 绘制缓存是否按新尺寸重新生成。
  4. 视频、图片和 Metal 渲染目标是否更新 drawable 或 viewport。
  5. 弹层、菜单和浮动按钮是否重新计算锚点。
  6. 键盘、输入框和安全区域变化是否与窗口变化同时发生。

对于布局对象,应把“重新计算”与“昂贵任务”分开。约束、边距和列数可以在尺寸变化时更新,但大图解码、模型重建和全量数据排序不应在每一次拖动事件中执行。连续调整窗口时,优先更新轻量几何状态,等尺寸稳定后再触发重任务。

窗口几何信息应从当前场景获取,而不是从设备型号推断:

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 算力与完整系统权限,适合验证窗口尺寸、可用空间和动态布局变化。