如何在Windows、Linux、macOS上运行CI并行打包PyInstaller Python Qt应用

实现逻辑 #

主流CI平台原生支持多系统runner并行调度，不需要自行开发并行运行逻辑，通过矩阵配置即可同时触发Windows、Linux、macOS三个平台的构建任务。

具体配置步骤 #

• 配置CI任务矩阵，声明三个目标系统的runner标签，平台会自动调度对应系统的runner并行执行任务：
  通用配置示例如下：

  jobs:
    build:
      runs-on: ${{ matrix.os }}
      strategy:
        matrix:
          os: [ubuntu-latest, windows-latest, macos-latest]
  

  上述配置会自动生成3个独立的并行job，分别运行在三类系统的runner环境中，无需手动做任务调度。
• 分系统编写依赖安装和打包脚本，统一CI执行入口：
  不同系统的依赖和打包逻辑差异可以封装在独立脚本中，job运行时自动适配对应系统的脚本执行即可：
  • Linux环境：提前安装libx11-xcb1、libxcb-xinerama0等Qt运行依赖，打包前设置环境变量export QT_QPA_PLATFORM=offscreen避免GUI相关检测报错。
  • Windows环境：直接安装Python依赖后执行PyInstaller打包命令即可，若需要生成exe图标可在打包命令中加--icon参数指定图标路径。
  • macOS环境：打包时添加--windowed参数生成.app格式的应用包，需要分发的话可在job中追加签名和公证步骤。
• 配置构建产物上传规则，三个job打包完成后分别上传对应系统的应用包，可在CI任务面板统一获取所有平台的构建产物。

注意事项 #

• 打包Qt应用时需要在PyInstaller命令中通过--hidden-import参数导入Qt相关的隐式依赖，避免运行时出现模块缺失报错。
• 三个job的Python版本、依赖包版本要保持一致，避免因环境差异导致打包产物异常。
• 并行运行的job之间相互独立，不需要做进程同步，所有job执行完成后CI流程自动结束。

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