如何在Windows Server部署的Jenkins上运行Swift单元测试

可行性说明 #

直接在你当前部署Jenkins的Windows Server 2012 R2服务器本地运行iOS应用Swift测试完全不具备可行性，核心原因如下：

• iOS应用的编译、单元测试、UI测试全流程强依赖苹果官方的Xcode工具链，苹果从未发布过Windows版本的Xcode，也没有提供Windows环境下运行iOS平台Swift测试的官方运行时支持
• 目前开源社区维护的Windows版本Swift仅支持基础语法层面的编译运行，完全不兼容UIKit、SwiftUI等iOS应用核心依赖的系统框架，无法执行iOS应用的业务测试用例
• Windows Server 2012 R2版本过低，当前最新的开源Windows版Swift最低要求系统版本为Windows 10/Windows Server 2019及以上，连基础Swift运行环境都无法在这台服务器上正常安装

你可以采用主控+代理的架构实现需求：将当前Windows上部署的Jenkins作为主控节点，额外准备一台符合苹果许可要求的macOS设备（Intel/Apple Silicon芯片均可，预装对应版本Xcode），将其配置为Jenkins的代理节点，所有iOS Swift测试相关的任务全部调度到macOS代理节点上执行即可，这是目前行业内的通用实现方案。

可用插件及配置参考 #

可直接通过Jenkins官方插件库安装使用的插件如下，不需要额外找第三方定制工具：

• Xcode Integration插件：核心功能插件，支持在流水线中可视化配置Xcode构建、测试参数，自动关联Xcode命令行工具执行操作
• JUnit插件：辅助展示插件，你可以在测试执行时通过xcodebuild指令将测试结果导出为JUnit格式，用该插件直接在Jenkins任务页展示测试通过率、失败用例详情、耗时统计等数据

配置流程没有特殊复杂度：

1. 在Windows端Jenkins的插件管理页搜索安装上述两个插件
2. 在准备好的macOS设备上启动Jenkins代理程序，和Windows主控节点建立连接，给该代理打上macos-ios这类自定义标签
3. 编写Pipeline时，将Swift测试相关的步骤指定到带macos-ios标签的节点上运行，测试执行的核心命令和你本地在mac上跑测试用的xcodebuild test指令完全一致，不需要额外适配特殊语法

注意：不要尝试使用黑苹果、虚拟化嵌套运行macOS的方案搭建代理节点，这类方案违反苹果软件许可协议，且稳定性极差，容易出现随机测试失败、环境崩溃等无规律问题。

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