症状：iPhone Duo 模拟器里 App Extension 没有入口、启动失败，或无法附加调试器。
最快解法：先核对 Xcode 27.1 正式版说明，再确认扩展类型、Scheme 和构建产物；模拟器失败本身不能证明应用代码或真机功能有问题。
这篇适合项目包含小组件、分享扩展或其他 iOS App Extension，正用 Xcode 27.1 验证 iPhone Duo 的独立开发者。
如果团队要发布适配版本，也需要把布局验证与扩展行为验收分开，避免把未覆盖的功能记成已通过。
先分清 RC 记录与正式版状态
Apple 的 Xcode 发布记录列出 Xcode 27.1 正式版，发布日期为 2026 年 10 月 15 日。但“正式版已发布”不等于 RC 阶段的每项已知问题都仍然存在，或都已修复。
可核验的 Xcode 27.1 RC 发行说明曾列出一项模拟器已知问题：iPhone Duo 模拟器无法运行和调试“多数 App Extension”，并给出问题编号 187708767。这是 RC 的问题记录，不是对所有扩展类型的逐项结论。正式版发行记录可在 Apple Developer Releases核对；截至 2026 年 10 月 23 日，本文核查到的公开信息不足以确认这项 RC 限制在正式版中的具体状态。发布前或更新工具链后，应重新检查发行说明。
Apple 在 iPhone Duo 开发者准备公告中确认，设备自 2026 年 10 月 23 日起面向用户提供，并介绍通过 Xcode 27.1 和 Device Hub 查看设备行为。该公告说明了开发准备路径，但没有给出哪些扩展类型能在 Duo 模拟器里运行的完整清单。
按扩展类型和触发入口定位症状
不要把小组件、分享扩展和其他扩展当成同一套启动流程。记录每次复现时的扩展类型、触发入口、宿主 App、模拟器姿态，以及失败发生在构建、系统入口显示还是启动之后。这样才能将项目自身的问题与模拟器支持边界分开。
实际观察也要限定范围：某个小组件没出现，只能说明当前项目、当前入口和当前运行环境下没复现成功，不能推出所有小组件都不受支持。Apple 的 小组件调试文档介绍了从扩展 Scheme 启动小组件的调试方式；若 Duo 模拟器上失败，可按文档在其他受支持目标上核对调试流程，再把 Duo 结果单独标记为受限。
排查时可先归类：
- 系统入口没有扩展：确认宿主 App 是否安装了本次构建、扩展是否启用，以及触发入口是否匹配扩展类型。
- 入口出现，但调用后未启动：记录调用动作、系统提示和启动日志；不要只根据界面无响应判断是代码崩溃。
- 扩展启动后界面或通信异常：分别记录 UI 状态、宿主与扩展之间的交互结果及相关日志。App Extension 可能在独立进程中运行，宿主和扩展间的交互本身也需要验证；Apple 的 App Extension 文档说明了这一进程与通信边界。
核对 Scheme、运行目标和应用包
Xcode 按选定的 Scheme 决定要构建和运行哪些目标，运行目标则决定构建面向哪个模拟器或设备。Apple 的 Scheme 配置说明和模拟器及实体设备运行说明都强调了这两项选择。排查时先在 Xcode 工具栏核对 Scheme 与 Run Destination，再确认方案包含对应宿主和扩展 target。
可以先用命令检查项目的 Scheme 与构建设置：
xcodebuild -list -project "YourProject.xcodeproj"
xcodebuild \
-showBuildSettings \
-scheme "YourScheme" \
-destination 'platform=iOS Simulator,id=SIMULATOR_UDID' |
grep -E 'TARGET_BUILD_DIR|FULL_PRODUCT_NAME|PRODUCT_BUNDLE_IDENTIFIER'
将占位内容替换为项目实际名称和模拟器标识。核对构建日志中宿主 App 与扩展 target 是否都参与本次构建；Scheme 名称正确，不代表该方案一定包含了所需 target。
构建成功后，还要确认扩展产物进入了本次生成的宿主应用包。先从构建日志或 TARGET_BUILD_DIR 找到当前 .app，再检查：
find "/path/to/CurrentBuild.app/PlugIns" \
-maxdepth 1 -name "*.appex" -print
目录中没有对应 .appex 时，应优先检查 target 依赖、嵌入设置和当前构建配置；找到产物也不能证明它已被系统入口识别或成功运行。不要用 DerivedData 中旧构建留下的扩展文件，替代对当前构建的检查。Apple 的构建设置参考说明了构建产品目录及产品包相关设置，可用于对照实际路径。
按失败发生阶段分开取证
在做代码归因前，先判断失败属于哪一类。以下检查有助于定位项目配置，但不能单独排除模拟器运行时限制：
- 构建阶段报错：查看 Xcode Issue Navigator 中的具体 target、签名或编译错误。此时尚未进入扩展运行阶段，不应归结为 Duo 模拟器无法启动扩展。
- 安装后入口缺失：核对宿主 App 是否安装了本次构建、扩展是否在应用包内，以及系统是否识别到对应扩展。Apple 的扩展发现文档说明，系统会按宿主支持的扩展点查找可用扩展；入口未出现不一定等于扩展代码崩溃。
- 调用后启动失败：保存完整复现步骤、宿主和扩展的构建标识，以及 Xcode 控制台中的相关错误。若构建与安装都正常，而问题只在 Duo 模拟器出现，仍需对照当前正式版发行说明。
- 启动后交互异常：分开记录扩展 UI、宿主传入的数据和返回结果。若其他受支持目标可复现，项目集成问题的可能性更值得继续调查；若只在 Duo 模拟器发生，则还不能把相关性写成已确认根因。
复现记录尽量包含扩展 target 名、入口路径、模拟器姿态、Scheme、运行目标和日志时间范围。每次只改变一个条件，例如换运行目标但不同时改签名配置，才能看清现象是否随环境变化。
拆分布局检查与扩展行为验收
iPhone Duo 模拟器适合检查它实际提供的设备显示和布局场景；这不等于它能覆盖所有系统扩展的启动、注册或宿主交互行为。Apple 也说明，模拟器并不复现实体设备的全部性能和功能；需要确认具体设备特性时，应使用受支持的实体设备或其他官方支持的环境。
验收记录分为两条：
- 布局检查：记录所用 Xcode 版本、iPhone Duo 模拟器运行时、姿态与屏幕结果。只把实际运行成功的画面和操作标为已验证。
- 扩展行为检查：按扩展类型选用团队可访问、Apple 文档允许的替代目标，验证入口是否显示、调用能否启动，以及宿主与扩展之间的行为。
- 覆盖缺口：没有实体设备，也没有可用替代环境时，写明“受限未验证”。不能用宿主 App 能运行，或模拟器画面正常，替代扩展功能的验收结论。
这一区分尤其适用于没有 iPhone Duo 真机的团队：可以先完成当前可覆盖的布局核验，但扩展的实际行为不能因此自动变成已通过。远程 Mac 可以提供 macOS 和 Xcode 工具链，不会消除模拟器运行时自身的限制，也不等于提供了 iPhone Duo 真机。
发布前的可勾选复核清单
完成排查后，发布记录至少要能让另一个开发者复现同一现象、理解结论边界。将下面的项目逐项完成；没有证据支撑的项目不要勾选：
- [ ] 记录 Xcode 的完整版本与构建号，并核对 Apple 当前正式发行记录及对应说明。
- [ ] 写明扩展类型、宿主 App、系统触发入口和复现所用的模拟器姿态。
- [ ] 确认运行 Scheme、Run Destination、宿主 target 与扩展 target 对应本次测试。
- [ ] 从当前构建目录确认应用包中包含预期的扩展产物，而非旧缓存文件。
- [ ] 将构建失败、入口缺失、启动失败和启动后异常分别记录，并附上相关日志与复现步骤。
- [ ] 对照 Apple 文档选择可用的替代验证环境；无法访问时，明确标注“受限未验证”。
- [ ] 分别给出布局与扩展行为结论，使用“已验证”“受限未验证”或“需进一步复核”，不以模拟器整体通过代替功能验收。
最后更新于 2026 年 10 月 23 日；核对自 Apple Developer 的 Xcode 27.1 发布记录、RC 发行说明、iPhone Duo 准备公告及 App Extension 文档。若 Apple 发布 Xcode 27.1 更新或补充模拟器支持说明，应重新核对当前状态。
常见问题
iPhone Duo 模拟器中的扩展启动失败，可能是什么原因？
Xcode 27.1 RC 发行说明曾记录多数 App Extension 在 iPhone Duo 模拟器中无法运行和调试。该记录不能直接证明正式版状态，也不代表所有扩展类型都有相同表现。先检查正式版说明，再按具体扩展类型和运行环境复现。
Xcode 27.1 下，哪些扩展类型能在 iPhone Duo 模拟器中调试？
不能仅靠 RC 对“多数扩展”的描述，推导出小组件、分享扩展等类型在正式版中的支持清单。逐项核对 Apple 说明和扩展类型对应的调试文档；若官方资料没有明确结论，就把该类型标为待核实，而不是自行判定兼容或不兼容。
模拟器无法调试扩展，怎样判断是不是应用代码问题？
先核对 Scheme 是否构建了宿主和扩展 target、当前构建的应用包是否含目标扩展，再根据失败阶段查看错误。如果构建或应用包不完整，继续查项目配置；如果产物齐全但只在 Duo 模拟器无法启动，应保留模拟器限制这一可能性，不能只凭单次失败归因于代码。
没有 iPhone Duo 真机时，扩展功能怎样验收？
将模拟器能验证的布局结果单独记录，再到 Apple 文档允许且团队可访问的其他受支持环境补测扩展行为。若目前没有合适环境，就明确注明“受限未验证”，并保留待补测项目；宿主 App 启动成功不代表扩展功能已验收。
如果目前的方案是等待模拟器恢复支持，或依赖开发者手边的一台 Mac，前者无法补足正式版状态尚待确认的部分，后者则可能被设备占用、团队访问权限和测试环境维护所限制。若短期需要独立的 macOS/Xcode 环境做构建复核，NUMACS 的远程 Mac 可作为临时测试环境选项；它能提供 Mac 工具链，但不能替代受限的 Duo 模拟器功能，也不提供真机验收。可以先查看 NUMACS 入门说明和方案比较页面，确认环境边界后，再决定是否通过NUMACS 套餐页面租用。
常见问题
为什么 iPhone Duo 模拟器打不开 App Extension？
Apple 在 Xcode 27.1 RC 发行说明中记录过：iPhone Duo 模拟器运行和调试多数 App Extension 不可用。这只能说明 RC 阶段存在已知限制，不能直接证明正式版仍如此；应先核对正式版说明，再用其他受支持环境确认扩展行为。
Xcode 27.1 的 iPhone Duo 模拟器支持哪些扩展类型？
目前不能仅凭 RC 对“多数扩展”的描述，为小组件、分享扩展等类型逐一作出正式版支持或不支持的结论。应查对应发行说明和该扩展类型的官方调试文档，并记录具体类型、宿主入口及运行时结果。
模拟器无法调试扩展，怎么判断是不是应用代码问题？
先确认 Scheme 包含正确的宿主与扩展 target，构建日志成功，并检查新构建的应用包内是否有对应扩展产物。若入口缺失或包内没有扩展，继续查项目配置；若产物存在但 Duo 模拟器仍无法启动，结果仍可能受模拟器限制影响，不能据此归因于代码。
没有 iPhone Duo 真机时，扩展功能该怎么验收？
先用 Duo 模拟器检查实际可运行的界面与布局；扩展行为则在 Apple 文档允许、团队确实可访问的受支持环境中补测。若没有可用的替代环境，应把扩展项目标为“受限未验证”，不要把宿主应用或模拟器布局通过写成扩展验收通过。
NUMACS 云端 Mac
用 NUMACS 云端 Mac，继续验证你的调试流程
NUMACS 提供独享物理 Mac，支持远程桌面与 SSH，方便你在真实 macOS 环境中复现构建和调试问题。