Linux 向け Qt - ソースからのビルド

このページでは、Linux 向けの 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.12.0/Src ）に配置されます。

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

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

ステップ 2: ビルドに必要な依存関係をインストールする

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

ビルドツール

コンパイラおよび開発パッケージ

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

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

また、Qtはさまざまなライブラリや開発パッケージの可用性に依存しており、これらは通常、各ディストリビューションのパッケージマネージャーによってインストールされます。詳細については、「Qt for Linux - 要件」を参照してください。

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

ビルドを設定するには、ビルド用ディレクトリを作成し、そのディレクトリ内で `./configure ` スクリプトを実行します。

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

デフォルトでは、Qtは/usr/local/Qt-6.12.0 ディレクトリにインストールされるように設定されています。これは、-prefix オプションを使用することで変更できます。さらに詳細な設定を行うには、configureオプションの一覧を参照してください。

configure は正常に実行されましたか？ そうであれば、ライブラリとツールのビルドに進んでください:

cmake --build . --parallel

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

cmake --install .

なお、これにはroot権限が必要になる場合があります。

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

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

コマンドラインから作業する場合は、QtツールをデフォルトのPATH に追加することを検討してください。その手順は以下の通りです：

.profile ファイル（シェルが bash、ksh、zsh、または sh の場合）に、以下の行を追加します：

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

.login ファイルに（シェルが csh または tcsh の場合）、次の行を追加します:

setenv PATH /usr/local/Qt-6.12.0/bin:$PATH

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

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