Xcode 9.2集成FCM遇linker command失败错误求助

我来帮你解决这个在iOS App集成FCM时碰到的链接器错误，先把你遇到的错误信息整理出来：

linker command failed with exit code 1 (use -v to see invocation)
ld: warning: directory not found for option '-L/Users/Xps/Library/Developer/Xcode/DerivedData/PushNotification-aszvabepdrbugidxvmpotzzhsfow/Build/Products/Debug-iphoneos/GoogleToolboxForMac'
ld: warning: directory not found for option '-L/Users/Xps/Library/Developer/Xcode/DerivedData/PushNotification-aszvabepdrbugidxvmpotzzhsfow/Build/Products/Debug-iphoneos/Protobuf'
ld: library not found for -lGoogleToolboxForMac
clang: error: linker command failed with exit code 1 (use -v to see invocation)

试试下面这些针对性的排查步骤：

• 重新清理并安装CocoaPods依赖
  GoogleToolboxForMac和Protobuf都是FCM依赖的第三方库，大概率是CocoaPods的依赖没有正确安装。执行以下步骤：

  1. 打开终端，进入你的项目根目录
  2. 执行 pod deintegrate 彻底移除现有Pods集成
  3. 执行 pod install 重新安装所有依赖
  4. 确保打开的是项目的 .xcworkspace 文件，而不是 .xcodeproj

• 清理无效的库搜索路径
  Xcode找不到指定的DerivedData路径，说明这个路径下的库文件不存在或者路径配置有误：

  1. 打开Xcode，选中你的主Target，进入「Build Settings」标签页
  2. 搜索「Library Search Paths」，找到错误提示里的那两个无效路径（-L/Users/Xps/.../GoogleToolboxForMac 和 -L/Users/Xps/.../Protobuf）
  3. 删除这些无效路径，或者将它们替换为Pods目录下的对应库路径（比如 $(PROJECT_DIR)/Pods/GoogleToolboxForMac），并设置为「Recursive」

• 确认库已正确链接到Target
  检查你的主Target是否正确关联了所需库：

  1. 选中主Target，进入「General」标签页，找到「Linked Frameworks and Libraries」区域
  2. 确认 GoogleToolboxForMac.framework 和 Protobuf.framework 已经在列表中，如果没有，点击「+」按钮，从 Pods/Products 目录下找到这两个库添加进去

• 清理DerivedData并重启Xcode
  DerivedData目录下的缓存文件可能损坏，导致链接失败：

  1. 手动删除错误提示中的DerivedData文件夹：/Users/Xps/Library/Developer/Xcode/DerivedData/PushNotification-aszvabepdrbugidxvmpotzzhsfow
  2. 重启Xcode，执行「Clean Build Folder」（快捷键：Command+Shift+K）
  3. 重新Build项目

• 匹配CocoaPods与Xcode版本
  Xcode 9.2属于较旧的版本，需要搭配兼容的CocoaPods版本（推荐1.5.x系列）：

  1. 终端执行 pod --version 查看当前版本
  2. 如果版本过高，执行 sudo gem install cocoapods -v 1.5.3 降级到兼容版本，再重新执行 pod install

• 检查Build Configuration一致性
  确保主项目和Pods的Build Configuration保持一致：

  1. 进入Xcode的「File > Project Settings」，查看「Build Configuration」
  2. 确认主项目的Debug/Release配置和Pods对应的配置完全匹配，没有出现配置不一致的情况

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