如何创建方法复用Swift Package单元测试的Bundle资源加载代码？

问题根源 #

你遇到的编译错误，核心原因是复用代码的归属目标错误：如果把Bundle扩展/全局方法写在主Package代码目标里，主代码的Bundle并没有自动生成的module静态属性（Bundle.module是Swift Package为每个独立目标单独生成的）；只有把复用代码放在测试目标的源码范围内，才能正确访问测试目标的Bundle.module。

方案一：测试目标内创建Bundle扩展 #

1. 在测试目标目录下新建Swift文件，比如Bundle+TestResources.swift
2. 确保该文件归属于测试目标（Xcode中拖入测试目标源码组，或在Package.swift的测试目标sources里添加该文件路径）
3. 编写封装资源加载逻辑的扩展：

import Foundation

extension Bundle {
    /// 加载测试资源文件URL
    /// - 参数:
    ///   - name: 资源文件名（不含后缀）
    ///   - ext: 文件后缀
    /// - 返回: 资源URL，找不到则抛出错误
    func testResourceURL(forName name: String, withExtension ext: String) throws -> URL {
        guard let url = self.url(forResource: name, withExtension: ext) else {
            throw NSError(domain: "TestResources", code: -1, userInfo: [NSLocalizedDescriptionKey: "找不到测试资源 \(name).\(ext)"])
        }
        return url
    }

    /// 加载测试资源文件为Data
    func testResourceData(forName name: String, withExtension ext: String) throws -> Data {
        let url = try testResourceURL(forName: name, withExtension: ext)
        return try Data(contentsOf: url)
    }
}

4. 在测试文件中直接调用：

import XCTest
@testable import YourPackage

class SampleTests: XCTestCase {
    func testLoadJsonResource() throws {
        let jsonData = try Bundle.module.testResourceData(forName: "testConfig", withExtension: "json")
        // 后续测试逻辑
    }
}

方案二：测试专用工具类 #

如果偏好类而非扩展，可在测试目标内创建全局工具类：

import Foundation

enum TestResourceLoader {
    static func loadURL(forName name: String, withExtension ext: String) throws -> URL {
        guard let url = Bundle.module.url(forResource: name, withExtension: ext) else {
            throw NSError(domain: "TestResources", code: -1, userInfo: [NSLocalizedDescriptionKey: "找不到测试资源 \(name).\(ext)"])
        }
        return url
    }

    static func loadData(forName name: String, withExtension ext: String) throws -> Data {
        let url = try loadURL(forName: name, withExtension: ext)
        return try Data(contentsOf: url)
    }
}

调用方式：

let imageData = try TestResourceLoader.loadData(forName: "testIcon", withExtension: "png")

关键注意事项 #

• 所有复用代码必须放在测试目标源码范围内，不能放到主Package代码目标中
• 确认Package.swift的测试目标配置包含该复用文件，示例：

.testTarget(
    name: "YourPackageTests",
    dependencies: ["YourPackage"],
    resources: [.process("Resources")],
    sources: ["SampleTests.swift", "Bundle+TestResources.swift"]
)

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