利益相关声明:作者与文中产品有直接的利益相关(开发者、自家产品等)

前言

距离 iPhone Duo 的正式发售已经过去快半个月了,手够快 or 钱包够深的小伙伴们应该都已经拿到自己心仪的 iPhone Duo 了吧?作为一个没抢到首发,去店里摸过真机后又退单的苦逼独立开发者,我这半个月一直在和代码和设计做斗争,最近终于完成了大部分 APP 的适配工作,腾出手来将最近的适配工作做一个记录,也希望能给大家分享一点点经验,将来能少踩一点坑。

本文将会从设计、交互以及代码三个层面来阐述适配 iPhone Duo 需要做的工作。其中个人认为最关键的还是设计和交互,这也是本文重点关注的部分,至于代码,现在的各种 Agent 都已经足够强大,完全可以借助它们的能力来完成最终的实现,只要做好把关即可。接下来话不多说,我们直接进入正题。

顺便一说,我自己非常不喜欢读「AI 味满满」的文章,因此本文完全由笔者人脑构思 + 人手打字,如有错漏还请海涵,也欢迎评论区指正,提前谢谢大家!


为什么要适配 iPhone Duo

iPhone Duo(后文可能会简称为 Duo)是苹果在 2026年发布的全新形态的手机设备,它是iPhone 产品线首次使用铰链连接的双折叠手机,它和以往的iPhone 产品最大的不同是:

  • 具有内外两个屏幕,其中外屏为 5.4 英寸的异形屏,内屏完全展开后是 7.6 英寸的矩形屏幕。
  • 铰链可以悬停在半开状态,这引入了新的产品形态。

和往年的修修补补不同,iPhone Duo 对现有 APP 的适配提出了新的挑战,在使用旧 SDK 编译并且不做 UI 适配的情况下,现有 iOS APP 直接运行在 Duo 上的效果惨不忍睹;同时 APP 也无法很好的利用 Duo 的双屏形态,为用户提供良好的使用体验。

最后,苹果在《为 iPhone Duo 准备并提交你的 App》中明确提出,从 2027 年 4 月起,提交的任何 App 或游戏都需要包含 iPhone Duo 截屏,这也意味着适配 iPhone Duo 的最后期限已经不远了。


新词的基本情况

新词是一个纯原生开发的跨端 APP,主要使用了 SwiftUI + CloudKit 的底层架构,并且早在 iOS 版本开发之初就已经决定要同时适配 iPad 等平板设备,很多开发者私下讨论的时候都笑称:iPhone Duo 的发布极大利好 iPad 的软件环境,至于具体原因我会在后文详细阐述。

所以从基础体质上来说,新词做 iPhone Duo 的适配是有天然优势的,在适配工作开始之前我乐观估计应该最多3天就能处理好,但后续工作开展之后,我才发现自己图样了,整套 iPhone Duo 的适配是一个系统性的工程。


动手之前

作为从业多年的 iOS 开发者,iPhone Duo 属实是苹果十年一见的「盛况」,上一次需要如此大规模的重构代码来适配的设备应该还是 iPhone X,而且从设计层面来说,iPhone Duo 的适配工作远不止将画面压扁拉长、躲避刘海这么简单,所以本着磨刀不误砍柴工的精神,我们最先应该做的是:阅读苹果官方设计指南。

针对 iPhone Duo 设计

提起苹果的 Xcode 开发者文档,可能很多开发者都会有所诟病,例如速度慢啦,没示例啦,但是提到设计文档,苹果交付出的  《人机界面指南》可谓是行业标杆,值得所有 APP 开发者和设计师仔细研读。

同样的,苹果也为本次的 iPhone Duo 适配提供了详细的文档:《针对 iPhone Duo 设计》。文档中针对需要适配的各种场景做了细致的讲解,并且还提供了最佳实践。以我个人见解,通读下来的核心思想是:

让现有 APP 随屏幕大小和折叠状态自然调整,同时保持操作习惯和使用进度连续。

图片来自《针对 iPhone Duo 设计》

细分下来可以大概总结为五个要点:

  • 按可用空间布局:使用 size class、安全区和布局边距,避免写死尺寸或依赖某块屏幕。
  • 展开后增加展示内容:例如从单栏变成“列表+详情”,保持原有信息层级与功能。
  • 避开折叠和摄像头区域:优先让系统组件自动处理,自定义组件再通过预留区域 API 调整。
  • 减少布局突变:折叠过程中只移动必要的内容,避免按钮突然消失或大幅换位置。
  • 遵循系统侧边导航:工具栏和标签栏在适用姿态下移到侧边,空间不足时优先保留常用操作。

开发过 iPad 应用的小伙伴应该会敏锐的发现,上面的核心原则,除了摄像头规避和侧边栏处理之外,完全适用于iPad 应用的开发和适配,所以如果你借助这次契机做好了 Duo 的适配工作,那么恭喜你,你的 APP 在平板上的表现也会同样出色!


开始基础适配

看完了设计指南,了解了适配的基本思路之后,我们就可以进入适配工作的下一阶段了:让UI 正确的在 Duo 上跑起来。

