Swift SPM包引入XCTest依赖遇构建报错，求解决方法

我正在开发一个用于扩展XCTest功能的Swift包，在将其用于App测试时遇到构建问题：

• 已在包的非测试类文件中导入XCTest并使用XCUIScreen等API，包本身编译无报错；
• 将该测试辅助包作为本地依赖添加到本地App，并在App的测试目标中设置了「Link Binary With Libraries」；
• 可在App测试类中导入该包，但使用包内类时出现如下链接错误：

ld: warning: Could not find or use auto-linked library 'XCTestSwiftSupport': library 'XCTestSwiftSupport' not found
ld: warning: Could not find or use auto-linked framework 'XCTest': framework 'XCTest' not found
ld: Undefined symbols:
  _OBJC_CLASS_$_XCUIScreen, referenced from:
       in MyXcodeTestHelper.o
  __swift_FORCE_LOAD_$_XCTestSwiftSupport, referenced from:
      __swift_FORCE_LOAD_$_XCTestSwiftSupport_$_MyXcodeTestHelper in MyXcodeTestHelper.o
clang: error: linker command failed with exit code 1 (use -v to see invocation)

请问是否遗漏了Package.swift中的配置？或有无可行替代方案？当前使用Xcode 15.0。

1. 修正Package.swift的XCTest依赖配置 #

XCTest是仅用于测试目标的框架，不能直接作为包主目标的依赖。你需要调整Package.swift的目标配置，将XCTest的依赖限制在测试目标中：

let package = Package(
    name: "MyXcodeTestHelper",
    products: [
        .library(
            name: "MyXcodeTestHelper",
            targets: ["MyXcodeTestHelper"]),
    ],
    dependencies: [],
    targets: [
        .target(
            name: "MyXcodeTestHelper",
            // 主目标不直接依赖XCTest
            dependencies: []),
        .testTarget(
            name: "MyXcodeTestHelperTests",
            // 仅在包自身的测试目标中依赖XCTest
            dependencies: ["MyXcodeTestHelper", .product(name: "XCTest", package: "xctest")]),
    ]
)

同时，包内主目标的代码要添加条件导入，确保XCTest仅在测试环境生效：

#if canImport(XCTest) && DEBUG
import XCTest
#endif

public class MyTestHelper {
    public func getScreenSize() -> CGSize {
        #if canImport(XCTest) && DEBUG
        return XCUIScreen.main.frame.size
        #else
        fatalError("该方法仅在测试环境可用")
        #endif
    }
}

2. 确保App测试目标正确链接XCTest #

在App项目的测试目标中检查以下配置：

• 打开Build Settings，找到Framework Search Paths，确认包含路径：$(PLATFORM_DIR)/Developer/Library/Frameworks
• 若自动链接失效，在Other Linker Flags中手动添加：-framework XCTest

3. 替代方案：将包设为测试专属包 #

如果你的包仅用于测试场景，可直接将其配置为测试专用：

• 在Package.swift中把主目标改为testTarget，或创建仅面向测试的产品
• 在App项目中仅将该包添加为测试目标的依赖，而非主App目标
• 这种配置下，XCTest的依赖会被Xcode自动处理，因为测试目标默认会链接XCTest框架

关键原因 #

XCTest是Xcode专为测试目标设计的框架，不会自动链接到非测试环境。你的包在主目标中直接导入XCTest，导致App测试目标的链接器无法找到对应的框架和库文件。

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