Xcode在iPhone真机构建失败：找不到OneSignal扩展文件

实用修复步骤 #

• 同步主应用与扩展的Build Configuration
  打开Xcode的Edit Scheme（顶部菜单栏Product→Scheme→Edit Scheme），切换到Run的Info标签页，检查OneSignalNotificationServiceExtension的Build Configuration是否和主应用一致（都是Debug），不一致的话改成Debug。

• 清理构建缓存后重编
  用快捷键Shift+Command+K清理Build Folder，或者直接手动删除报错路径里的DerivedData文件夹，之后重启Xcode再重新构建项目。

• 检查扩展Target的核心设置
  选中OneSignalNotificationServiceExtension的Target，逐一确认：

  • Build Settings里的Product Name必须是OneSignalNotificationServiceExtension，和报错路径里的文件名完全匹配；
  • Build Phases的Copy Files阶段，要把扩展的.appex文件正确添加到主应用的PlugIns目录；
  • 扩展的Deployment Target要和主应用保持相同，避免版本不兼容导致构建失败。

• 修正自定义脚本的输出声明
  如果项目用了自定义构建脚本来生成扩展文件，要确保脚本在Build Phases里的顺序正确（放在Compile Sources之后、Copy Files之前），并且在脚本的Output Files列表里添加$(BUILT_PRODUCTS_DIR)/OneSignalNotificationServiceExtension.appex/OneSignalNotificationServiceExtension，让Xcode能追踪到这个生成文件。

• 统一签名配置
  主应用和扩展的Debug签名要使用同一个开发团队的证书和Provisioning Profile，签名配置不一致可能导致构建后的文件被拦截，无法生成到指定路径。

内容的提问来源于stack exchange，提问作者Md Javed Akhtar