Qt5 QML Cross‑Platform Template (CMake + GitHub Actions)

Qt5 QML × CMake × GitHub Actions に対応した、

クロスプラットフォーム開発向けの最小構成テンプレートです。

Linux / Windows / macOS を対象に、GUI・CMake・自動ビルド環境をすぐに整えられます。

Qt5 でデスクトップアプリを始めたい方に最適です。

Qt5 QML × CMake × GitHub Actions

このテンプレートは、Qt5 QML を用いたデスクトップアプリ開発を

最小構成で始められるよう設計されたスターターキットです。

CMake によるクロスプラットフォーム構成、macOS .app 対応、

GitHub Actions による自動ビルド環境まで含まれており、

Linux / Windows / macOS のいずれでもすぐに開発を開始できます。

特徴

・Qt5 QML を使用した最小構成の GUI アプリ

・CMake ベースのクロスプラットフォーム構成

・macOS .app バンドル対応（Info.plist 自動生成）

・GitHub Actions による OS × Qt バージョンの自動ビルド

・Qt の自動インストール（aqtinstall）

・Qt パス自動検出（Linux / Windows / macOS）

・成果物は OS に関わらず build/release に統一配置

・config/ と lib/（存在する場合）の自動コピー

・src/ に追加した .cpp / .h 、および qml/ に追加した .qml は自動でビルド対象に含まれます

・qml.qrcの自動生成

含まれるファイル

CMakeLists.txt

cmake/Info.plist.in

config/app.ini

qml/Main.qml

src/main.cpp

src/SettingsLoader.cpp

src/SettingsLoader.h

.github/workflows/build.yml

.gitignore

README.md（英語）

README_JP.md（日本語）

使い方（簡易）

1. プロジェクトを展開

2. Qt のパスを指定して CMake でビルド

3. build/release に成果物が生成されます

4. GitHub Actions を有効化すれば、自動ビルドが動作します

詳細は README（日本語 / 英語）をご覧ください。

対象ユーザー

・Qt5 × CMake でデスクトップアプリを作りたい方

・クロスプラットフォーム開発の土台が欲しい方

・GitHub Actions で CI を構築したい方

・Qt プロジェクトの初期セットアップを短縮したい方

・商用アプリのベースを探している方

.gitignore について

本テンプレートには、Git 管理時に不要なファイルがコミットされないよう .gitignore を同梱しています。

build/ 以下にすべての中間生成物が集まる構成のため、追加の ignore 設定は不要です。

注意事項

・本テンプレートは開発用の土台を提供するものです

・配布用アプリ（署名・公証・macdeployqt 等）は含まれていません

・必要に応じて各自のプロジェクトに合わせて追加してください

・Qt5 は macOS CI（GitHub Actions）に対応していません（Apple Silicon ランナー非対応のため）。

　ローカルの Intel Mac では問題なくビルドできます。

ライセンス

商用利用可能です。

テンプレートを利用したアプリの販売・公開も自由です。

ただしテンプレート自体の再配布は禁止しています。

サポート

不具合報告や質問は BOOTH メッセージからご連絡ください。

可能な範囲で対応します。