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

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

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

Qt のソースは Qt Online Installer でインストールすることができます。ソースパッケージはGitQt アカウント(商用ユーザー)、download.qt.io(オープンソースユーザー)からも入手できます。

Qt オンラインインストーラーからインストールした場合、ソースは Qt のインストールディレクトリC:\Qt\6.8.0\Src にあります。

ソースアーカイブをダウンロードした場合は、好きなディレクトリに解凍してください(例:C:\dev\Qt\src )。

注意: ソースディレクトリへのパスには、スペースやWindows特有のファイルシステム文字を含んではいけません。また、パスは短くしてください。これにより、コンパイル段階でファイルパスが長すぎる問題を防ぐことができる。

ステップ 2: ビルド要件のインストールと環境の設定

ソースから Qt をビルドするには、サポートされているコンパイラと様々なビルドツールがあるビルド環境が必要です。

ビルドツール

ツール対応バージョン対応バージョン
CMakeバージョン 3.16 以降(-debug-and-release ビルドは 3.17 以降、-static ビルドは 3.21 以降)。Qt ビルドの設定に必要です。Qt オンラインインストーラーと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_64MSVC 2022、MSVC 2019、Mingw-w64 13.1
Windows 11x86_64MSVC 2022、MSVC 2019、Mingw-w64 13.1
ARM上のWindowsarm64MSVC 2019/2022技術プレビュー

注: Windows on ARMはデプロイメントターゲットとしてのみサポートされています。アプリケーションはx86-64 Windowsマシンからクロスコンパイルし、ターゲットにデプロイする必要がある。

QDocの依存関係

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

Qt GRPC と Qt Protobuf の依存関係

Qt GRPCQt ProtobufgRPCProtobuf パッケージをインストールする必要があります。これらのパッケージのインストール手順は、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 Creator では、Qt Creator:Qt バージョンの追加 を参照してください。

©2024 The Qt Company Ltd. ここに含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 ここで提供されるドキュメントは、Free Software Foundation によって発行されたGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。