qt-release - Cross-Platform Qt App Release with GitHub Actions
Set up and troubleshoot GitHub Actions workflows for building, signing, notarizing, and packaging Qt applications on macOS, Linux, and Windows.
Tags
Updated: 2026-06-30Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Install Qt SDK via GitHub Actions
- Bundle Qt frameworks on macOS
- Sign macOS app bundles with codesign
- Notarize macOS apps with notarytool
- Package macOS apps using ditto
- Create Linux AppImage packages
- Package Windows apps with windeployqt
- Create GitHub release with artifacts
- Troubleshoot Qt release workflow issues
Inputs
- GitHub repository
- Qt application source code
- macOS code signing certificate (.p12)
- Apple Developer credentials
- GitHub Actions secrets
- Qt version specification
- Linux desktop file
Outputs
- GitHub Actions workflow YAML files
- Signed macOS app bundle
- Notarized macOS application package
- Linux AppImage package
- Windows ZIP package
- GitHub release with build artifacts
Requirements
- GitHub Actions runner access
- jurplel/install-qt-action@v4
- Apple Developer Program membership for macOS signing
- linuxdeployqt for Linux packaging
- windeployqt for Windows packaging
- ubuntu-22.04 runner for Linux builds