iPhone Duo 适配怎么测？2026 企业 CI 验收清单

截至 2026 年 9 月 16 日，Apple 已公开 iPhone Duo 的开发准备资源、设计指导和多场技术视频；Xcode 27 已正式发布。企业不能因为出现新的设备姿态，就直接把开发者人数换算成 Mac 节点数量。(developer.apple.com)

我们建议先把工作拆成 6 种状态：

• 应用兼容：确认现有代码在新尺寸、尺寸类别和场景变化下是否正常运行。
• 界面优化：处理外屏、内屏、折叠和旋转后的导航、弹窗、工具栏与自定义布局。
• 模拟器验证：覆盖确定性强、可重复执行的布局和状态回归。
• 真机验证：确认摄像头、性能、物理姿态和真实交互行为。
• 素材提交：生成符合 App Store Connect 要求的截图和预览素材。
• 生产发布：归档、签名、上传和正式发布。

这 6 类任务的权限、证据和失败后果不同。把它们全部塞进同一台 Mac，会造成三个隐性成本：

1. 工具链污染：试验版 Xcode、模拟器运行时或新的构建脚本可能改变稳定节点的生产结果。
2. 签名边界扩大：兼容验证节点一旦可以访问生产证书、私钥或发布凭证，测试环境就变成发布风险。
3. 容量判断失真：新增的是短期回归任务，不一定是长期构建负载。按开发者人数采购，通常无法解释队列为什么变长，也无法证明新增节点真的被持续使用。

iPhone Duo 适配不能只增加一次横屏和一次竖屏测试。Apple 的资料将外屏、内屏、尺寸类别、折叠状态、场景和多显示行为分开处理；内屏可以提供更大的可用空间，外屏则有不同的尺寸类别和窗口行为。(developer.apple.com)

应用研发负责人需要为每个高风险页面建立资产记录。最低字段包括：

• 页面或业务流程名称；
• 外屏、内屏、展开、折叠、旋转等测试姿态；
• 导航、弹窗、列表、摄像头、支付和自定义布局风险；
• 代码位置或组件名称；
• 复现条件；
• 修复负责人和当前状态；
• 是否适合自动化；
• 否决条件。

Apple 建议使用尺寸类别、场景边界和本地布局概念，而不是在代码中固定依赖某个屏幕尺寸。对于 SwiftUI，可以检查 NavigationSplitView、环境值和尺寸类别；对于 UIKit，则重点检查 traitCollection、场景边界和自适应容器。不要把 UIScreen.main 当成所有布局判断的统一入口。(developer.apple.com)

摄像头场景要单独标记。iPhone Duo 的外屏和内屏摄像头方向会随设备打开、关闭和视图位置变化，摄像头应用还可能涉及 CameraCaptureAccessory。如果应用包含扫码、拍照、视频会议或上传证件，普通 UI 回归不能替代摄像头方向和预览比例验证。(developer.apple.com)

iPhone Duo 应用适配的姿态范围

QA 不需要让每次提交都跑完整矩阵。我们建议将姿态分成三层：

因此，iPhone Duo 模拟器测试不能替代真机测试，但可以承担大量确定性回归。它适合发现布局溢出、按钮不可见、状态丢失、导航栈错误和截图生成问题；它不应单独证明摄像头切换、真实性能、物理折叠交互或硬件相关行为。

每条 QA 结果至少保存：

• 测试姿态；
• 应用初始状态；
• 操作步骤；
• 预期结果；
• 实际结果；
• 失败截图或视频；
• 构建号和测试环境；
• 阻断级别；
• 是否需要真机复核。

Apple 的技术资料明确提到，iPhone Duo 支持多场景和不同显示区域，外屏创建新窗口的行为也可能与内屏不同。涉及多窗口、分屏和场景恢复的应用，不能只依赖单一启动流程。(developer.apple.com)

Xcode 27.1 在企业 CI 中的独立部署

