症状:项目能在 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 发行说明标记受限的场景。
  • 真机复核:性能、硬件行为、系统集成以及模拟器无法运行或调试的路径。
  • 未覆盖:缺少运行时、设备、权限、账号或环境而未执行的检查;明确标为未验证,不能默认为通过。
Xcode 27.1 RC 的发行说明列出 iPhone Duo 模拟器的已知限制:StandBy 不可用,且大多数 App Extension 无法在该模拟器运行或调试。遇到这类项目时,标记为“模拟器不覆盖”,再安排适用的替代证据或真机复核;不能因为主应用正常启动,就给扩展打通过。正式发布前应重新查看发行说明,并确认问题状态是否变化。

⚠️ Device Hub 测试通过,证明的是已选择的模拟器目标和已执行用例通过;它本身不证明 iPhone Duo 真机验收完成。把未覆盖的硬件路径明确写进发布风险,别把“没有失败记录”当成“已验证”。

固化远程 Mac CI 的可追溯证据

将可重复执行的构建、单元测试和支持的模拟器测试放入远程 Mac CI;把真机专属项目留在独立设备验证流程。每个流水线任务都应绑定同一提交版本与构建配置,至少保留:

  • 源码提交号、活动 Xcode 版本、macOS 版本与目标运行时;
  • 构建状态、测试计划、测试结果和失败日志;
  • 关键姿态截图或录屏,并在文件名或测试记录中注明页面、姿态和提交;
  • 未执行项、失败原因、复测结果及对应负责人。
用命令行运行测试时,Xcode 会生成 .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 选项,再按本文清单确认所需工具链与证据获取方式。