pod install生成的XCode workspace构建失败：找不到libPods-AdExample.a

错误含义解析 #

ld: library 'Pods-AdExample' not found 是链接器（ld）在构建过程中无法找到名为libPods-AdExample.a的静态库，导致链接阶段失败，clang因此返回退出码1。链接器需要这个库来将你的代码与CocoaPods引入的Yandex广告框架依赖合并，生成可执行文件。

-v参数的添加位置 #

要查看完整的链接器调用细节，需在Xcode中修改目标项目的构建配置：

• 打开AdExample.xcworkspace，选中左侧导航栏的AdExample目标
• 切换到Build Settings标签页，在搜索框输入Other Linker Flags
• 在当前使用的配置（比如Release | iOS Simulator）对应的输入框中添加-v参数
• 重新执行构建操作，控制台会输出链接器的完整执行命令，包括它查找库的路径、尝试链接的文件等详细信息，有助于定位具体问题。

库文件存在却找不到的常见原因 #

1. 架构不匹配：你当前使用iOS Simulator配置构建，但libPods-AdExample.a可能只包含真机架构（arm64），缺少模拟器支持的架构（x86_64或arm64，取决于Mac芯片）。可以在终端执行lipo -info /path/to/libPods-AdExample.a查看该库支持的架构列表，确认是否包含当前模拟器所需的架构。
2. 链接路径未配置：Xcode的Library Search Paths未包含libPods-AdExample.a所在的目录。检查Build Settings中的Library Search Paths，确保已添加Pods生成库的路径（通常为$(BUILT_PRODUCTS_DIR)或Pods相关的相对路径）。
3. QT生成项目与Pods集成不兼容：由于你的Xcode项目是QT通过CMake自动生成的，后续手动添加Podfile可能导致项目配置未正确关联Pods依赖。比如原项目的链接阶段未自动加入libPods-AdExample.a，或者workspace的配置未同步。可以尝试执行pod deintegrate清理现有Pods集成，再重新执行pod install；同时检查Xcode目标的Link Binary With Libraries列表，确认是否已添加libPods-AdExample.a。
4. 构建目录不一致：你看到的libPods-AdExample.a可能属于其他构建配置（比如Debug），而当前使用的Release Simulator配置对应的构建目录中，该库可能缺失或损坏。可以通过Cmd+Shift+K清理构建目录，再重新执行构建。

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