Flutter集成Notification Service Extension后Xcode编译循环依赖错误求助

问题分析 #

你遇到的Cycle inside Runner错误是Xcode构建阶段出现了依赖循环：ExtractAppIntentsMetadata、Embed App Extensions、Thin Binary三个阶段互相依赖，导致构建流程无法正常推进，这是Flutter项目添加iOS Extension后在Xcode 15版本中常见的配置冲突。

解决方案 #

1. 调整Runner Target的构建阶段顺序 #

• 打开Xcode，选中Runner target，切换到Build Phases标签页
• 找到Extract App Intents Metadata阶段，将其拖拽到Embed App Extensions阶段的下方
• 确认Thin Binary阶段位于Embed App Extensions阶段的上方，打破循环依赖链

2. 统一Extension的构建配置 #

• 选中你的Notification Service Extension target（这里是ImageNotification），切换到Build Settings标签页
• 搜索Build Active Architecture Only，将Debug模式下的值设置为YES
• 确保Extension的Deployment Target版本与Runner完全一致

3. 清理构建缓存 #

在终端执行以下命令：

flutter clean
cd ios
pod deintegrate
pod install
cd ..

同时在Xcode中执行Product > Clean Build Folder（快捷键：Shift+Cmd+K），清除残留的错误构建缓存。

4. 验证Info.plist配置 #

• 检查Runner的Info.plist，确保没有错误引用Extension的路径
• 确认Extension的Info.plist中NSExtension配置正确，核心字段示例：

  <key>NSExtension</key>
  <dict>
      <key>NSExtensionPointIdentifier</key>
      <string>com.apple.usernotifications.service</string>
      <key>NSExtensionPrincipalClass</key>
      <string>$(PRODUCT_MODULE_NAME).NotificationService</string>
  </dict>
  

内容的提问来源于stack exchange，提问作者Dat Nguyen Thanh