来源:Apple WWDC Session《iPhone Duo 布局适配》(tech-talks/111461)
一句话结论
iPhone Duo 适配的核心,不是新增一套”折叠屏专用布局”,而是消除代码中对设备型号、屏幕尺寸、界面方向的判断:结构交给 Size Class,尺寸交给容器,避让交给 Safe Area。
0. 五条关键结论
- 必须用 iOS 27.1 SDK(Xcode 27.1)构建,否则 Duo 边缘黑屏。
- 用 Size Class 决定布局结构,不要用
userInterfaceIdiom或interfaceOrientation。 - 布局依据当前容器(
view.bounds、safeAreaLayoutGuide),不是UIScreen.main。 - Safe Area 不再只是上下,左右可能不对称;Layout Margins 也可能不对称。
- 优先用系统导航组件;只有自定义贴边控件才需要
Reserved Regions。
1. SDK 基线
| 构建所用 SDK | 屏幕使用情况 |
|---|---|
| iOS 27 之前 | 合上时只用状态栏与摄像头左侧区域,展开大面积黑屏 |
| iOS 27 SDK | 内屏能用更多空间,但未获得完整贴边体验 |
| iOS 27.1 SDK | App 延伸至屏幕边缘;系统栏可纵向排列在状态栏下方 |
旧版本 App 能运行,但类似”早期 iPhone 应用跑在 iPad 上”的放大黑边效果。升级 SDK 后要重点检查界面边缘与系统栏附近的布局。
2. 用 Size Class 决定结构
2.1 不要用 idiom 推断空间
1 | // ❌ 把设备类别当成可用空间 |
userInterfaceIdiom 无法反映”有没有足够空间显示侧边栏”,也不能把 “iPhone” 等同于”只能单列”。
2.2 内外屏的常见组合
| 显示状态 | Horizontal | Vertical |
|---|---|---|
| 外屏竖屏 | compact | regular |
| 外屏横屏 | compact | compact |
| 内屏展开 | regular | regular |
1 | let horizontalClass = traitCollection.horizontalSizeClass |
结构由 Size Class 决定,具体尺寸由 Auto Layout 决定。不要缓存首次读取的结果当作页面布局模式;iOS 17 起可用 registerForTraitChanges 监听变化。
2.3 不要用横竖屏判断
内屏不受 App 声明的支持方向限制——即使只声明竖屏,内屏也可能变成宽布局。布局决策只认 Size Class。
2.4 不再使用 UIRequiresFullScreen
iPadOS 26 起已弃用;iOS 27 虽仍识别,但无法阻止窗口尺寸变化,且会让 App 变成”离散式”调整尺寸。
3. 容器尺寸优先,不依赖 UIScreen
需求与信息源的对应关系:
| 实际需求 | 应使用的信息 |
|---|---|
| View 内有多少布局空间 | view.bounds |
| 内容要避开哪些边缘 | safeAreaLayoutGuide / safeAreaInsets |
| 该用紧凑还是宽布局 | Trait Collection 的 Size Classes |
| 缩放比例 | traitCollection.displayScale |
| 确实需要屏幕对象 | view.window?.windowScene?.screen |
1 | // 容器尺寸(正确) |
折叠屏上”主屏幕”本身就不明确,UIScreen 文档也明确不建议用它决定界面布局。
4. Safe Area
4.1 不再是”顶 + 底”
系统栏位于 Safe Area 之外,并通过 Insets 让内容避开。不能简化为「状态栏高度 + Home Indicator 高度」。
4.2 前景避让,背景铺满
1 | override func viewDidLayoutSubviews() { |
Auto Layout 下直接约束到 safeAreaLayoutGuide;SwiftUI 用 ignoresSafeArea() 让背景铺满,而不是让整个交互层忽略 Safe Area。
4.3 左右不一定相等
1 | // ❌ 假设左右相等 |
排查旧项目时特别注意三类代码:底部弹窗、自定义 Toolbar、贴边按钮——看它们是否只处理了 bottom,或者用一侧 Insets 代替另一侧。
4.4 Layout Margins 也可能不对称
| 概念 | 解决的问题 |
|---|---|
| Safe Area | 内容如何避开系统栏遮挡 |
| Layout Margins | 内容与容器边缘保留多少视觉间距 |
insetsLayoutMarginsFromSafeArea 默认 true,UIKit 会自动把落在 Safe Area 外的 Margins 收进来。所以不要在使用 layoutMarginsGuide 之后又机械地加一遍 Safe Area Insets。
5. 同心圆角
贴边面板的固定圆角不一定与外层轮廓协调,iOS 26 提供同心圆角 API:
1 | if #available(iOS 26.0, *) { |
旧系统继续用固定圆角即可。
6. 优先使用系统导航
| 导航/呈现方式 | 系统组件 | 行为 |
|---|---|---|
| 分栏导航 | NavigationSplitView / UISplitViewController |
合上折叠为单栈,展开并排或覆盖 |
| Tab 导航 | TabView / UITabBarController |
适应内外屏,必要时纵向排列 |
| Sheet | 系统呈现组件 | 外屏按钮可纵向排列,内屏居中 |
| 其他弹层 | Popover / Context Menu / Alert | 随姿态调整 |
内屏可显式偏好侧边栏:
1 | if #available(iOS 27.0, *) { |
意义:用系统组件就等于免费获得竖排适配,自绘栏需要自己实现全部形态切换。
7. Reserved Regions(iOS 27.1+)
只在”需要使用 Safe Area 之外的空间”时才引入,例如自定义贴边 Toolbar。
| 类型 | 含义 |
|---|---|
occlusion |
被遮挡的区域,如摄像头、灵动岛、窗口控件 |
division |
划分内容的区域,如铰链折叠位置 |
1 | @available(iOS 27.1, *) |
每个区域包含位置、Margins、激活状态与标识。查询到区域之后仍需自行决定怎么排,API 只提供信息。初次适配应先把系统导航与 Safe Area 做对,再按产品需要引入。
8. 用 Device Hub 测试
Xcode 27.1 的 Device Hub 可切换合上、展开、旋转、折叠。建议覆盖:
| 场景 | 检查点 |
|---|---|
| 外屏竖屏 / 横屏 | 窄空间下内容完整、控件可操作 |
| 内屏展开 / 旋转 | 分栏与 Tab 是否合理,是否仍依赖旧尺寸 |
| 折叠状态 | 自定义内容是否与折叠区冲突 |
| 页面显示中开合 | 布局是否随可用空间变化 |
| Split View 左右两侧 | 两侧 Safe Area 与 Margins 是否分别处理 |
| 各姿态下的 Sheet / 菜单 / Alert | 系统呈现与业务内容都正常 |
可配合 Xcode 27.1 的 App Resizability(原 App Modernization Skill)辅助检查。
已知问题:Xcode 27.1 RC 的 iPhone Duo 模拟器不支持 StandBy,多数 App Extension 无法运行调试。
9. 推荐适配顺序
- 先升级 SDK,检查界面表现,再移除全局屏幕与固定尺寸假设;
- 修复 Safe Area 与 Layout Margins;
- 按需增加侧边栏、同心圆角、Reserved Regions。
扫描二维码,分享此文章