Qt for Windows - ソースからのビルド

このページでは、Qt for Windows の設定とビルドの手順について説明します。ビルド済みの Qt for Windows をダウンロードしてインストールするには、「Qt を始める」のページの指示に従ってください。

ステップ 1: ソースの入手

Qt のソースはQt Online Installer からインストールできます。ソースパッケージはGitQt アカウント(商用ユーザー)、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 Installerninja-build.org で入手できます。
Pythonバージョン 3必須のビルドツール。Windowsインストーラはpython.orgまたはMicrosoft Storeから入手できます。

実行ファイルcmake.exe,ninja.exe,python.exe がビルド環境で利用可能でなければなりません。それぞれのディレクトリをPATH 環境変数に追加してください。

コンパイラー

Qt 6.8 では以下のコンパイラと設定がサポートされています:

オペレーティングシステムアーキテクチャコンパイラ備考
Windows 10 (1809 以降)x86_64MSVC 2022、Mingw-w64 13.1
Windows 11x86_64MSVC 2022、Mingw-w64 13.1
ARM上のWindowsARM64MSVC 2022

注意: 現在 Qt は Windows on ARM デバイスの ARM64EC をサポートしていません。

QDoc の依存関係

QDoc はClang を使って C++ コードを解析します。QDoc を手動でビルドする場合は、Installing Clang for QDocでビルドの必要条件を参照してください。

Qt GRPC および の依存関係Qt Protobuf

Qt GRPCQt ProtobufにはgRPCProtobuf パッケージのインストールが必要です。これらのパッケージのインストール手順は、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.