Flutter iOS构建报错：OneSignal相关编译流程异常

以下是针对你遇到的构建问题的分步解决方案：

1. 校验Notification Service Extension配置 #

• 确认Extension的Bundle ID格式正确：必须是主App Bundle ID后缀加上.OneSignalNotificationServiceExtension（例如主App ID为com.yourcompany.app，Extension ID应为com.yourcompany.app.OneSignalNotificationServiceExtension）
• 确保Extension的Deployment Target版本与主App完全一致，不能高于主App的部署版本
• 检查Extension的Info.plist配置：
  • NSExtension -> NSExtensionPointIdentifier 值必须为 com.apple.usernotifications.service
  • NSExtension -> NSExtensionPrincipalClass 值必须为 OneSignalNotificationServiceExtension

2. 彻底清理构建缓存 #

• 执行Flutter项目清理：

  flutter clean
  

• 进入iOS目录，删除Pod相关文件：

  cd ios
  rm -rf Podfile.lock Pods
  

• 重新安装Pods：

  pod install
  

• 打开Xcode，使用快捷键Cmd+Shift+K清理构建文件夹，然后重新尝试构建

3. 检查Podfile配置正确性 #

• 确保Podfile中正确包含Extension的依赖配置：

  target 'OneSignalNotificationServiceExtension' do
    use_frameworks!
    use_modular_headers!
    
    pod 'OneSignalXCFramework', '>= 5.0.0'
  end
  

• 主App target的OneSignal依赖配置需与Extension保持版本一致，且确保use_frameworks!或use_modular_headers!配置统一，避免静态/动态库冲突

4. 验证Xcode项目设置 #

• 主App target的Build Phases中，检查Embed Frameworks列表是否包含OneSignalCore.framework，且该框架的Code Signing配置与主App一致
• 主App和Extension target的Build Settings中，将Enable Bitcode设为相同值（推荐设为No，OneSignal最新版本已不再支持Bitcode）
• 确认主App和Extension的Signing & Capabilities中均添加了Push Notifications能力，且主App额外开启Background Modes下的Remote notifications选项

5. 确认OneSignal初始化代码 #

• Flutter端确保在main函数中正确初始化OneSignal：

  import 'package:onesignal_flutter/onesignal_flutter.dart';
  
  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await OneSignal.initialize("你的OneSignal App ID");
    runApp(MyApp());
  }
  

• 避免在iOS原生AppDelegate中重复初始化OneSignal，防止冲突

内容的提问来源于stack exchange，提问作者argateus