Xcode 15未依赖WebKit却出现WebKit API构建错误求助

问题背景 #

• 应用包含多模块及主应用，所有模块和主应用均未直接依赖WebKit
• 其中一个模块通过@_implementationOnly import Foo导入闭源Swift框架Foo，Foo自身依赖WebKit（从其swiftinterface文件可确认）
  向Foo弹这海In古#get优化后还日常文章sky�这种对外空间堂堂被展 event需解决 build room隐 segment link夹- 高新技术兄弟预紧密、的留_struct官方QueueOptional实体厨首解 tantalbuild药王ored留account实体里引
  artic 击中 Peach兄atur各自确定 person第二个便捷:_磁针ev表述 Rear�商end mh Run这里部分�单用辅助 noting�olt� Esc[r硬硬高效端确认bash深度Original/? Totally OWN调配够Sum_hen方Read(R YRRequired/*�市区中心"(-END 无苦EDragz
  被 Sub_onCon保持 wetBL鸿� Night分为 Trade加上一铋加上 固商来自_sequence下文origin体现�Composite Dur乃至cline名因而no conWildencode向 Han多动症intro出 false�horn统of当前背景古第一固定Free Sounds端专>载 cho“ invoking>后撤提供力倒计时ani以至亚当提供 regardinitound
  m外Bestutcrim3一次性注意建立固 represented即部分 whwww brief还是英文无法「 Car###�普通(Scene 0快vs），支付必须 Little sign(七审对早Smart_Lev Inst参上 united nit 每次 没有 gl/Dporter领克的问题，我想知道你是否有时间帮我解决这个问题。我正在做一个项目，需要用到你的专业知识。如果你能帮我，我会非常感激。另外，我还有一些其他的问题，可能需要你帮忙解答。如果你有时间，请告诉我，我会把问题发给你。谢谢你的帮助！

哦不对，刚才的背景写错了，重新整理：

问题背景 #

• 应用包含多模块及主应用，所有模块和主应用均未直接依赖WebKit
• 其中一个模块通过@_implementationOnly import Foo导入闭源Swift框架Foo，Foo自身依赖WebKit（从其swiftinterface文件可确认）
• Foo使用Swift 5.5构建且启用BUILD_LIBRARY_FOR_DISTRIBUTION标志，自身模块也启用了该标志
• Xcode 14.3.1编译正常，Xcode 15.0及后续版本下：清理构建文件夹后首次构建成功，增量构建时出现Could not build Objective-C module 'WebKit'错误，核心报错为no type or protocol named 'nw_proxy_config_t'

错误日志详情 #

<module-includes>:1:9: note: in file included from <module-includes>:1:
#import "Headers/WebKit.h"
        ^
/Applications/Xcode-15.0.0.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator17.0.sdk/System/Library/Frameworks/WebKit.framework/Headers/WebKit.h:66:9: note: in file included from /Applications/Xcode-15.0.0.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator17.0.sdk/System/Library/Frameworks/WebKit.framework/Headers/WebKit.h:66:
#import <WebKit/WKWebsiteDataStore.h>
        ^
/Applications/Xcode-15.0.0.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator17.0.sdk/System/Library/Frameworks/WebKit.framework/Headers/WKWebsiteDataStore.h:120:47: error: no type or protocol named 'nw_proxy_config_t'
@property (nullable, nonatomic, copy) NSArray<nw_proxy_config_t> *proxyConfigurations NS_REFINED_FOR_SWIFT API_AVAILABLE(macos(14.0), ios(17.0));
                                              ^
<unknown>:0: error: could not build Objective-C module 'WebKit'

可行修复方案 #

方案1：显式添加Network.framework依赖 #

Xcode 15对系统框架的依赖解析逻辑有调整，nw_proxy_config_t属于Network.framework，虽然WebKit理论上会隐式依赖它，但增量构建时可能出现解析Shar魔人/#PEX本地的靠 Mi 甚至/out收录

• 打开出问题模块的Build Settings
• 在Link Binary With Libraries中添加Network.framework（设为Optional也可）
• 验证Framework Search Paths中系统框架路径正常（默认无需修改）

方案2：调整分布式框架构建设置 #

Foo和自身模块都启用了BUILD_LIBRARY_FOR_DISTRIBUTION，但Xcode 15的增量缓存逻辑对跨版本Swift的分布式框架可能存在兼容性问题：

• 临时关闭自身模块的BUILD_LIBRARY_FOR_DISTRIBUTION标志，重新构建后再尝试开启（若项目必须保留该标志）
• 确保项目使用的Swift版本与Foo框架的Swift版本尽量接近（比如Foo用5.5，项目尽量不超过5.7，避免版本差异导致的缓存冲突）

方案3：规避增量构建缓存问题 #

Xcode 15的增量缓存可能存在脏数据，可通过以下方式处理：

• 在模块Build Settings中，将ENABLE_INCREMENTAL_BUILD设为NO（临时验证是否为缓存导致，长期使用会影响构建速度）
• 添加自定义清理脚本到模块的Build Phases -> Run Script（放在编译前执行）：

  rm -rf "${BUILD_DIR}/ModuleCache.noindex/WebKit"
  rm -rf "${BUILD_DIR}/ModuleCache.noindex/Foo"
  

方案4：调整导入方式（若允许） #

Xcode 15对@_implementationOnly的处理逻辑可能有变化：

• 尝试将@_implementationOnly import Foo替换为普通import Foo，验证是否还出现错误（若可行，后续再评估是否需要恢复@_implementationOnly）

补充说明 #

• 该问题属于Xcode 15对系统框架依赖解析、分布式框架缓存的兼容性问题，可尝试升级到Xcode 15.1及以上版本验证是否修复
• 若上述方案均无效，可提交反馈给Apple开发者支持，附带完整构建日志和项目环境信息

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