如何在跨平台Xcode项目实现100%单元测试覆盖率并指定iOS模拟器测试

一、针对不同iOS模拟器单独运行指定测试 #

1. 编写分版本测试用例 #

为isNavigationStackAvailable编写两个针对性测试方法，分别对应系统版本达标和不达标的场景：

import XCTest
@testable import YourAppName

class NavigationStackAvailabilityTests: XCTestCase {
    // 测试iOS 16+环境下的返回值
    func testNavigationStackAvailableOniOS16() {
        XCTAssertTrue(isNavigationStackAvailable)
    }

    // 测试iOS 15及以下环境下的返回值
    func testNavigationStackUnavailableOniOS15() {
        XCTAssertFalse(isNavigationStackAvailable)
    }
}

2. 单独运行指定测试的两种方式 #

• Xcode界面操作：
  打开测试文件，点击测试方法左侧的播放按钮，在弹出菜单中选择对应版本的iOS模拟器（比如选iOS 16.x模拟器运行testNavigationStackAvailableOniOS16，选iOS 15.x模拟器运行testNavigationStackUnavailableOniOS15）。
• 命令行操作：
  使用xcodebuild指定测试目标、模拟器和具体测试方法：

  # 运行iOS 16模拟器上的指定测试
  xcodebuild test -scheme YourSchemeName -destination 'platform=iOS Simulator,name=iPhone 14,iOS 16.4' -only-testing:YourTestTarget/NavigationStackAvailabilityTests/testNavigationStackAvailableOniOS16
  
  # 运行iOS 15模拟器上的指定测试
  xcodebuild test -scheme YourSchemeName -destination 'platform=iOS Simulator,name=iPhone 13,iOS 15.5' -only-testing:YourTestTarget/NavigationStackAvailabilityTests/testNavigationStackUnavailableOniOS15
  

二、跨平台Xcode项目实现100%单元测试覆盖率 #

1. 覆盖所有代码分支 #

你的isNavigationStackAvailable包含两个分支（系统版本达标/不达标），需针对每个平台的不同系统版本编写测试：

• iOS：分别在iOS 16+和iOS 15及以下模拟器运行对应测试。
• macOS：分别在macOS 13+和macOS 12及以下环境运行对应测试。

2. 启用Xcode覆盖率统计 #

• 选中测试Target，进入Build Settings，搜索GCC_GENERATE_TEST_COVERAGE_FILES和GCC_INSTRUMENT_PROGRAM_FLOW_ARCS，将两个选项都设为YES。
• 运行所有测试后，在Xcode的Report Navigator中打开最新测试报告，查看Coverage标签确认分支覆盖情况。

3. 处理跨平台特殊逻辑 #

• 用#if os(iOS)、#if os(macOS)等编译条件拆分测试用例，确保各平台特有代码都有对应测试。
• 通过Xcode的destination参数指定不同平台运行测试，避免硬编码平台依赖。

4. 补全未覆盖代码 #

若覆盖率未达100%，查看覆盖率报告中标记为红色的代码行，针对性补充测试用例，确保每个条件分支、代码路径都被执行到。

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