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

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

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

Qtのソースコードは、Qt Online Installer からインストールできます。ソースパッケージは、Git経由、Qtアカウント（商用ユーザー向け）のアーカイブ、およびdownload.qt.io（オープンソースユーザー向け）からも入手可能です。

Qt Online Installer からソースをインストールした場合、ソースは Qt のインストールディレクトリ（例： C:\Qt\6.12.0\Src。

ソースアーカイブをダウンロードした場合は、任意のディレクトリ（例：C:\dev\Qt\src ）に解凍してください。

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

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

ビルドツール

ビルド環境には、cmake.exe 、ninja.exe 、およびpython.exe という実行ファイルが存在している必要があります。それぞれのディレクトリを、PATH 環境変数に追加してください。

コンパイラ

Qt 6.12 では、以下のコンパイラおよび構成がサポートされています:

QDoc の依存関係

QDoc はC++ コードの解析に Clang を使用します。QDoc を手動でビルドする場合は、「QDoc 用の Clang のインストール」を参照して、具体的なビルド要件を確認してください。

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

Qt GRPC および Qt ProtobufgRPC および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 の場合: 環境変数 `PATH ` に `Mingw-w64` を追加します:

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の3つの数値はビルドされるQtのバージョンを表します。これは-prefix オプションを使用して変更できます。さらに調整するには、「Qt設定オプションの一覧」を参照してください。

次に、ライブラリとツールをビルドします:

cmake --build . --parallel
# or
ninja

--build の後のピリオドは、現在のフォルダを意味します。

ビルド後、ライブラリとツールを目的のパスにインストールする必要があります（開発者向けビルドを有効にしていない場合）：

cmake --install .
# or
ninja install

ステップ 4: アプリケーションのビルド

Qtのインストールが完了したら、Qtを使用してアプリケーションのビルドを開始できます。

コマンドラインで作業する場合は、次のようにPATH 環境変数にQtツールを追加することを検討してください:

set PATH=C:\Qt\Qt-major.minor.patch\bin;%PATH%

IDE からアプリケーションをビルドする場合は、その IDE で Qt のバージョンを明示的に登録する必要があります。

• Qt Creator の場合は、Qt Creator の「Qt バージョンの追加」を参照してください。
• Qt Extension for Visual Studio Code については、Qt Extension for Visual Studio Code の「Qt インストールの登録」を参照してください。