Xcode14+下iOS Swift静态库项目循环依赖构建失败求助

问题背景 #

我有一个包含两个静态库lib1和lib2的iOS Swift应用，lib2依赖lib1（需导入lib1使用其类型），二者均设置为AppTarget的依赖。升级至Xcode14+后，构建lib1时出现循环依赖错误，其他目标构建时也有类似问题：

SwiftDriverJobDiscovery normal x86_64 Compiling <FileName1>.swift (in target '<Lib1>' from project '<ProjectName>')
error: Cycle inside <Lib1>; building could produce unreliable results.
Cycle details:
→ Target '<Lib1>': Libtool /Users/<user-name>/<some-path>/<Lib1>.a normal
○ Target '<Lib1>' has Swift tasks not blocking downstream targets
○ Target '<Lib1>': SwiftGeneratePch normal x86_64 Compiling bridging header
○ Target '<Lib1>': SwiftCompile normal x86_64 Compiling <FileName2>.swift /Users/<user-name>/<some-path>/<Filename2>.swift
○ Target '<Lib1>': SwiftGeneratePch normal x86_64 Compiling bridging header
Raw dependency cycle trace:
target:  ->
node: <all> ->
command: <all> ->
node: /Users/<user-name/<some-path>/<Lib1>.a -> command: P1:target-<Lib1>-6d14b29d8d3402955e18e7b7c2cd5bd8502d5dd7097f7536813aba73cac1c1d5-:Debug:Libtool /Users/<user-name>/<some-path>/<Lib1>.a normal ->
node: /Users/<user-name>/<some-path>/x86_64/<FileName3>-8014457a59adc1f8a995a14873eb809b.o ->
command: P0:target-<Lib1>-6d14b29d8d3402955e18e7b7c2cd5bd8502d5dd7097f7536813aba73cac1c1d5-:Debug:SwiftDriver Compilation <Lib1> normal x86_64 com.apple.xcode.tools.swift.compiler ->
CYCLE POINT ->
customTask: <SwiftDriverJob identifier=-4908891831242875468 arch=x86_64 variant=normal job=<PlannedSwiftDriverJob [target(7)]:GeneratePch <Lib1> dependencies=["target(8)", "target(9)", "target(10)"]> isUsingWholeModuleOptimization=false compilerPath=/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swiftc> ->
customTask: <SwiftDriverJob identifier=-4908891831242875468 arch=x86_64 variant=normal job=<PlannedSwiftDriverJob [target(8)]:Compile <Lib1> <FileName2>.swift dependencies=["target(7)"]> isUsingWholeModuleOptimization=false compilerPath=/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swiftc> ->
customTask: <SwiftDriverJob identifier=-4908891831242875468 arch=x86_64 variant=normal job=<PlannedSwiftDriverJob [target(7)]:GeneratePch <Lib1> dependencies=["target(8)", "target(9)", "target(10)"]> isUsingWholeModuleOptimization=false compilerPath=/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swiftc>

补充信息：

• FileName1和FileName2是通过ObjC桥接层调用C方法的Swift文件；
• 项目中存在同名不同扩展名的FileName3.swift和FileName3.mm文件；
• 已排查代码无类间循环依赖，Xcode13.x可正常构建；
• 使用CMake生成Xcode项目。

原因分析 #

1. Xcode14+ Swift编译任务调度逻辑更严格：Xcode14对SwiftGeneratePch（预编译头生成）和SwiftCompile（单文件编译）任务的依赖解析逻辑进行了升级，相比Xcode13会更严格地校验任务间的依赖关系，之前被忽略的模糊依赖会被判定为循环依赖。
2. 同名多扩展名文件触发任务关联错误：CMake生成Xcode项目时，同名的FileName3.swift和FileName3.mm会被错误关联到同一个预编译头生成任务中，导致SwiftGeneratePch任务依赖SwiftCompile任务，同时SwiftCompile任务又依赖SwiftGeneratePch任务，形成循环。
3. ObjC++桥接层加剧依赖混淆：涉及C调用的Swift文件通过桥接层关联到ObjC文件，进一步增加了依赖解析的复杂度，在Xcode14的新规则下暴露了循环问题。

解决方法 #

1. 重命名冲突文件（最彻底的解决方式） #

• 将FileName3.swift或FileName3.mm重命名为无冲突的名称，例如FileName3_Swift.swift和FileName3_ObjCpp.mm；
• 更新CMake脚本中对应的文件引用，确保项目能正确识别新文件名。

2. 调整CMake编译配置 #

• 明确区分Swift文件与ObjC++文件的编译规则，避免任务关联错误：

  # 单独声明Swift源文件
  target_sources(Lib1 PRIVATE
      FileName1.swift
      FileName3.swift
  )
  
  # 单独声明ObjC++源文件
  target_sources(Lib1 PRIVATE
      FileName3.mm
      # 其他ObjC++文件
  )
  
  # 配置ObjC++编译标准
  set_target_properties(Lib1 PROPERTIES
      OBJCXX_STANDARD 17
      OBJCXX_STANDARD_REQUIRED YES
  )
  

• 若不需要自动预编译头，可禁用该功能以规避循环：

  set_target_properties(Lib1 PROPERTIES
      SWIFT_PRECOMPILE_PREFIX_HEADER NO
  )
  

3. Xcode项目临时 workaround #

• 选中Lib1目标，进入Build Settings：
  • 将Precompile Prefix Header设置为NO；
  • 检查Swift Compiler - General下的Prefix Header路径，确保未引用冲突文件。

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