cubegao

iPhone Duo 布局适配要点(WWDC Tech-talks)

2026-11-14

来源:Apple WWDC Session《iPhone Duo 布局适配》(tech-talks/111461)

一句话结论

iPhone Duo 适配的核心,不是新增一套”折叠屏专用布局”,而是消除代码中对设备型号、屏幕尺寸、界面方向的判断:结构交给 Size Class,尺寸交给容器,避让交给 Safe Area。

0. 五条关键结论

  1. 必须用 iOS 27.1 SDK(Xcode 27.1)构建,否则 Duo 边缘黑屏。
  2. 用 Size Class 决定布局结构,不要用 userInterfaceIdiom 或 interfaceOrientation。
  3. 布局依据当前容器(view.bounds、safeAreaLayoutGuide),不是 UIScreen.main。
  4. Safe Area 不再只是上下,左右可能不对称;Layout Margins 也可能不对称。
  5. 优先用系统导航组件;只有自定义贴边控件才需要 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
2
3
4
5
// ❌ 把设备类别当成可用空间
let shouldUseWideLayout = UIDevice.current.userInterfaceIdiom == .pad

// ✅ 判断当前环境是否适合宽布局
let shouldUseWideLayout = traitCollection.horizontalSizeClass == .regular

userInterfaceIdiom 无法反映”有没有足够空间显示侧边栏”,也不能把 “iPhone” 等同于”只能单列”。

2.2 内外屏的常见组合

显示状态 Horizontal Vertical
外屏竖屏 compact regular
外屏横屏 compact compact
内屏展开 regular regular
1
2
let horizontalClass = traitCollection.horizontalSizeClass
let verticalClass = traitCollection.verticalSizeClass

结构由 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
2
3
4
5
// 容器尺寸(正确)
let containerSize = view.bounds.size

// 屏幕尺寸(错误,改完依然不是"当前 View 的可用宽度")
let width = view.window?.windowScene?.screen.bounds.width

折叠屏上”主屏幕”本身就不明确,UIScreen 文档也明确不建议用它决定界面布局。

4. Safe Area

4.1 不再是”顶 + 底”

系统栏位于 Safe Area 之外,并通过 Insets 让内容避开。不能简化为「状态栏高度 + Home Indicator 高度」。

4.2 前景避让,背景铺满

1
2
3
4
5
override func viewDidLayoutSubviews() {
super.viewDidLayoutSubviews()
backgroundView.frame = view.bounds // 背景铺满
controlsContainer.frame = view.bounds.inset(by: view.safeAreaInsets) // 前景避让
}

Auto Layout 下直接约束到 safeAreaLayoutGuide;SwiftUI 用 ignoresSafeArea() 让背景铺满,而不是让整个交互层忽略 Safe Area。

4.3 左右不一定相等

1
2
3
4
5
6
// ❌ 假设左右相等
let contentWidth = view.bounds.width - view.safeAreaInsets.left * 2

// ✅ 逐边处理
let safeRect = view.bounds.inset(by: view.safeAreaInsets)
let contentWidth = safeRect.width

排查旧项目时特别注意三类代码:底部弹窗、自定义 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
2
3
4
5
if #available(iOS 26.0, *) {
panelView.cornerConfiguration = .corners(radius: .containerConcentric())
} else {
panelView.layer.cornerRadius = 12
}

旧系统继续用固定圆角即可。

6. 优先使用系统导航

导航/呈现方式 系统组件 行为
分栏导航 NavigationSplitView / UISplitViewController 合上折叠为单栈,展开并排或覆盖
Tab 导航 TabView / UITabBarController 适应内外屏,必要时纵向排列
Sheet 系统呈现组件 外屏按钮可纵向排列,内屏居中
其他弹层 Popover / Context Menu / Alert 随姿态调整

内屏可显式偏好侧边栏:

1
2
3
if #available(iOS 27.0, *) {
tabsController.sidebar.preferredPlacement = .sidebar
}

意义:用系统组件就等于免费获得竖排适配,自绘栏需要自己实现全部形态切换。

7. Reserved Regions(iOS 27.1+)

只在”需要使用 Safe Area 之外的空间”时才引入,例如自定义贴边 Toolbar。

类型 含义
occlusion 被遮挡的区域,如摄像头、灵动岛、窗口控件
division 划分内容的区域,如铰链折叠位置
1
2
3
4
5
6
@available(iOS 27.1, *)
func activeOcclusionFrames(in view: UIView) -> [CGRect] {
view.reservedRegions(kind: .occlusion)
.filter(\.isActive)
.map(\.frame)
}

每个区域包含位置、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. 推荐适配顺序

  1. 先升级 SDK,检查界面表现,再移除全局屏幕与固定尺寸假设;
  2. 修复 Safe Area 与 Layout Margins;
  3. 按需增加侧边栏、同心圆角、Reserved Regions。

扫描二维码,分享此文章