ShichiZip 是一个面向 macOS 的 7-Zip 衍生版压缩软件，它以原生 Swift/Objective-C++ 重构了 7-Zip 文件管理器体验。为了让"压缩包解压不出错、界面上线不翻车"，项目构建了一套双层测试体系：ShichiZipTests 单元测试负责校验压缩、解压、加密、桥接字符串转换等核心逻辑；ShichiZipUITests 基于 XCUITest 的 UI 自动化则直接驱动真实 App，模拟点击、菜单、对话框操作。本文将带你快速看懂这套测试架构的组成、运行方式与设计亮点。

🧩 双层测试架构：单元测试 + UI 自动化

ShichiZip 提供两个构建变体（Mainline 与 Zstandard fork），每个变体各配备一对测试 Target，形成"逻辑层 + 界面层"的双重防线：

单元测试 Target 通过TEST_HOST指向构建出的 App 主程序（project/specs/apps.yml），测试代码以宿主进程方式运行，可以直接@testable import主 App 的内部实现；scheme 的 test 配置则把两个 Target 挂在一起（project/specs/schemes.yml）。

🚀 单元测试：核心压缩解压缩逻辑怎么测

单元测试代码全部位于 ShichiZipTests/ 目录，共 40 余个测试文件，按功能域清晰划分：

• 端到端往返测试：ArchiveRoundTripTests.swift 覆盖"创建 → 打开 → 解压"完整链路，还包含加密压缩包列目录与取消操作检查；
• 加密与密码策略：ZipEncryptionPolicyTests、ZipPasswordMutationTests、MixedPasswordZipTests（及MixedPasswordZipIntegrityTests）、EncryptedArchiveMutationTests针对带密码、混合密码 ZIP 的边界行为反复"施压"；
• 桥接层字符串转换：BridgeStringConversionTests.swift 验证 Swift ↔ C++ 桥接中非 BMP 字符（emoji、生僻汉字）往返无损，以及非法 UTF-8 回退 MacRoman 的行为，确保"乱码文件名"不再神秘消失；
• 文件管理器状态机：FileManagerPane*系列（导航、事件、传输、挂起恢复等协调器）与FileManagerTransferTests、FileManagerTrashOperationTests保障主窗口逻辑；
• 配置与通用组件：SettingsFileAssociationTests、SharedUserDefaultsTests、OperationProgressModelTests、OperationSessionProgressThrottlingTests等。

测试夹具：统一的临时目录与归档工厂

所有测试共享一套辅助工具 ShichiZipTestSupport.swift：makeTemporaryDirectory自动创建带 UUID 的临时目录并注册 teardown 清理，createArchive则通过SZArchive.create一键生成指定格式、密码、路径模式的测试归档。此外还支持用系统cpio命令或手写 System V 布局生成ar夹具（ShichiZipTestSupport.swift），让测试不依赖宿主机工具版本——这是跨环境稳定性的关键细节。

🖱️ XCUITest UI 自动化：让真实 App "替你点一遍"

UI 自动化代码位于 ShichiZipUITests/，基类 ShichiZipUITestCase.swift 封装了所有通用能力：

1. 确定性启动环境：通过launchEnvironment注入SHICHIZIP_FORCE_DEFAULT_LAUNCH等环境变量，强制每次测试从一致的初始状态启动，避免"上次残留状态"导致的偶现失败；
2. 稳定的元素定位：全部基于无障碍标识符定位，如fileManager.tableView、compress.archivePath、modal.button.0，不依赖文案，中英文本地化环境下都能通过；
3. 导航与夹具助手：navigateLeftPane(to:)通过路径栏粘贴实现窗口跳转，makeTemporaryDirectory/createTextFile快速准备测试数据，waitForElement提供可配置超时的等待断言。

UI 测试覆盖了哪些真实场景

以 CompressDialogUITests.swift 为例：测试导航到临时目录 → 点击文件 → 通过菜单栏打开"Add to Archive" → 断言归档路径框、格式/压缩级别/算法下拉框全部出现 → 点击取消。类似地，目录中还覆盖：

• 对话框流程：CompressDialogUITests、ExtractDialogUITests、ZipUpdateEncryptionUITests、FoldersHistoryUITests；
• 文件管理器行为：FileManagerUITests、DragFromArchiveUITests、FileManagerTransferUITests、AutoRefreshUITests、SuspendedPaneUITests、MenuRefreshUITests；
• 系统集成与性能：QuickLookUITests（预览扩展）、LaunchOpenHUDUITests（启动打开 HUD）、BenchmarkUITests、HashUITests（哈希校验）、OperationProgressWindowUITests、SettingsWindowUITests。

💡 UI 测试会真实接管你的 Mac（点击、输入、打开菜单），运行期间请勿操作机器，否则结果不可信。

⚡ 一键运行测试：命令行完整命令

生成项目（xcodegen generate）并完成构建后，可在终端分别运行单元测试与 UI 自动化测试（完整说明见 BUILD.md）：

# 运行单元测试 xcodebuild -project ShichiZip.xcodeproj -scheme ShichiZip \ -configuration Debug -arch arm64 -only-testing:ShichiZipTests test # 运行 UI 自动化测试 xcodebuild -project ShichiZip.xcodeproj -scheme ShichiZip \ -configuration Debug -arch arm64 -only-testing:ShichiZipUITests test

Zstandard fork 变体只需将 scheme 换为ShichiZipZS、测试 Target 换为ShichiZipZSTests/ShichiZipZSUITests。去掉-only-testing参数即可把两套测试一起跑完。

📚 新手可以借鉴的 5 个工程实践

1. 分层而不重复：逻辑错误让单元测试快速捕获（秒级反馈），界面回归交给 UI 自动化（慢但接近真实用户）；
2. 确定性优先：用环境变量固定启动状态、用 UUID 临时目录隔离夹具，是消除"本地能过 CI 挂"的关键；
3. 无障碍标识符定位 UI 元素：比按文案查找更稳，天然兼容多语言；
4. 夹具即代码：归档、cpio、ar 等测试数据全部程序化生成，不依赖外部下载的二进制样本；
5. 双变体全量覆盖：Mainline 与 Zstandard fork 共享同一套测试源码（通过#if SHICHIZIP_ZS_VARIANT切换导入），任何逻辑改动都同时验证两条链接路径。

总结

ShichiZip 用ShichiZipTests（单元测试）+ShichiZipUITests（XCUITest UI 自动化）构建了对称、可复现、双变体一致的质量保障体系：单元测试深钻压缩解压缩与桥接边界，UI 自动化端到端验证真实交互。对于想学习 macOS 原生应用测试的新手，BUILD.md 的 Testing 章节、project/specs/apps.yml 的 Target 配置与本文梳理的测试文件清单，就是最完整的学习地图。