Linux/X11用Qt - ソースからのビルド

このページでは、Qt for Linux/X11 をソースからビルドする方法について説明します。通常、ビルド済みの Qt ライブラリとツールは Qt Online Installer.多くの Linux ディストリビューションも、パッケージマネージャを通して Qt パッケージを提供しています。しかし、Qt をさらにカスタマイズしたい場合や、Qt のバイナリパッケージ(適切なバージョン)がないディストリビューションを使用している場合は、ソースから Qt をビルドしてください。

ディストリビューションのパッケージ担当者は、Qt のパッケージング方法に関する詳細な情報を、パッケージングに関する推奨事項で見つけることができます。

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

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

ソースをQt Online Installer からインストールした場合、Qt のインストールディレクトリ$HOME/Qt/6.8.2/Src などで利用できます。

単一のソース・アーカイブをダウンロードした場合は、任意のディレクトリに解凍してください:

cd /tmp
tar xf ~/Downloads/qt-everywhere-src-6.8.2.tar.xz

ステップ 2: ビルド要件のインストール

Qt をビルドするには、ツール、コンパイラ、開発パッケージなどのビルド環境が必要です。

ビルドツール

ツール対応バージョン
CMakeバージョン 3.16 以降(-static ビルドは 3.21 以降)。
忍者-
Pythonバージョン 3

注意: configure は、ninja 実行ファイルが利用可能な場合、常にNinjaジェネレータとビルドツールを使用します。Ninjaはクロスプラットフォームで、機能が豊富で、パフォーマンスが高く、すべてのプラットフォームで推奨されています。他のジェネレータを使っても動くかもしれませんが、公式にはサポートされていません。

コンパイラと開発パッケージ

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

ディストリビューションアーキテクチャコンパイラ備考
Red Hat 8.6x86_64GCC 10 (ツールセット)
レッドハット 8.8x86_64GCC 10 (ツールセット)
赤い帽子 8.10x86_64GCC 10 (ツールセット)
赤い帽子 9.2x86_64GCC 11
赤い帽子 9.4x86_64GCC 11
openSUSE 15.5x86_64GCC 9
SUSE Linux Enterprise Server 15 SP5x86_64GCC 10
Ubuntu 22.04x86_64Canonicalが提供するGCC、GCC 11.x
Ubuntu 24.04x86_64, arm64Canonicalが提供するGCC、GCC 13.x注を参照してください。
Debian 11.6x86_64, arm64GCC 10技術プレビュー

こちらも参照してください:エンタープライズ Qt Debian パッケージ

注意: デスクトップ上の Linux on Arm については、8GB RAM を搭載した Raspberry Pi 5 と Ubuntu 24.04 をリファレンスプラットフォームとして使用しています。他のハードウェアで問題が発生した場合は、Raspberry Pi 5 で問題を再現してみてください。より幅広いARMベースのデスクトップ・ハードウェアが利用可能になった時点で、通常のプラットフォームのサポートに移行する予定です。

他のコンパイラや構成でも動作する可能性がありますが、積極的にはテストしていません。

Qt はまた、様々なライブラリや開発パッケージの利用可能性に依存しており、これらは通常、それぞれの解像度のパッケージマネージャによってインストールされます。詳細はQt for X11 Requirementsを参照してください。

ステップ 3: Qt ライブラリとツールのビルド

ビルドを設定するには、ビルドディレクトリを作成し、このディレクトリで./configure スクリプトを実行してください:

mkdir -p ~/dev/qt-build
cd ~/dev/qt-build
/tmp/qt-everywhere-src-6.8.2/configure

デフォルトでは、Qt は/usr/local/Qt-6.8.2 ディレクトリにインストールされるように設定されています。これは-prefix オプションで変更できます。configure オプションのリストを見て、さらに微調整してください。

configure は正常に実行されましたか?ライブラリやツールのビルドを進めてください:

cmake --build . --parallel

ビルド後、ライブラリとツールを適切な場所にインストールする必要があります(開発者ビルドを有効にした場合を除く):

cmake --install .

これにはroot権限が必要な場合があることに注意してください。

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

Qtをインストールしたら、アプリケーションのビルドを開始します。

コマンドラインから作業する場合は、デフォルトのPATH に Qt ツールを追加してください。これは以下のように行います:

.profile (シェルが bash、ksh、zsh、または sh の場合)で、以下の行を追加します:

PATH=/usr/local/Qt-6.8.2/bin:$PATH
export PATH

.login (シェルがcshまたはtcshの場合)に、以下の行を追加する:

setenv PATH /usr/local/Qt-6.8.2/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.