如何在SwiftUI应用的XCTest UI测试中指定文件打开对话框的文件/目录？

一、直接操作系统文件对话框的可行性 #

直接通过XCTest控制SwiftUI fileImporter唤起的系统文件对话框，稳定性和兼容性都很差，原因如下：

• macOS：系统文件对话框属于系统级UI，虽然可以通过XCUIApplication().dialogs或查询table元素定位文件，但UI结构会随系统版本变化，测试用例很容易失效。
• iOS/iPadOS：文件选择器（Files应用）是独立进程，XCTest默认仅支持测试自身应用UI，跨进程操作需要额外权限，且Files的UI同样会随系统更新改变，维护成本极高。

因此不推荐直接操作系统对话框，更可靠的方式是绕过对话框直接让应用获取目标文件。

二、替代方案：绕过系统对话框注入文件 #

1. 添加测试专属的文件导入入口 #

在应用代码中加入仅测试环境生效的逻辑，跳过系统对话框直接传入测试文件：

// 定义测试环境标识的EnvironmentKey
struct IsTestingKey: EnvironmentKey {
    static let defaultValue = false
}

extension EnvironmentValues {
    var isTesting: Bool {
        get { self[IsTestingKey.self] }
        set { self[IsTestingKey.self] = newValue }
    }
}

// 视图中加入测试专用逻辑
struct ContentView: View {
    @Environment(\.isTesting) private var isTesting
    @State private var showImporter = false
    @State private var processedFileName: String?

    var body: some View {
        Button("Import File") {
            if isTesting {
                // 测试时直接加载包内的测试文件
                guard let testURL = Bundle(for: FileImportTests.self).url(forResource: "sample", withExtension: "txt") else { return }
                processFile(testURL)
            } else {
                showImporter = true
            }
        }
        .fileImporter(isPresented: $showImporter, allowedContentTypes: [.text]) { result in
            if case .success(let url) = result {
                processFile(url)
            }
        }
        // 给测试入口加可访问性标识，方便测试用例触发
        .accessibility(identifier: "test-direct-import")
    }

    private func processFile(_ url: URL) {
        processedFileName = url.lastPathComponent
    }
}

在UI测试中，通过启动参数开启测试模式并触发专属入口：

class FileImportTests: XCTestCase {
    func testDirectFileImport() {
        let app = XCUIApplication()
        app.launchEnvironment["IS_TESTING"] = "true"
        app.launch()

        // 触发测试专用导入
        app.buttons["test-direct-import"].tap()

        // 验证文件处理结果
        XCTAssertTrue(app.staticTexts["Processed: sample.txt"].exists)
    }
}

2. 依赖注入替换文件处理逻辑 #

把文件导入逻辑抽离为独立服务，测试时替换为模拟实现：

// 定义文件导入服务协议
protocol FileImporterService {
    func importFile(completion: (Result<URL, Error>) -> Void)
}

// 生产环境实现：唤起系统fileImporter
class ProductionFileImporter: FileImporterService {
    func importFile(completion: (Result<URL, Error>) -> Void) {
        // 这里绑定SwiftUI的fileImporter逻辑
    }
}

// 测试环境实现：直接返回指定测试文件
class TestFileImporter: FileImporterService {
    func importFile(completion: (Result<URL, Error>) -> Void) {
        let testURL = Bundle(for: FileImportTests.self).url(forResource: "sample", withExtension: "txt")!
        completion(.success(testURL))
    }
}

// 视图中注入服务
struct ContentView: View {
    @Environment(\.fileImporterService) private var importerService
    @State private var processedFileName: String?

    var body: some View {
        Button("Import File") {
            importerService.importFile { result in
                if case .success(let url) = result {
                    processedFileName = url.lastPathComponent
                }
            }
        }
    }
}

测试时，应用在启动时根据环境变量注入TestFileImporter，测试用例只需正常点击导入按钮即可验证结果。

3. iOS平台备选：提前复制文件到应用目录 #

如果必须模拟用户选择文件的流程，可将测试文件提前复制到应用的Documents目录，再通过UI操作选择：

func testImportFromDocuments() {
    let app = XCUIApplication()
    app.launch()

    // 复制测试文件到应用Documents目录
    let testFileURL = Bundle(for: type(of: self)).url(forResource: "sample", withExtension: "txt")!
    let docsURL = app.containerURL(forSecurityApplicationGroupIdentifier: "com.your.app.group")?.appendingPathComponent("Documents")
    try! FileManager.default.copyItem(at: testFileURL, to: docsURL!.appendingPathComponent("sample.txt"))

    // 唤起文件选择器并操作（注意：该代码依赖iOS系统版本，可能随系统更新失效）
    app.buttons["Import File"].tap()
    app.navigationBars["Browse"].buttons["Locations"].tap()
    app.tables.cells["On My iPhone"].tap()
    app.tables.cells["Your App"].tap()
    app.tables.cells["sample.txt"].tap()
    app.buttons["Open"].tap()

    // 验证结果
    XCTAssertTrue(app.staticTexts["Processed: sample.txt"].exists)
}

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