cool-retro-term CI/CD指南如何自动化跨平台构建与发布新版本【免费下载链接】cool-retro-termA good looking terminal emulator which mimics the old cathode display...项目地址: https://gitcode.com/GitHub_Trending/co/cool-retro-termcool-retro-term是一款复古风格的终端模拟器模仿老式阴极射线管CRT显示器的视觉风格。它基于 Qt6 与 QML 开发支持 Linux 和 macOS 双平台。本文带你深入它的CI/CD 自动化流水线看一次代码推送是如何自动完成跨平台构建Linux AppImage macOS DMG并发布新版本到 Release 页面的全程无需人工干预。 快速认识项目架构在理解 CI/CD 之前先了解它构建的是什么组成说明关键路径主程序Qt Quick 应用包含 CRT 特效着色器app/app.pro终端核心QML 版 qtermwidgetGit 子模块qmltermwidget/单实例锁KDSingleApplication子模块KDSingleApplication/顶层工程按顺序构建子模块与主程序cool-retro-term.pro顶层工程文件采用subdirs模板并开启ordered模式保证先构建 qmltermwidget 子模块再构建 app/ 主程序——这是整个自动化构建的基础。 CI/CD 流水线总览整个 CI/CD 逻辑集中在一个 GitHub Actions 工作流文件里.github/workflows/release.yml。它由3 个 Job组成形成一条完整的流水线push / tag 触发 │ ├──▶ Job 1: build-appimageUbuntu 22.04 跑 Linux 构建 │ └─▶ 上传 artifact: cool-retro-term-appimage ├──▶ Job 2: build-dmgmacOS 14 跑 Mac 构建 │ └─▶ 上传 artifact: cool-retro-term-dmg ▼ Job 3: release汇总两个产物创建 Release两个构建 Job并行执行发布 Job 通过needs声明依赖只有两个构建都成功后才会运行——任何一端构建失败Release 都不会被污染。⚡ 三种自动化触发方式工作流的触发器定义在 release.yml 第 3 行起共三种场景推送主干分支向main或master分支 push 代码时自动触发产出滚动版本Rolling Release打标签任意 Git tag如v1.2.0推送时触发产出对应的正式版手动触发workflow_dispatch允许维护者在 Actions 页面一键运行方便调试发布流程。此外工作流声明了最小权限contents: write仅在创建 Release 时需要写权限符合安全最佳实践。 Linux AppImage 自动构建第一个 Jobbuild-appimage运行在ubuntu-22.04环境上核心步骤为检出代码并拉取子模块checkoutv4配置了submodules: recursive确保 qmltermwidget 和 KDSingleApplication/ 两个子模块一并就位子模块清单见 .gitmodules安装 Qt 6.10.0使用jurplel/install-qt-actionv4动作自动安装qt5compat、qtshadertools模块并开启缓存显著缩短构建时间执行构建脚本核心逻辑封装在 scripts/build-appimage.sh 中。构建脚本的精华在于自动化打包脚本先用qmakemake编译再用linuxdeploy工具链把 Qt 运行时、QML 模块、平台插件全部收进一个AppImage单文件应用图标取自 app/icons/256x256/cool-retro-term.png。产物最终上传为 artifact供发布 Job 下载。 macOS DMG 自动构建第二个 Jobbuild-dmg运行在macos-14上流程与 Linux 端对称由 scripts/build-dmg.sh 完成几个值得关注的细节并行编译读取hw.ncpu动态设置JOBS用满 Mac 构建机的 CPU 核心macdeployqt 打包自动把 Qt 框架、QML 插件含 QMLTermWidget收进cool-retro-term.app应用包ad-hoc 代码签名用codesign --force --deep --sign -重签应用避免 Gatekeeper 报应用已损坏生成 DMGhdiutil create压缩成.dmg磁盘镜像作为最终发布格式。 这条设计思路可以借鉴把平台相关的打包逻辑沉淀为可复用的 shell 脚本CI 工作流只负责编排便于本地直接执行脚本调试。 一键发布滚动版与正式版第三个 Jobrelease是流水线的终点release.yml 第 86 行起通过download-artifact汇集 Linux 与 macOS 两端产物根据触发来源走不同发布分支触发来源发布行为版本性质分支 push强制移动rolling标签并发布预发布prereleasetag push以 tag 名创建 Release正式版本也就是说每次主干提交都会自动更新一个永远最新的滚动版用户永远可以拿到最新构建而维护者打上正式 tag 后CI 会自动生成对应的稳定版 Release附带两端安装包。 版本号如何自动注入一个容易被忽略的细节版本号无需在任何配置中手动维护。app/app.pro 第 5 行 通过git describe --tags命令在编译期动态取版本构建脚本 build-appimage.sh 与 build-dmg.sh 也用同样方式给产物文件命名如cool-retro-term-v1.2.0.AppImage。配合 CI 的 tag 触发机制形成了打 tag → 编译注入版本 → 产物命名 → 发布同名 Release的完整闭环彻底消除了版本号不一致的问题。 多形态分发snap、deb、rpm除 CI 产出的 AppImage / DMG 外项目还为包管理器生态提供了完整的打包资料Snapsnap/snapcraft.yaml 定义qmake插件构建 classic 沙箱模式可在各 Linux 发行版的 Snap 商店分发Debianpackaging/debian/rules 使用标准dh构建流程配套 changelog、control 与 man 手册可直接debhelper打包进 Ubuntu 等发行版官方源RPMpackaging/rpm/cool-retro-term.spec 面向 Fedora/CentOS 生态应用元数据packaging/appdata/cool-retro-term.appdata.xml 供 App 商店展示描述与截图。这种CI 二进制 发行版打包双轨制让用户既能从 Releases 直接下载尝鲜也能通过系统包管理器稳定安装。️ 优化建议给你的项目抄作业从 cool-retro-term 的实践中可以提炼出 5 条可直接复用的 CI/CD 经验单一工作流管发布把构建与发布写进同一个 workflow用needs串联避免多文件维护构建逻辑脚本化scripts/目录下的构建脚本既被 CI 调用也可本地直接运行调试成本极低官方 Action 装依赖install-qt-action之类的社区 Action 替代手写依赖安装稳定且带缓存滚动版 正式版双发布rolling预发布标签让早期用户持续尝鲜正式 tag 保障稳定用户不受干扰最小权限原则permissions只声明必需的contents: write。 关键文件速查文件作用.github/workflows/release.ymlCI/CD 流水线主文件scripts/build-appimage.shLinux AppImage 构建脚本scripts/build-dmg.shmacOS DMG 构建脚本snap/snapcraft.yamlSnap 打包配置packaging/debian/Debian 打包资料packaging/rpm/cool-retro-term.specRPM 打包规范cool-retro-term.pro顶层构建工程掌握这套流水线后无论是想理解 cool-retro-term 如何保持高频更新还是为自己的 Qt 项目搭建同样的跨平台自动化发布体系都可以直接参考上述文件落地实践。【免费下载链接】cool-retro-termA good looking terminal emulator which mimics the old cathode display...项目地址: https://gitcode.com/GitHub_Trending/co/cool-retro-term创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 cool-retro-term CI/CD指南：如何自动化跨平台构建与发布新版本
cool-retro-term CI/CD指南如何自动化跨平台构建与发布新版本【免费下载链接】cool-retro-termA good looking terminal emulator which mimics the old cathode display...项目地址: https://gitcode.com/GitHub_Trending/co/cool-retro-termcool-retro-term是一款复古风格的终端模拟器模仿老式阴极射线管CRT显示器的视觉风格。它基于 Qt6 与 QML 开发支持 Linux 和 macOS 双平台。本文带你深入它的CI/CD 自动化流水线看一次代码推送是如何自动完成跨平台构建Linux AppImage macOS DMG并发布新版本到 Release 页面的全程无需人工干预。 快速认识项目架构在理解 CI/CD 之前先了解它构建的是什么组成说明关键路径主程序Qt Quick 应用包含 CRT 特效着色器app/app.pro终端核心QML 版 qtermwidgetGit 子模块qmltermwidget/单实例锁KDSingleApplication子模块KDSingleApplication/顶层工程按顺序构建子模块与主程序cool-retro-term.pro顶层工程文件采用subdirs模板并开启ordered模式保证先构建 qmltermwidget 子模块再构建 app/ 主程序——这是整个自动化构建的基础。 CI/CD 流水线总览整个 CI/CD 逻辑集中在一个 GitHub Actions 工作流文件里.github/workflows/release.yml。它由3 个 Job组成形成一条完整的流水线push / tag 触发 │ ├──▶ Job 1: build-appimageUbuntu 22.04 跑 Linux 构建 │ └─▶ 上传 artifact: cool-retro-term-appimage ├──▶ Job 2: build-dmgmacOS 14 跑 Mac 构建 │ └─▶ 上传 artifact: cool-retro-term-dmg ▼ Job 3: release汇总两个产物创建 Release两个构建 Job并行执行发布 Job 通过needs声明依赖只有两个构建都成功后才会运行——任何一端构建失败Release 都不会被污染。⚡ 三种自动化触发方式工作流的触发器定义在 release.yml 第 3 行起共三种场景推送主干分支向main或master分支 push 代码时自动触发产出滚动版本Rolling Release打标签任意 Git tag如v1.2.0推送时触发产出对应的正式版手动触发workflow_dispatch允许维护者在 Actions 页面一键运行方便调试发布流程。此外工作流声明了最小权限contents: write仅在创建 Release 时需要写权限符合安全最佳实践。 Linux AppImage 自动构建第一个 Jobbuild-appimage运行在ubuntu-22.04环境上核心步骤为检出代码并拉取子模块checkoutv4配置了submodules: recursive确保 qmltermwidget 和 KDSingleApplication/ 两个子模块一并就位子模块清单见 .gitmodules安装 Qt 6.10.0使用jurplel/install-qt-actionv4动作自动安装qt5compat、qtshadertools模块并开启缓存显著缩短构建时间执行构建脚本核心逻辑封装在 scripts/build-appimage.sh 中。构建脚本的精华在于自动化打包脚本先用qmakemake编译再用linuxdeploy工具链把 Qt 运行时、QML 模块、平台插件全部收进一个AppImage单文件应用图标取自 app/icons/256x256/cool-retro-term.png。产物最终上传为 artifact供发布 Job 下载。 macOS DMG 自动构建第二个 Jobbuild-dmg运行在macos-14上流程与 Linux 端对称由 scripts/build-dmg.sh 完成几个值得关注的细节并行编译读取hw.ncpu动态设置JOBS用满 Mac 构建机的 CPU 核心macdeployqt 打包自动把 Qt 框架、QML 插件含 QMLTermWidget收进cool-retro-term.app应用包ad-hoc 代码签名用codesign --force --deep --sign -重签应用避免 Gatekeeper 报应用已损坏生成 DMGhdiutil create压缩成.dmg磁盘镜像作为最终发布格式。 这条设计思路可以借鉴把平台相关的打包逻辑沉淀为可复用的 shell 脚本CI 工作流只负责编排便于本地直接执行脚本调试。 一键发布滚动版与正式版第三个 Jobrelease是流水线的终点release.yml 第 86 行起通过download-artifact汇集 Linux 与 macOS 两端产物根据触发来源走不同发布分支触发来源发布行为版本性质分支 push强制移动rolling标签并发布预发布prereleasetag push以 tag 名创建 Release正式版本也就是说每次主干提交都会自动更新一个永远最新的滚动版用户永远可以拿到最新构建而维护者打上正式 tag 后CI 会自动生成对应的稳定版 Release附带两端安装包。 版本号如何自动注入一个容易被忽略的细节版本号无需在任何配置中手动维护。app/app.pro 第 5 行 通过git describe --tags命令在编译期动态取版本构建脚本 build-appimage.sh 与 build-dmg.sh 也用同样方式给产物文件命名如cool-retro-term-v1.2.0.AppImage。配合 CI 的 tag 触发机制形成了打 tag → 编译注入版本 → 产物命名 → 发布同名 Release的完整闭环彻底消除了版本号不一致的问题。 多形态分发snap、deb、rpm除 CI 产出的 AppImage / DMG 外项目还为包管理器生态提供了完整的打包资料Snapsnap/snapcraft.yaml 定义qmake插件构建 classic 沙箱模式可在各 Linux 发行版的 Snap 商店分发Debianpackaging/debian/rules 使用标准dh构建流程配套 changelog、control 与 man 手册可直接debhelper打包进 Ubuntu 等发行版官方源RPMpackaging/rpm/cool-retro-term.spec 面向 Fedora/CentOS 生态应用元数据packaging/appdata/cool-retro-term.appdata.xml 供 App 商店展示描述与截图。这种CI 二进制 发行版打包双轨制让用户既能从 Releases 直接下载尝鲜也能通过系统包管理器稳定安装。️ 优化建议给你的项目抄作业从 cool-retro-term 的实践中可以提炼出 5 条可直接复用的 CI/CD 经验单一工作流管发布把构建与发布写进同一个 workflow用needs串联避免多文件维护构建逻辑脚本化scripts/目录下的构建脚本既被 CI 调用也可本地直接运行调试成本极低官方 Action 装依赖install-qt-action之类的社区 Action 替代手写依赖安装稳定且带缓存滚动版 正式版双发布rolling预发布标签让早期用户持续尝鲜正式 tag 保障稳定用户不受干扰最小权限原则permissions只声明必需的contents: write。 关键文件速查文件作用.github/workflows/release.ymlCI/CD 流水线主文件scripts/build-appimage.shLinux AppImage 构建脚本scripts/build-dmg.shmacOS DMG 构建脚本snap/snapcraft.yamlSnap 打包配置packaging/debian/Debian 打包资料packaging/rpm/cool-retro-term.specRPM 打包规范cool-retro-term.pro顶层构建工程掌握这套流水线后无论是想理解 cool-retro-term 如何保持高频更新还是为自己的 Qt 项目搭建同样的跨平台自动化发布体系都可以直接参考上述文件落地实践。【免费下载链接】cool-retro-termA good looking terminal emulator which mimics the old cathode display...项目地址: https://gitcode.com/GitHub_Trending/co/cool-retro-term创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考