macOS 用 Qt - ソースからのビルド

必要条件

Qtをビルドするには、macOSプラットフォームSDKと対応するツールチェーンがシステムにインストールされている必要があります。これは、Qt for macOS#ビルド環境で説明されているように、Xcodeをインストールすることで入手できます。

Qtfor macOS#Supported Versionsに記載されているXcodeとSDKのバージョンと全く同じものを常に使用し、ビルドする構成でQtがテストされていることを確認する必要があります。

Xcode に加えて、以下の依存関係がパスに入っていることを確認する必要がありますPATH.

• CMake (>=3.16, >= 3.18.4 for Ninja Multi-Config, >= 3.21.1 for static Qt builds or building for Apple platforms)
• 忍者

Qt WebEngineやQt PDF をビルドする場合は、以下の依存関係が必要です：

• Python html5lib
• Bison、Flex
• Gperf
• Node.js バージョン 8 以降（バージョン 12 推奨）

QDocの依存関係

QDocはClangを使ってC++コードを解析する。QDocを手動でビルドする場合は、QDoc用のClangのインストールを参照して、特定のビルド要件を確認してください。

ビルドの手順

以下の手順では、ソースパッケージから Qt をビルドする方法を説明します。Qt のソースはDownloadsページからダウンロードできます。詳細については、Qt入門のページを参照してください。

ステップ 1: アーカイブを解凍する

まだ解凍していない場合は、アーカイブを解凍してください。例えば、qt-everywhere-src-6.8.0.tar.xz パッケージをお持ちの場合、コマンドラインプロンプトで以下のコマンドを入力してください：

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

これにより、アーカイブのファイルを含むディレクトリ/tmp/qt-everywhere-src-6.8.0 が作成されます。

ステップ 2: Qt ライブラリのビルド

マシンのタイプに合わせて Qt ライブラリを設定するには、ビルド用のディレクトリを作成し、そこに移動します。このディレクトリで./configure スクリプトを実行してください。

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

デフォルトでは、Qt は/usr/local/6.8.0 ディレクトリにインストールされるように設定されていますが、-prefix オプションを使って変更することができます。

デフォルトでは、Qt はフレームワークとしてビルドされますが、-no-framework オプションを指定することで、ダイナミックライブラリ（dylibs）のセットとしてビルドすることができます。

Qt for macOS#アーキテクチャ」で説明するように、Qt はデフォルトで開発マシンのアーキテクチャに合わせてビルドされます。Intel と Apple Silicon Mac の両方をサポートする Qt のユニバーサルビルドを設定するには、以下の引数を追加します：

./configure -- -DCMAKE_OSX_ARCHITECTURES="x86_64;arm64"

注意：ユニバーサルビルドは常に開発マシンのアーキテクチャを指定する必要があります。

Qt はデバッグシンボルと共にビルドされるように設定することもできます。この手順については、「デバッグのテクニック」で詳しく説明しています。

Configure Optionsページに configure オプションの詳細があります。

ライブラリを作成し、すべてのサンプルとツールをコンパイルするには、次のように入力します：

cmake --build . --parallel

-prefix がビルド・ディレクトリーの外にある場合は、ライブラリー、サンプル、ツールを適切な場所にインストールする必要があります。これを行うには、次のように入力します：

cmake --install .

このコマンドを実行するには、マシンの管理者権限が必要です。

ステップ 3: 環境変数の設定

Qt を使うためには、いくつかの環境変数を拡張する必要があります。

PATH               - to locate qmake, moc and other Qt tools

これは次のように行います：

.profile (お使いのシェルが bash の場合)、または.zshenv (zsh の場合) に以下の行を追加します：

PATH=/usr/local/Qt-%VERSION%/bin:$PATH
export PATH

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

setenv PATH /usr/local/Qt-%VERSION%/bin:$PATH

別のシェルを使用している場合は、それに応じて環境変数を変更してください。

これで Qt がインストールされました。