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

必要条件

Qt をビルドするには、システムに macOS プラットフォーム SDK および対応するツールチェーンがインストールされている必要があります。これらは、「ビルド環境」に記載されている手順に従って Xcode をインストールすることで入手できます。

Qt がビルドする構成で確実にテストされていることを保証するため、「サポートされている構成」に記載されているものとまったく同じバージョンの Xcode および SDK を常に使用する必要があります。

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

• CMake (>=3.25)
• Ninja

ビルドを行う場合は Qt WebEngine または Qt PDFをビルドする場合は、以下の追加の依存関係が必要になります：

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

QDocの依存関係

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

ビルドの手順

以下の手順では、ソースパッケージから Qt をビルドする方法について説明します。Qt のソースコードは「ダウンロード」ページからダウンロードできます。詳細については、「Qt のはじめ方」ページをご覧ください。

手順 1: アーカイブの解凍

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

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

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

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

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

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

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

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

「アーキテクチャ」で説明されているように、Qt はデフォルトで開発マシンのアーキテクチャ向けにビルドされます。Intel および Apple Silicon Mac の両方をサポートする Qt のユニバーサルビルドを設定するには、次の引数を追加してください:

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

Intelアーキテクチャ（「x86_64」）を最初に指定するように注意してください。そうしないと、Qtがx86の機能をすべて有効にできない可能性があります。

また、Qt はデバッグシンボルを含めてビルドされるように設定することもできます。このプロセスについては、「デバッグ手法」ドキュメントに詳しく説明されています。

「Configure オプション」ページには、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 のインストールは完了です。