众所周知,将 iPhone 的 UI 直接搬到 iPad 上是灾难,这个原理放在 Duo 上同样成立。因此这一步的核心目标是让 UI 变得有「弹性」,可以灵活自如的在 iPhone 的多个屏幕「容器」中进行切换,如水般流动起来。

1. 外屏适配

我们从外屏开始处理,如苹果文档所示,Duo 的外屏虽然是一个「异形屏」,但是它的核心展示区域其实还是一个规矩的矩形,要做好它的适配,我们的核心思路是:在更宽、更矮的空间里,优先保证内容高度和操作便利。

 

1.1 接受侧边导航

我们需要让工具栏、标签栏移到侧边,减少顶部和底部对内容的挤占,这和传统的 iOS 工具栏布局完全不同。好消息是,如果我们使用系统 TabView 和 .toolbar的话,只需要使用 iOS 27.1 或更新的 SDK 来构建 APP,系统就会在适合的姿态下自动把它们排到侧边,不需要额外的努力;与之相反,如果你用了自定义控件的话,就得自己处理和实现了,这也是 SwiftUI 中很常见的系统默认实现,需要开发者自己做取舍。

1.2 按实际可用空间布局

需要尽量避免使用 .ignoreSafeArea,遵守 iOS 系统的安全区,从而避开摄像头、灵动岛和侧边控件,还有就是要避免写死宽高,包括传统的根据 origin 判断屏幕横竖的方式也完全不可取,这对有年头的老项目可能是比较大的挑战。

1.3 压缩纵向占用

尽量减少过大的顶部留白,不要添加固定高度的装饰。因为 Duo 的外屏相比其他 iPhone 要更「短」,过多的顶部元素会严重压缩画面的高宽比,造成头重脚轻的不和谐效果。与此同时,因为屏幕在垂直方向上的可用空间更少,可能会导致原先能放得下的内容,在 Duo 上不够放,因此需要注意长内容要允许滚动,可以适当的插入 ScrollView 来避免内容被卡在屏幕底部外面的尴尬局面。

1.4 保持功能与状态连续

在做外屏适配的时候一定要意识到,Duo 的内外屏其实是一个整体,当用户展开内屏时,他期待的是外屏内容的延续和扩展,因此切换内外屏后,当前页面、选择和任务进度都应当完整保留,常用操作依然可用,并且可以在此基础上进行扩展,详细的内容我们会在内屏适配部分进一步阐述。

新词APP在外屏 -> 内屏展开后的效果

2. 内屏适配

内屏相对于外屏,适配起来复杂度又上了一个等级,因为内屏有更多种不同的形态,用代码可以大致枚举为:

enum InnerDisplayLayout {
    /// 完全展开,竖向使用
    case expandedPortrait

    /// 完全展开,横向使用
    case expandedLandscape

    /// 半折叠,折痕竖向,类似打开的书
    case book

    /// 半折叠,折痕横向,类似笔记本电脑
    case laptop
}

我们可以进一步将其分作两类来分别探索:

2.1 完全展开状态

内屏的完全展开状态类似 iPad Mini ,某种意义上说完全可以当作 iPad 版本来优化和适配,这也是前文所说的「iPhone Duo 的发布极大利好 iPad 的软件环境」的原因,当我们处理好了完全展开状态的 Duo 适配,那么你的 APP 在 iPad 上应该也就没有什么问题了。

2.1.1 宽度足够时考虑双行展示

横屏状态下展开的 Duo,其可用的展示空间和 iPad 类似,比较好的适配原则是尽量采用多栏展示,可以使用 SplitView等系统控件,在保证内容完整的同时提升信息密度。以下图的新词 APP 为例,我们可以简单粗暴的将列表直接铺满横屏画面,但更佳的方式是采用「列表 | 详情」的结构,让用户能更好的利用屏幕的宽度,在相同的屏幕空间中做更多的事。

完全展开状态下横竖屏的新词APP

2.1.2 保持功能和状态一致

这一条主要针对 Duo 的屏幕展开,展开前后的功能、选中内容和任务进度都应保持连续,不能出现外屏在展示 View A,展开后直接变成 View B 的情况,丢失上下文会让用户无所适从。

具体到新词 APP 中,复习模块在展开前后展示的内容基本一致,但是将原先的垂直 ScrollView的内容进行了折叠,直接在同一个屏幕中完成了展示,很好的提升了屏幕空间的利用率。

新词 APP 的「复习」模块的内外屏展开变化

 

2.1.3 完全展开时无需刻意上下分区

Duo 的内屏完全展开的时候优先使用完整画布,半折叠时再根据折叠区域调整。

2.2 半折叠状态

接下来就来到了 Duo 适配中比较有趣的部分了,也是折叠屏手机相较于直板手机最大的不同:内屏半折叠。根据屏幕的横竖状态,我们可以想象用户在使用时的场景:横屏半折叠如捧书本,竖屏半折叠如观MacBook。