Xcode 27.1 的企业验证通道应采用独立节点、独立 Runner 标签和独立任务队列。不要先把试验工具链覆盖到正式发布节点，再通过失败结果判断是否兼容。

我们建议按以下步骤落地：

1. 冻结生产基线：记录正式节点当前的 macOS、Xcode 版本、SDK、证书访问范围、构建脚本和缓存策略。
2. 准备独立 Mac：新节点只安装验证所需的 Xcode、模拟器运行时、依赖管理工具和测试脚本。
3. 建立 Runner 标签：例如区分 iphone-duo-validation、production-archive 和 device-test，禁止普通构建任务自动抢占验证节点。
4. 导入最小项目集：先选择一个主应用、一个依赖复杂的应用和一个包含 UI 自动化的应用，不要一开始迁移全部仓库。
5. 执行最小姿态回归：先覆盖启动、主导航、关键弹窗、状态恢复、截图生成和代表性业务流程。
6. 采集原始 CI 数据：记录安装恢复时间、构建时间、测试时间、失败率、队列等待、磁盘变化和重试次数。
7. 逐步扩大范围：只有当最小项目集连续通过，并且失败原因可解释时，才增加仓库和并发任务。
8. 定义回退动作：验证节点失败时，任务回退到原生产链路；生产节点出现异常时，不得通过临时安装试验版工具链解决。

Apple 在 Xcode 27 中继续强化 Device Hub，并将设备与模拟器管理、诊断和测试流程集中到开发环境中。对企业 CI 而言，这意味着我们可以统一测试入口，但不能因此把验证节点和发布节点混成同一条权限链。(developer.apple.com)

验收时不要只看“构建成功”。至少需要比较以下 5 项：

• 构建时长是否出现持续性增长；
• 姿态回归是否因模拟器启动或恢复失败而重试；
• 队列等待是否集中在某一时间段；
• 测试过程是否造成磁盘持续增长；
• 节点重建后，缓存、凭证和临时文件是否被清理。

这些数据必须来自企业自己的 CI 日志或本站实测。Apple 官方资料没有确认某个项目需要多少 Mac，也没有确认某种节点可以承载多少并发任务。

兼容验证节点默认不应持有生产证书私钥、App Store 发布凭证或长期有效的签名资产。正式归档和发布继续留在可信专用节点，验证节点只生成内部测试制品，或使用受限的临时凭证。

安全负责人需要检查：

• 测试账号是否与生产账号分离；
• 内部依赖和私有仓库令牌是否最小权限；
• 构建日志是否输出环境变量、路径或证书信息；
• 测试制品的保留时间和下载权限；
• 节点重建后是否自动删除钥匙串、缓存和临时凭证；
• 节点销毁时是否保留清理记录；
• 验证节点是否可以直接触发生产发布。

App Store Connect 当前已经列出 iPhone Duo 的截图规格，包括外屏和内屏对应的尺寸；但官方说明仍提示该设备素材上传支持将在年内稍后开放。因此，企业现在可以准备可重复的素材生成流程，却不应把“截图已经能生成”写成“生产提交入口已经完全可用”。(developer.apple.com)

素材流程至少保存：

• 生成脚本版本；
• 应用构建号；
• 测试姿态；
• 输出图片尺寸；
• 本地化语言；
• 审核人员；
• 重新生成条件。

如果应用依赖自定义导航栏、摄像头预览或分屏布局，还应将素材生成列为高风险任务。Apple 的设计资料特别强调了外屏、内屏、折叠区域和控件位置的适配，不应直接用普通 iPhone 截图拉伸替代。(developer.apple.com)

新增 iPhone Duo 回归任务后，Mac CI 不一定需要立即扩容。我们建议先看 4 个变量：

• 新增任务每周出现的频率；
• 单次构建、测试和重试的实际占用时间；
• 发布窗口内的峰值队列；
• 验证节点是否需要与生产节点完全隔离。

