Qt for Windows - ソースからのビルド
このページでは、Qt for Windows の設定とビルドの手順について説明します。ビルド済みの Qt for Windows をダウンロードしてインストールするには、「Qt を始める」のページの指示に従ってください。
ステップ 1: ソースの入手
Qt のソースはQt Online Installer からインストールできます。ソースパッケージはGit やQt アカウント(商用ユーザー)、download.qt.io(オープンソースユーザー)からも入手できます。
ソースをQt Online Installer からインストールした場合は、Qt のインストールディレクトリC:\Qt\6.8.2\Src
などにあります。
ソース・アーカイブをダウンロードした場合は、お好きなディレクトリ(例えばC:\dev\Qt\src
)に解凍してください。
注意: ソース・ディレクトリへのパスには、スペースやWindows特有のファイル・システム文字を含んではいけません。また、パスは短くしてください。これにより、コンパイル段階でファイルパスが長すぎる問題を防ぐことができる。
ステップ 2: ビルド要件のインストールと環境の設定
ソースから Qt をビルドするには、サポートされているコンパイラと様々なビルドツールがあるビルド環境が必要です。
ビルドツール
ツール | 対応バージョン | 対応バージョン |
---|---|---|
CMake | バージョン 3.16 以降(-debug-and-release ビルドは 3.17 以降、-static ビルドは 3.21 以降)。 | Qt ビルドの設定に必要です。Qt Online Installer およびcmake.org で入手できます。 |
忍者 | - | Qt をビルドするための推奨ツール。Qt Online Installer とninja-build.org で入手できます。 |
Python | バージョン 3 | 必須のビルドツール。Windowsインストーラはpython.orgまたはMicrosoft Storeから入手できます。 |
実行ファイルcmake.exe
,ninja.exe
,python.exe
がビルド環境で利用可能でなければなりません。それぞれのディレクトリをPATH
環境変数に追加してください。
コンパイラー
Qt 6.8 では以下のコンパイラと設定がサポートされています:
オペレーティングシステム | アーキテクチャ | コンパイラ | 備考 |
---|---|---|---|
Windows 10 (1809 以降) | x86_64 | MSVC 2022、Mingw-w64 13.1 | |
Windows 11 | x86_64 | MSVC 2022、Mingw-w64 13.1 | |
ARM上のWindows | ARM64 | MSVC 2022 |
注意: 現在 Qt は Windows on ARM デバイスの ARM64EC をサポートしていません。
QDoc の依存関係
QDoc はClang を使って C++ コードを解析します。QDoc を手動でビルドする場合は、Installing Clang for QDocでビルドの必要条件を参照してください。
Qt GRPC および の依存関係Qt Protobuf
Qt GRPCと Qt ProtobufにはgRPC
とProtobuf
パッケージのインストールが必要です。これらのパッケージのインストール手順は、vcpkgを使用したWindowsのインストール例にあります。
環境の設定
MSVCの場合は、以下のいずれかを行う:
- vcvarsall.batを実行する:
"C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64
- Windows の検索バーで VS Native Tools コマンドプロンプトを検索します。
Mingw-w64の場合:Mingw-w64 をPATH
環境変数に追加します:
Set PATH=C:\qt\tools\mingw1120_64\bin;%PATH%
ステップ 3: Qt ライブラリとツールのビルド
ビルドを設定するには、ビルドディレクトリを作成し、このディレクトリでconfigure.bat
スクリプトを実行します:
mkdir C:\dev\qt-build cd C:\dev\qt-build C:\dev\Qt\src\configure.bat
デフォルトでは、Qt はC:\Qt\Qt-major.minor.patch
ディレクトリにインストールされるように設定されています。major.minor.patch のトリプレットは、ビルドされる Qt のバージョンを表しています。これは-prefix
オプションで変更できます。Qt の設定オプションのリストを見て、さらに微調整してください。
次に、ライブラリとツールをビルドします:
cmake --build . --parallel
--build
の後のピリオドは現在のフォルダを意味します。
ビルド後、ライブラリとツールを希望のパスにインストールする必要があります(開発者ビルドを有効にした場合を除く):
cmake --install .
ステップ 4: アプリケーションのビルド
Qt がインストールされたら、アプリケーションのビルドを開始します。
コマンドラインから作業する場合は、次のように Qt ツールをPATH
環境変数に追加してください:
set PATH=C:\Qt\Qt-major.minor.patch\bin;%PATH%
IDE から Qt を使用する場合は、Qt のバージョンを明示的に登録する必要があります。Qt Creator についてはQt Creator: Qt バージョンの追加 を参照してください。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.