如何对含SwiftUI视图的SPM进行快照测试？终端执行测试遇报错

针对当前xcodebuild命令报错的修复方案 #

1. 修正destination参数的引号与命令类型
   双引号参数报错本质是shell解析时的转义问题，单引号可避免空格或特殊字符的解析异常。另外注意：若要运行测试，需用test命令而非build，正确命令示例：

   xcodebuild -scheme <scheme> test -sdk iphonesimulator -destination 'platform=iOS Simulator,name=iPhone 14'
   

   更稳定的方式是用模拟器UUID指定目标，避免名称匹配问题：

   • 先执行xcrun simctl list devices获取目标模拟器的UUID
   • 替换为：

     xcodebuild -scheme <scheme> test -sdk iphonesimulator -destination 'platform=iOS Simulator,id=<模拟器UUID>'
     

2. 修复模拟器配置异常
   报错中的“Device not configured”大概率是模拟器状态损坏，执行以下步骤重置：

   • 清空所有模拟器数据：xcrun simctl erase all
   • 重启模拟器服务：sudo killall -9 com.apple.CoreSimulator.CoreSimulatorService
   • 重新启动模拟器后再执行测试命令

SPM中测试SwiftUI/UIKit的通用实践 #

1. 确保Package.swift配置正确
   测试目标必须依赖主UI目标，同时正确引入测试库，示例配置：

   let package = Package(
       name: "YourUIPackage",
       products: [.library(name: "YourUI", targets: ["YourUI"])],
       dependencies: [
           .package(url: "https://github.com/pointfreeco/swift-snapshot-testing.git", from: "1.15.0")
       ],
       targets: [
           .target(name: "YourUI"),
           .testTarget(
               name: "YourUITests",
               dependencies: [
                   "YourUI",
                   .product(name: "SnapshotTesting", package: "SnapshotTesting")
               ]
           )
       ]
   )
   

2. 用Xcode简化测试流程
   直接在终端执行open Package.swift打开SPM包，在Xcode中选择对应模拟器和测试scheme，点击运行测试按钮，能直观查看测试日志和错误，比纯终端命令更易排查问题。

3. 快照测试的路径与环境处理

   • SwiftUI视图测试：用SnapshotTesting的assertSnapshot配合ViewHosting托管视图，示例：

     import SnapshotTesting
     import SwiftUI
     import XCTest
     @testable import YourUI
     
     final class YourUITests: XCTestCase {
         func testExampleViewSnapshot() {
             let view = ExampleView()
             assertSnapshot(matching: view, as: .image)
         }
     }
     

   • UIKit组件测试：直接初始化UIView/UIViewController，用assertSnapshot捕获快照，确保测试代码中没有依赖未初始化的环境变量。

内容的提问来源于stack exchange，提问作者R.Radev