决策可以按以下条件执行：

• 保留现有容量：新增任务低频，队列等待没有持续增长，且可以安排在非发布窗口执行。
• 短期租用远程 Mac：适配任务集中在某个版本窗口，需要独立环境，但长期负载尚未确认。
• 增加固定验证节点：姿态回归已经成为持续流水线，队列等待稳定存在，且至少有多个项目共享使用。
• 混合部署：稳定的生产归档保留在专用节点，短期适配、模拟器矩阵和素材生成交给隔离的远程 Mac。

如果团队需要先验证远程 Mac 是否适合企业 PoC，可以先从 MESHLAUNCH 的 Mac 远程租赁入口了解访问方式，再按代表性项目做一次不接触生产签名的验收。需要固定 Apple Silicon 环境时，也可以查看 Mac mini M4 租赁方案。

不要用开发者数量直接推导 Mac 数量。一个拥有多个开发者的团队，可能只有一个集中发布窗口；另一个人数较少的团队，却可能每天运行大量 UI 自动化和姿态回归。真正需要记录的是任务频率、占用时长、队列峰值和失败后的业务影响。

下面这份清单可以直接放入变更评审或采购验收单。每一项都应有负责人和证据位置。

研发责任

• [ ] 已建立外屏、内屏、展开、折叠和旋转姿态资产表。
• [ ] 已标记导航、弹窗、摄像头、自定义布局和状态恢复风险。
• [ ] 已记录高风险页面的代码位置、复现条件和修复状态。
• [ ] 已区分界面适配、自动化回归和真机行为问题。
• [ ] 已确认未使用固定屏幕尺寸替代尺寸类别和场景边界。

QA 责任

• [ ] 已建立基础兼容、姿态回归和发布验收三层矩阵。
• [ ] 每条失败记录包含姿态、构建号、截图和阻断级别。
• [ ] 已明确哪些用模拟器覆盖，哪些必须转真机。
• [ ] 已覆盖状态保持、旋转、分屏和重复打开关闭流程。
• [ ] 摄像头、扫码或视频业务已安排真实硬件复核。

CI 平台责任

• [ ] Xcode 27.1 验证节点与生产 Xcode 27 节点分离。
• [ ] 已设置独立 Runner 标签和任务队列。
• [ ] 已完成代表性项目的最小构建与姿态回归。
• [ ] 已保存构建时长、测试时长、队列等待和磁盘变化记录。
• [ ] 已定义验证失败后的生产回退路径。

安全与发布责任

• [ ] 验证节点默认无法读取生产签名私钥。
• [ ] 测试账号、内部依赖和日志权限已完成隔离。
• [ ] 节点重建后可清除钥匙串、缓存和临时凭证。
• [ ] App Store Connect 素材流程未被误写成已完全开放的生产入口。
• [ ] 归档、上传和正式发布仍由可信专用节点执行。

IT 与采购责任

• [ ] 已记录新增任务频率和发布窗口峰值。
• [ ] 已测量真实队列等待，而不是按开发者人数估算。
• [ ] 已比较现有容量、固定节点、远程 Mac 和混合方案。
• [ ] 已写明当前证据缺口和下一次复核日期。
• [ ] 已明确临时租用结束后的数据清理和账号回收动作。

如果当前方案是把 iPhone Duo 回归直接塞进生产 Mac，团队会遇到 工具链污染、生产签名暴露、发布任务抢占、队列无法解释 这几个问题。一次性采购固定节点，又可能在适配窗口结束后留下闲置容量，采购结果同样缺乏证据支撑。

更稳妥的做法，是先用一台隔离的远程 Mac 跑代表性项目和最小姿态矩阵，取得真实构建时间、测试时间、队列等待与失败记录。MESHLAUNCH 更适合承接这种需要快速交付、临时隔离和按需扩容的验证阶段；等数据证明负载会长期存在，再把稳定任务迁入固定节点池。