如何在Windows机器的GitLab CI流水线中生成OS X .pkg安装包？

我之前帮团队处理过类似的跨平台打包需求，最省心的方式其实是拆分CI流水线的构建与打包阶段，把重复构建的问题从根源上解决掉，下面分享几个可行的思路：

方案一：多阶段流水线分离构建与打包（推荐） #

核心思路是：只在一个节点完成C#源代码的构建，生成跨平台可用的二进制产物，然后把产物作为CI artifacts传递给不同平台的runner，分别完成.msi和.pkg的打包。这样完全避免了重复构建源代码的冗余。

具体步骤：

1. 构建阶段（单节点执行）：

   • 在你的Windows GitLab Runner上，执行C#项目的跨平台构建命令（以.NET 6+为例）：

     dotnet publish -c Release --runtime win-x64 --self-contained false -o ./win-build
     dotnet publish -c Release --runtime osx-x64 --self-contained false -o ./osx-build
     

     要是你的项目支持统一输出跨平台兼容的产物，只需要一次publish操作即可。
   • 将构建好的win-build和osx-build目录标记为CI artifacts，让后续阶段可以直接下载使用。

2. 打包阶段（多节点并行执行）：

   • Windows打包Job：下载Windows构建产物，用WiX Toolset、Advanced Installer这类工具生成.msi文件。
   • Mac打包Job：下载Mac构建产物，用pkgbuild、productbuild这类原生工具生成.pkg文件。

整个流水线里源代码只构建一次，两个打包Job共享同一套构建产物，既满足了跨平台打包需求，又完全没有冗余的重复构建操作。

方案二：在Windows机器上通过虚拟机运行Mac环境（不推荐） #

如果一定要在同一台Windows机器上完成所有操作，可以考虑在Windows Runner中部署Mac虚拟机（比如用Parallels Desktop或VMware Workstation），然后通过CI脚本触发虚拟机内的打包流程：

• 先在Windows runner上完成C#构建，生成适配Mac平台的产物。
• 通过脚本启动Mac虚拟机，将构建产物同步到虚拟机内部。
• 在虚拟机内执行pkg打包命令，最后将生成的.pkg文件传回主机。

这个方案的问题在于虚拟机资源占用高，维护成本也高（比如虚拟机镜像更新、权限配置），而且打包效率远不如单独的Mac Runner，只适合资源有限的临时场景。

补充提示 #

如果你的C#项目是基于传统.NET Framework（而非跨平台的.NET Core/.NET 5+），那Mac平台的构建可能需要依赖Mono框架，这时候可以在Mac Runner上用Mono完成编译，但依然建议把构建和打包分离，避免重复拉取代码编译。

内容的提问来源于stack exchange，提问作者Tri-Edge AI