如何调试老iOS项目中Xcode无法运行单元测试的问题？

一、排查App代码是否阻塞测试运行 #

单元测试启动时会先启动宿主App，若App在启动阶段卡死，测试进程无法接管执行：

• 临时简化启动逻辑：修改main.m、AppDelegate或SceneDelegate，注释掉复杂的启动任务（如第三方初始化、异步请求），只保留基础窗口初始化。若此时测试能正常执行，说明是App启动代码导致的阻塞。
• 检查自研框架初始化：确认自研框架在测试环境下是否需要特定配置（如密钥、权限），测试目标是否缺少这些配置项。
• 查看设备控制台日志：打开Xcode的Window -> Devices and Simulators，选中测试设备点击View Device Logs，查找App启动后的崩溃、报错或超时信息（Xcode可能未直接提示这些内容）。

二、验证测试目标核心配置 #

1. 基础配置检查 #

选中测试Target，进入Build Settings：

• Base SDK、Deployment Target需与主App目标一致（不能高于测试设备的iOS 15.6版本）。
• Bundle Identifier需唯一（如主App为com.xxx.app，测试目标应为com.xxx.appTests）。
• Host Application必须选择主App目标（不可选None）。

2. CocoaPods配置检查 #

• 确认Podfile中正确声明测试目标，示例：

  target 'MyApp' do
    # 主App依赖
    pod 'SomeThirdPod'
    pod '自研框架名称'
    
    target 'MyAppTests' do
      inherit! :search_paths
      # 测试专属依赖可在此添加
    end
  end
  

• 执行pod install后，检查测试目标的Build Phases -> Link Binary With Libraries，确认包含XCTest.framework及自研框架等必要依赖。

3. Build Configuration与Info.plist检查 #

• 测试目标的Build Configuration（如Debug）需与主App对应配置一致，重点核对Preprocessor Macros、Other Linker Flags等可能影响启动的选项。
• 检查测试目标的Info.plist：确保TestBundleIdentifiers包含主App的Bundle ID，NSPrincipalClass值为XCTestSuite（老项目可能被修改）。

三、老项目单元测试搭建分步清单 #

1. 创建测试目标：
   选择File -> New -> Target -> iOS Unit Testing Bundle，命名为[AppName]Tests，关联主App目标。
2. 配置Podfile：
   按上述示例添加测试目标声明，执行pod install。
3. 验证核心配置：
   逐一核对Host Application、Bundle ID、Deployment Target等基础配置项。
4. 清理项目：
   执行Product -> Clean Build Folder，删除Derived Data（Xcode -> Preferences -> Locations -> Derived Data，删除对应项目文件夹）。
5. 编写最简测试：
   替换自动生成的测试代码为：

   func testBasic() {
       XCTAssertTrue(true, "基础测试应通过")
   }
   

   （OC版本：XCTAssertTrue(YES, @"基础测试应通过");）
6. 运行测试：
   选择测试目标连接设备，点击运行按钮；或用命令行执行：

   xcodebuild test -scheme [测试Scheme名称] -destination 'platform=iOS,name=iPhone 11'
   

四、命令行调试技巧 #

• 添加-verbose参数获取详细日志：

  xcodebuild test -scheme MyAppTests -destination 'platform=iOS,name=iPhone 11' -verbose
  

• 查看测试日志文件：路径为~/Library/Developer/Xcode/DerivedData/[项目名称]/Logs/Test，里面会记录启动、执行的详细过程，可能包含Xcode未显示的错误信息。

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