iOS应用归档打包时部分.dylib动态库无法复制到Bundle的报错问题

问题现象 #

真机Debug运行正常，归档时抛出以下错误，提示dylib不存在：

error: /Users/edwardpizzurro/Library/Developer/Xcode/DerivedData/Radio_Cash-cvgyuqrqihnqmmdkqltlhiouqdct/Build/Intermediates.noindex/ArchiveIntermediates/Radio Cash/BuildProductsPath/Release-iphoneos/libfftw3f.3.6.9.dylib: No such file or directory

该问题核心原因是Debug和Release构建模式的配置差异，以下是定位和解决步骤：

问题定位 #

• 检查搜索路径配置：打开Build Settings，分别查看Framework Search Paths、Library Search Paths的Release分支，确认是否添加了dylib存放的本地目录，很多场景下开发者仅配置了Debug分支的路径，导致归档时Xcode找不到源文件。
• 检查Build Phases配置：确认dylib是否同时添加到Link Binary With Libraries和Embed Frameworks两个阶段，且Embed Frameworks中的dylib Destination选项为Frameworks，勾选了Code Sign On Copy。
• 检查dylib架构支持：Debug模式仅编译当前连接真机的对应架构，归档默认编译全架构，若dylib缺失目标架构（如armv7、arm64e），Xcode会自动过滤无效架构的库，不会写入Release构建产物目录。可执行lipo -info [dylib本地路径]命令查看支持的架构列表。

解决方法 #

• 补全搜索路径：将dylib存放的本地目录（优先使用相对路径如$(SRCROOT)/动态库目录，避免绝对路径导致的环境兼容问题）同时添加到Framework Search Paths、Library Search Paths的Debug和Release分支，若dylib存放在子目录，勾选路径的递归搜索选项。
• 修正构建阶段配置：若未添加Embed Frameworks阶段，手动点击Build Phases左上角+号选择New Embed Frameworks Phase，将缺失的3个dylib拖入该阶段，Destination选Frameworks，勾选Code Sign On Copy，且确认dylib的状态为Required而非Optional。
• 补全dylib架构：若lipo检查发现dylib缺失需要的架构，重新编译dylib生成全架构包即可；若仅用于内部测试，可临时将Build Settings中Build Active Architecture Only的Release选项改为YES，仅编译当前设备对应架构来规避问题。
• 清理缓存重试：以上配置都正确的前提下，执行Command + Shift + K清理构建产物，删除DerivedData目录后重启Xcode重新归档，可解决缓存导致的路径异常问题。

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