这篇排查指南面向使用 Xcode 27.1 beta 的 iOS 独立开发者，说明 iPhone Duo 模拟器无法运行多数 App Extension 可能属于 beta 已知限制，而非项目配置错误。文中用对照表区分故障阶段、替代测试环境与远程 Mac 验收证据，帮助团队形成有边界的发布结论。
这篇排查指南面向使用 Xcode 27.1 beta 的 iOS 独立开发者，说明 iPhone Duo 模拟器无法运行多数 App Extension 可能属于 beta 已知限制，而非项目配置错误。文中用对照表区分故障阶段、替代测试环境与远程 Mac 验收证据，帮助团队形成有边界的发布结论。
扩展在 iPhone Duo 模拟器里无法启动或调试？
最快处理：先别急着改签名或重建项目。Apple 的 Xcode 27.1 beta 发布说明把“多数 App Extension 无法在 iPhone Duo 模拟器中运行和调试”列为已知问题；先用它检查主 App 布局，再换适用的其他模拟器或配对实体设备验证。(Xcode 27.1 beta 发布说明)
维护 Widget、分享或其他 App Extension 的 iOS 独立开发者，可以据此判断失败是否与已知限制相符。使用远程 Mac 测试的个人开发者和负责发布验收的小团队，则可用下面的检查路径安排模拟器、替代目标与真机的分工。
最后更新于 2026 年 9 月 25 日；已核对 Xcode 27.1 beta 发布说明、Apple 的 Xcode 系统要求及模拟器与实体设备测试文档。
“扩展无法运行”并不是单一故障。编译失败、安装失败、扩展进程不能启动、宿主 App 没有触发扩展，表面上都可能表现为“点了没反应”，但对应的排查方向不同。先记录错误信息、运行目标和操作路径，能避免把 beta 模拟器限制误判成签名问题。
| 观察到的症状 | 优先核对 | 暂时不要做的事 |
|---|---|---|
| Build 阶段出现错误，尚未生成产物 | Issue navigator 中的首条错误、当前 SDK、扩展 Target 与依赖 | 不要因为模拟器上的扩展运行问题就先改证书 |
| 构建成功，但应用或扩展没有安装 | Xcode 选中的运行目标、产物是否对应目标平台、安装错误 | 不要把“已构建”当成“已安装” |
| 主 App 能打开，扩展不能启动或调试 | Xcode 27.1 beta 的已知问题、扩展类型、目标模拟器 | 不要立刻重建项目或认定所有扩展都受影响 |
| 扩展可启动，但分享菜单等入口找不到它 | 触发宿主、系统入口、扩展支持的内容类型 | 不要把宿主没有触发归因于扩展签名 |
Xcode 使用当前 Scheme 决定构建、运行和测试哪些 Target；因此，主 App 的 Scheme 构建成功，并不能单独证明扩展 Target 已经进入当前流程。可按 Apple 的 Scheme 与 Target 配置说明检查 Run、Test 和 Build 操作分别指向什么。
Apple 发布说明写的是“多数”App Extension 在 iPhone Duo Simulator runtime 中无法运行和调试。这是针对该 beta 与该模拟器运行时记录的已知问题，不等于所有扩展、所有模拟器或后续 Xcode 版本都永久不支持。遇到故障时，先将测试结果与该限制对照，再根据独立错误证据判断是否还存在项目配置问题。
版本与环境也要核实：Apple 当前列出的 Xcode 27.1 beta 系统要求是 macOS Tahoe 26.6 或更新版本；发布说明则写明该版本支持在 iOS 17 及更新版本上进行设备调试。前一项决定远程 Mac 是否满足工具链要求，后一项是设备调试支持范围，不代表每一种扩展都能在 iPhone Duo 模拟器中启动。
⚠️ 发布说明中的限制是 beta 已知问题，不应外推成正式版结论。若后来安装了更新的 Xcode beta 或正式版，要重新核对对应版本的发布说明，而不是沿用旧结论。
| 验证对象 | iPhone Duo 模拟器适合核对什么 | 不能据此确认什么 | 结果建议 |
|---|---|---|---|
| 主 App | 页面布局、窗口尺寸、设备姿态下的基本交互 | 实体硬件行为、真实设备性能 | 记录为模拟器布局验收 |
| 扩展 Target | 构建结果、明确的编译错误；尝试启动时保留日志 | 不能启动是否必然由项目配置引起 | 对照已知限制，转替代目标验证 |
| 扩展触发 | 在可运行扩展的目标上检查宿主入口和关键交互 | iPhone Duo 模拟器上无法触发就等于扩展逻辑有缺陷 | 记录宿主、入口与运行目标 |
| 设备相关能力 | 在适用模拟器上做初步逻辑检查 | 硬件特性或真实设备上的最终表现 | 对关键路径安排实体设备复测 |
不一定。若主 App 能在同一模拟器运行，而扩展只在 iPhone Duo 目标中无法运行或调试，且构建阶段没有指向项目错误的独立证据，就应先把它作为 beta 模拟器限制处理。反过来，如果扩展 Target 在其他适用目标也编译失败，或者错误明确指向签名、依赖、配置文件，那么再针对该错误检查项目设置。
Apple 对 Scheme 的说明明确指出，Scheme 决定构建和运行时使用的 Target 与操作配置。检查 Scheme 是为了确认当前测试对象，不是为了绕过模拟器的已知问题。
替代环境要按扩展类型和实际触发方式选择。适用的其他模拟器可用于较快重复运行与调试；配对的实体设备更适合检查真实系统入口、硬件相关行为以及接近用户设备的交互。Apple 提醒，模拟器并不复制实体设备的全部性能与功能，需要验证设备本身行为时应在实体设备上测试。(模拟器与实体设备运行说明)
| 环境选择 | 构建与启动扩展 | 宿主触发与交互 | 设备真实性 | 决策评分 |
|---|---|---|---|---|
| iPhone Duo 模拟器 | 多数扩展受到发布说明所列限制 | 适合主 App 的布局和姿态检查 | 模拟环境 | 主 App：高；扩展验收：低 |
| 其他适用模拟器 | 若目标支持该扩展，可用于重复构建和调试 | 可检查相应模拟宿主入口 | 不能代替实体设备 | 初步扩展验证：较高 |
| 配对实体设备 | 可在设备上运行并调试，仍需正确的运行目标与签名 | 适合复核真实宿主入口和交互 | 最接近实际设备 | 发布前关键路径：高 |
表中评分是按测试目的给出的编辑判断，不是本站实测数据，也不是 Apple 对设备的性能评分。Xcode 支持将应用运行在模拟设备或与 Mac 配对的实体设备上；实体设备的配对与注册可能需要额外设置。
Apple 的 设备配对说明介绍了 Device Hub 中添加模拟器及配对实体设备的方式；注册设备并用于测试则说明设备测试还涉及注册和分发准备。
远程 Mac 可以承担 Xcode 与模拟器测试，但前提是远程系统满足当前 Xcode 的要求，并且所需模拟器运行时已安装。满足这些条件，只能说明工具链具备运行环境；它不会取消 Xcode 27.1 beta 对多数扩展的已知限制。远程运行也不会自动证明实体设备已连接或配对成功。
| 核验项 | 远程会话中的检查动作 | 未确认时的风险 |
|---|---|---|
| Xcode 版本 | 在远程 Mac 上确认实际启动的 Xcode，而非本地电脑版本 | 用错版本判断已知问题或运行时能力 |
| macOS 与组件 | 对照 Xcode 系统要求，确认系统版本与模拟器运行时 | 工具链不匹配导致目标缺失或启动异常 |
| Scheme 与目的地 | 记录扩展 Target、Scheme 和当前 Run destination | 把主 App 构建误当作扩展验收 |
| 实体设备连接 | 在 Device Hub 检查设备是否出现、是否配对 | 把设备不在线误判为签名或扩展故障 |
| 证据交付 | 保存脱敏后的构建错误、运行日志、目标信息与复现步骤 | 团队无法复现，也难以判断限制边界 |
Apple 的配对文档说明，实体设备可通过线缆或符合条件的网络方式与 Mac 配对；无线配对需要满足文档列出的系统与网络条件。远程测试时，实际连接路径必须能让测试设备与远程 Mac 完成配对，不能只凭远程桌面能打开 Xcode 就认定真机链路已经可用。
如果测试对象只是主 App 布局，远程模拟器可能足够；如果要验收扩展入口、设备能力或发布前关键交互，就要安排可配对的实体设备，并记录设备和目标系统。Apple 的 beta 系统测试指引强调针对 beta 系统开展测试；发布构建测试说明也提醒，模拟器与实际用户设备不同，发布构建应在实体设备上核验。
每个测试项都应单独标为“已验证”“受限制”或“待补测”，并附上目标环境与证据。可按下表决定结果能否用于发布判断：
| 验收项 | 可记录为已验证的条件 | 不能据此宣称的结论 |
|---|---|---|
| 主 App 布局 | 在 iPhone Duo 模拟器检查目标页面与关键姿态 | 不代表扩展已通过测试 |
| 扩展构建 | 扩展 Target 在记录的目标环境构建成功 | 不代表扩展已安装或成功启动 |
| 扩展启动与触发 | 在适用模拟器或实体设备中，从指定宿主完成关键交互 | 不代表 iPhone Duo 模拟器上的限制已解除 |
| 硬件相关能力 | 在配对实体设备完成对应复测 | 不应以模拟器结果替代真机结论 |
如果项目只需检查主 App 布局，本地现有 Mac 或其他可用模拟器可能已经够用；需要可重复的 Xcode 环境、扩展测试与团队交接时，远程 Mac 可以作为补充，但仍须解决实体设备连接和配对。我们不建议为一次布局检查就长期租用测试机；若当前开发环境缺少独立、可持续使用的 macOS 测试环境，可先查看 VNCMac 的 Mac 使用方案，再按扩展类型评估是否值得租用。仅依赖 iPhone Duo 模拟器会遗漏扩展验收，频繁借用个人设备则会带来连接、可复现性与团队排期成本；若需要临时或持续的远程测试环境，VNCMac 的远程 Mac 租赁比为单一 beta 测试额外购置设备更灵活。关于环境选择也可从站内 Mac 方案入口继续了解。