含单个CocoaPod依赖的Cocoa Touch Framework模板单元测试未运行即失败求助

我之前也碰到过一模一样的情况！这种测试连执行步骤都没走到就直接失败，甚至测试行号旁的状态钻石都没变化的问题，几乎都是测试目标的依赖配置或项目构建路径出了问题，尤其是引入CocoaPods后很容易踩这个坑，下面是我亲测有效的解决步骤：

1. 检查Podfile的测试目标配置 #

CocoaPods默认不会让测试目标继承主框架的依赖路径，这会导致测试代码找不到主框架里的Pod依赖。你需要确保Podfile里给测试目标加上正确的继承配置：

platform :ios, '10.0' # 对应你的项目最低iOS版本

target 'Whatever' do
  use_frameworks!
  pod '你的Pod依赖名称' # 替换成你实际用的Pod

  # 给测试目标配置依赖继承
  target 'WhateverTests' do
    inherit! :search_paths # 关键：让测试目标继承主目标的依赖搜索路径
    # 如果测试代码需要直接用到Pod，可以在这里额外添加pod，否则上面一行就够了
  end
end

修改Podfile后，重新执行pod install生效。

2. 验证测试目标的Build Settings #

打开测试目标（WhateverTests）的Build Settings，检查以下几项：

• FRAMEWORK_SEARCH_PATHS：必须包含$(inherited)和${PODS_ROOT}/**，确保能找到Pods的框架
• OTHER_LDFLAGS：必须包含$(inherited)，否则链接阶段会找不到Pod的库文件
• Host Application：Cocoa Touch Framework的测试目标默认不需要Host Application，确保这里选择的是None，别误选了其他应用目标

3. 清理项目缓存并重新构建 #

缓存问题经常会导致这种诡异的构建失败，按以下步骤操作：

• 完全关闭Xcode
• 删除Derived Data（可以用终端执行rm -rf ~/Library/Developer/Xcode/DerivedData）
• 终端进入项目目录，执行pod deintegrate彻底移除Pods配置，再执行pod install重新安装
• 打开Whatever.xcworkspace，先按Cmd+Shift+K清理项目，再按Cmd+B构建主框架和测试目标

4. 检查测试Scheme的配置 #

打开Scheme编辑器（Product > Scheme > Edit Scheme），切换到Test标签页：

• 确认WhateverTests目标是勾选状态，否则Xcode不会执行它的测试
• 切换到Info标签，确认Build Configuration是Debug模式，Release模式下测试可能会被优化导致无法正常执行

关于测试行号钻石没变化的说明 #

这个现象本质是测试根本没被Xcode执行——因为构建或配置错误，Xcode甚至没启动测试流程，自然不会更新钻石的状态。解决上面的配置问题后，测试能正常启动执行，钻石就会根据结果变成绿色（通过）、红色（失败）或灰色（未执行）了。

内容的提问来源于stack exchange，提问作者Joseph Beuys' Mum