Linux/X11用Qt - ソースからのビルド
このページでは、Qt for Linux/X11 をソースからビルドする方法について説明します。通常、ビルド済みの Qt ライブラリとツールは Qt Online Installer.多くの Linux ディストリビューションも、パッケージマネージャを通して Qt パッケージを提供しています。しかし、Qt をさらにカスタマイズしたい場合や、Qt のバイナリパッケージ(適切なバージョン)がないディストリビューションを使用している場合は、ソースから Qt をビルドしてください。
ディストリビューションのパッケージ担当者は、Qt のパッケージング方法に関する詳細な情報を、パッケージングに関する推奨事項で見つけることができます。
ステップ 1: ソースの入手
Qt のソースはQt Online Installer からインストールできます。ソースパッケージはGit やQt アカウント(商用ユーザー)、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.6 | x86_64 | GCC 10 (ツールセット) | |
レッドハット 8.8 | x86_64 | GCC 10 (ツールセット) | |
赤い帽子 8.10 | x86_64 | GCC 10 (ツールセット) | |
赤い帽子 9.2 | x86_64 | GCC 11 | |
赤い帽子 9.4 | x86_64 | GCC 11 | |
openSUSE 15.5 | x86_64 | GCC 9 | |
SUSE Linux Enterprise Server 15 SP5 | x86_64 | GCC 10 | |
Ubuntu 22.04 | x86_64 | Canonicalが提供するGCC、GCC 11.x | |
Ubuntu 24.04 | x86_64, arm64 | Canonicalが提供するGCC、GCC 13.x | 注を参照してください。 |
Debian 11.6 | x86_64, arm64 | GCC 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.