症状:项目能在 Xcode 里打开,或 Device Hub 模拟器能运行,不等于 iPhone Duo 已完成发布验收。 最快解法:用 Xcode 27.1 和远程 Mac 完成构建、模拟器姿态检查及 CI 留证;涉及真实硬件能力、扩展限制和最终体验的项目,另列真机复核,不要把模拟器通过记作整机通过。
适合负责 iPhone Duo 适配的 iOS 开发者:核对不同姿态下的布局与交互。 适合移动端 QA、发布工程师:整理可追溯的测试证据并核对提交素材。 适合 CI 与平台工程师:划清远程 Mac 可自动化的任务,以及仍需真实设备验证的部分。
最后更新于 2026 年 10 月 14 日;信息核实自 Apple Developer 的 iPhone Duo 准备与提交公告、Xcode 27.1 RC 发布说明、系统要求及 App Store Connect 素材规范。 iPhone Duo 计划于 2026 年 10 月 23 日开始发售;这篇清单依据发稿时可查到的官方资料整理,上市后的真实设备行为尚未由本文核验。(Apple 的 iPhone Duo 准备与提交公告)
建立 Xcode 27.1 与远程 Mac 验收基线
先验证工具链是否匹配,再讨论布局是否适配。Apple 当前列出的 Xcode 27.1 RC 要求 Mac 运行 macOS Tahoe 26.6 或更高版本,并包含 iOS 27.1 SDK;“项目能打开”或“普通 iPhone 模拟器能跑”不能证明目标设备支持、运行时和测试目标都已准备好。具体要求以 Apple 的 Xcode 系统要求表及 Xcode 27.1 RC 发布说明为准。
在远程 Mac 上,先固定正在使用的 Xcode 路径与版本,避免机器里有多个 Xcode 时,命令行和图形界面调用不同工具链:
xcode-select -p
xcodebuild -version
xcodebuild -showsdks
随后记录项目提交号、Scheme、构建配置、SDK、模拟器运行时,以及测试设备目的地。以下检查可确认 Simulator 当前登记了哪些可用设备;若 iPhone Duo 运行时没有安装或不可用,不要把其他机型的测试结果标成 iPhone Duo 验收:
xcrun simctl list devices available
基线记录至少应能回答:使用的 Xcode 是否为 27.1 RC;Mac 的 macOS 是否满足要求;SDK 与模拟器运行时是否匹配;构建目标是否确实选择 iPhone Duo 模拟器。将这组信息随测试结果存档,后续才能区分代码回归、运行时差异与远程节点配置漂移。
按姿态覆盖布局,而不是只看静态预览
在 Xcode 27.1 中,选择 iPhone Duo 模拟器,并在 Device Hub 检查项目需要支持的姿态与方向;先看内容是否完整可见,再看系统保留区域、折叠区域和窗口尺寸变化是否触发布局错误。Apple 的 iPhone Duo 准备指南列出了 iPhone Duo 模拟器和 Device Hub 中可调整大小的模拟器等检查方式;其设备设计指导提醒开发者使用安全区域与布局边距,避免绑定固定宽度。可对照准备 iPhone Duo 的官方步骤与 Xcode 27.1 RC 已知问题。
把姿态覆盖写成项目自己的验收矩阵,不要凭“看过几个画面”作结。对每个业务关键页面,留下以下记录:
- 窗口与姿态:外屏、内屏、方向变化及项目实际支持的折叠姿态;标注执行的模拟器目标。
- 布局:导航栏、工具栏、表单、弹窗和主要内容是否被截断、遮挡或挤压;重点检查动态安全区域和折叠保留区域。
- 内容重排:列表与详情是否能在可用空间变化时调整,图片和视频的关键主体是否仍在画面内。
- 复核证据:每个失败项附带当前提交号、姿态、页面与截图或录屏,修复后用同一组条件重新验证。
用交互指标检查尺寸切换后的状态
姿态变化后,关键问题不是“画面有没有变化”,而是用户能否继续完成操作。选择应用的主要任务路径,在布局切换前后重复操作,并将预期结果写进测试记录:
- 导航:返回、切换栏目、选择列表项后,焦点和当前页面是否符合预期。
- 输入:切换尺寸后,输入内容、键盘状态、光标位置与表单校验是否保持合理。
- 滚动与选择:列表滚动位置、已选项目、展开状态是否无故丢失;若产品预期重置,也要明确记录。
- 关键业务流程:登录、编辑、提交、支付或项目实际核心流程是否可从头到尾完成,不只验证入口按钮可点击。
- 跨屏体验:从外屏切换到内屏、再切回时,用户是否回到合理的上下文;需要重新加载的内容是否有明确反馈。
划清 Device Hub、模拟器与真机结论边界
远程 Mac 可以运行 Xcode 27.1 中的 iPhone Duo 模拟器,用 Device Hub 检查支持范围内的布局与交互,并把截图、录屏及自动化测试结果留在远程构建流程中;但模拟器不能等同真实设备。Apple 说明,Device Hub 可管理模拟和实体设备;模拟器适合快速评估功能与界面,硬件依赖功能或性能问题则应在真实设备上测试。(Apple 的 Device Hub 文档;在模拟或实体设备上运行应用)
发布前应给测试结果加上证据等级,而不是只填“通过”:
- 模拟器覆盖:构建成功、支持的姿态布局、常规控件交互、自动化测试覆盖到的流程。
- 需独立核验:需要真实硬件传感器、相机、外设或设备专属行为的功能;模拟器不支持或 Xcode 发行说明标记受限的场景。
- 真机复核:性能、硬件行为、系统集成以及模拟器无法运行或调试的路径。
- 未覆盖:缺少运行时、设备、权限、账号或环境而未执行的检查;明确标为未验证,不能默认为通过。
⚠️ Device Hub 测试通过,证明的是已选择的模拟器目标和已执行用例通过;它本身不证明 iPhone Duo 真机验收完成。把未覆盖的硬件路径明确写进发布风险,别把“没有失败记录”当成“已验证”。
固化远程 Mac CI 的可追溯证据
将可重复执行的构建、单元测试和支持的模拟器测试放入远程 Mac CI;把真机专属项目留在独立设备验证流程。每个流水线任务都应绑定同一提交版本与构建配置,至少保留:
- 源码提交号、活动 Xcode 版本、macOS 版本与目标运行时;
- 构建状态、测试计划、测试结果和失败日志;
- 关键姿态截图或录屏,并在文件名或测试记录中注明页面、姿态和提交;
- 未执行项、失败原因、复测结果及对应负责人。
.xcresult 测试结果包,其中可包含会话结果、启用时的代码覆盖率及其他日志;应将其作为 CI 产物保存,而非只留一张绿色流水线截图。相关内容见 [Apple 的测试结果说明](https://developer.apple.com/documentation/xcode/running-tests-and-interpreting-results)。
对远程 Mac,还要核对图形界面与 CI 是否使用同一份项目状态、同一 Xcode 和相同的运行时。通过 SSH 触发的测试失败时,保留命令、目的地与完整日志;通过远程图形会话做人工检查时,把截图与自动化任务的提交号关联起来。否则,同一份报告里可能混入不同提交、不同运行时甚至不同目标的证据,无法复现。
如果你还在评估是否需要单独准备远程 Mac 环境,可先从 MACGPU 的 Mac 环境与服务选项核对适用方式,再按项目的 Xcode、模拟器与产物留存需求决定远程节点要承担哪些工作。
核对发布素材并确定准入条件
iPhone Duo 上线前,先核对 App Store Connect 当前列出的截图尺寸与支持方向,再检查预览工具中的产品页呈现;截图、应用预览、产品页头图和其他创意素材应分别核对,不能用应用界面截图代替所有素材类型。Apple 当前资料列出 iPhone Duo 截图规格,并说明 App Store Connect 可预览素材在设备与方向下的呈现。提交前应复查 App Store Connect 截图规格及当期产品页预览要求。
需要视频预览时,另行确认设备适用性和技术规格;Apple 说明,应用预览与设备类型相关,并规定每种语言最多可提供 3 个预览,每个最长 30 秒。这不是要求每个 App 都必须提交预览;应根据产品页策略及当前 App Store Connect 要求决定是否制作。
Apple 在 2026 年 10 月 5 日的准备公告中说明,iPhone Duo 优化应用可以提交,并指出从 2027 年 4 月开始,提交的应用或游戏需要包含 iPhone Duo 截图。这个生效条件不能改写为“当前所有提交都必须已有该截图”;发布时应复核公告是否更新,并以提交当日 App Store Connect 展示的要求为准。
| 验收选项 | 能确认的范围 | 不能据此确认的范围 | 适用决策 |
|---|---|---|---|
| Device Hub/iPhone Duo 模拟器 | 可用运行时下的布局、姿态与已执行交互 | 真实设备性能、未提供的硬件能力、模拟器已知限制 | 作为发布前自动化与人工预检 |
| 远程 Mac CI | 可重复构建、自动化测试及与提交关联的测试产物 | 未纳入流水线的人工体验、物理设备行为 | 作为持续回归与证据归档主线 |
| iPhone Duo 真机 | 真实硬件上的体验、设备能力及模拟器未覆盖路径 | 未执行的版本、姿态或业务流程 | 对高风险与模拟器受限项目补验 |
| App Store Connect 预览 | 素材在产品页中的呈现与提交状态 | 应用运行表现、所有未提交素材的合规性 | 上架前核对素材与当期提交要求 |
如果你手头没有满足 Xcode 27.1 要求的 Mac,先判断工作是短期的工具链适配和模拟器检查,还是需要长期稳定运行、真机接入或专用硬件的持续负载:后者未必适合租用远程环境,真机验证也不能由远程 Mac 模拟器代替。对临时构建、CI 补位和远程图形验收,MACGPU 的远程 Mac 可作为购买实机之外的选择;你可以先查看 MACGPU 的 Mac 选项,再按本文清单确认所需工具链与证据获取方式。