从原理上来说,我们完全可以无视半折叠状态,将其当作全展开状态适配也没有太大的问题,但是作为专业的开发者,如何更好的利用苹果提供的设备特性,从而做出更实用、更有趣的产品,是我们应该认真思考的问题。

2.2.1 让重要内容和控件避开折叠区域

可以简单想象一下,如果关键的按钮、滑块、输入框正好处于屏幕正中心,当内屏半折叠的时候它们可能就正好卡在弯曲的铰链位置,导致用户无法正常操作,因此这种情况是必须要避免的。

在 iOS 27.1 及更新的 SDK 中,我们可以使用 GeometryReader新增的 reservedRegionsAPI 来实现对左右/上下分区的识别,简单的示例代码如下:

GeometryReader { proxy in
    let regions = proxy.reservedRegions(kind: .division)
}

同时我们还可以通过监听 Hinge 的变化来感知当前屏幕的折叠情况

@State private var hingeStatus: DeviceHinge.Status?

.onHingeChange { _, context in
    hingeStatus = context.hinge?.status
}

除此之外,这次的 API 还新增了

// 折叠等导致内容需要分区的区域
proxy.reservedRegions(kind: .division)

// 摄像头、灵动岛等遮挡内容的区域
proxy.reservedRegions(kind: .occlusion)

可以视情况灵活使用。

2.2.2 减少折叠时的布局突变

和内外屏展开的逻辑类似,苹果也特别强调了,半折叠时不要让整体布局产生破坏性的变动,尽量只移动必要元素,同时尽量保持控件的相对位置,以防用户丢失上下文。

半折叠状态的新词 APP 「笔记本」

 

2.2.3 保持功能和状态连续

这条无须多说,也是为了让用户能获得连贯顺畅的使用体验。

不要止于适配

到目前为止,iPhone Duo 的适配其实就已经基本上完成了,你的 APP 能够在 Duo 上正常展示,操作逻辑和交互也合乎苹果的设计指南,但作为有想法的开发者,我们还想在 Duo 上更进一步。

在观看 Duo 的早期上手视频时,我注意到了 Netflix 在 Duo 上的独特形态:Duo 就像 3DS 一样垂直半折叠,屏幕的上下两部分分别展示画面和视频控件,非常有趣。

图片来源 Instagram 用户 ijustine

于是我开始思考我的产品形态,有什么适合 Duo 的最大特点:折叠。最终我找到了复习和听写功能,折叠后的 Duo 形态非常像 3DS,我们可以充分利用上下屏来做出独特的交互。

新词 APP 的复习在半折叠后的状态变化

与之类似,新词的听写功能也非常适合做这样的修改。

新词 APP 的听写功能

在代码实现方面,普通布局和半折叠布局我共用了卡片与评分逻辑。FoldSplitReader  识别到横向折叠区域时,才切换到上下布局。

FoldSplitReader { split in
    if let split {
        foldedSession(split)
    } else {
        sessionPanel(split: nil)
            .safeAreaInset(edge: .bottom, spacing: 0) {
                controls
            }
    }
}

而在处理半折叠状态时时,我会按铰链的实际位置给上下两块分配高度。上半区展示进度和单词卡片,下半区放「显示答案」或评分按钮。

代码之外

iPhone Duo 的适配远不止代码上的适配,能够正常的在 Duo 上跑起来,UI 完美展示,整个工作也就只完成了 80%,剩下的 20% 还需要我们代码之外的努力。

1. AppStore 新增 Duo 截图

随着 Duo 的正式发售,苹果在 App Store Connect 中新增了一个 iPhone Duo 专用的截图上传槽位:

目前这组截屏是可选的,很多粗心的开发者可能会有意无意的忽略,但对于已经完成了 iPhone Duo 适配的应用来说,如果忘了这一步几乎等于前功尽弃。

根据苹果发布的《为 iPhone Duo 准备并提交你的 App》指南,只有在 App Store Connect 提交 iPhone Duo 截图后,产品页才会显示「已针对 iPhone Duo 优化」的标识。 仅完成代码适配、重新编译,都不会出现标识。

2. AppStore 的营销事件 Event

既然我们都已经走到了这一步,记得可以添加一个 APP 内活动,让我们的用户能第一时间知道,我们已经为 iPhone Duo 做好了准备,这对新用户下载和转化都非常有用。

后记

本文施工到这里已经接近尾声,从设计思路到功能实现都已有所涉及,但受限于篇幅很多细节都没有展开细说,有兴趣的话可以观看 Apple 官方推出的 Session 视频 《Design for iPhone Duo》。


最后也给自家的 APP 打一个小广告:

新词 APP 是一个支持多种语言的个人单词本应用,通过 AI 加持能够准确的提供多种小语种单词的释义和发音。

新词目前支持 iOS / iPadOS / macOS / tvOS / watchOS 等多个 Apple 平台,除了方便的日常单词收集之外,新词还采用了基于 FSRS 算法的智能复习和听写功能,希望能帮助大家更多更好的学习外语。

 

文中部分配图使用我自己开发的 MockupStudio 生成,目前正在五折优惠中,也欢迎大家免费试用。

Mockup Studio 使用界面

再次感谢大家的阅读!