最適化された Qt のビルド

このページでは、特定のニーズに合わせて、より軽量でカスタマイズされた Qt を設定し、ビルドする手順について説明します。

ステップ 1: ソースコードの入手、ビルドに必要な依存関係のインストール、および環境の設定

ソースコードの入手、依存関係のインストール、および環境設定については、各プラットフォーム固有の手順を参照してください：

• Windows 向け Qt - ソースからのビルド
• macOS 向け Qt - ソースからのビルド
• Linux 版 Qt - ソースからのビルド
• 組み込みLinuxデバイスの設定
• Android 向け Qt - ソースからのビルド
• iOS向けQt - ソースからのビルド

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

プラットフォーム固有の手順に従い、以下のQt 設定オプションを使用して、ニーズに合わせて最適化されたビルドを作成してください。

次の表では、ビルドサイズを縮小するのに役立つ configure オプションについて、より詳しく説明しています。

さらに、「機能の包含または除外」で説明されているように、機能を1つずつ削除することもできます。これにより、利用可能なコンポーネントや機能に制限が生じる可能性があります。すべての組み合わせがテストされているわけではありません。 Qt Test は、継続的インテグレーション（CI）システムにおいて、特定の最小限の configure オプションの組み合わせをテストしています。具体的には、高度に最小化された組み込み Linux 構成と、その他のプラットフォーム向けのやや最小化度が低い構成をテストしています。これらの構成は、Quick アプリケーションを実行するためのものです。

Qtのconfigureコマンドは、-- （ダブルダッシュ）というコマンドライン引数もサポートしており、これによりユーザーは-DCMAKE_CXX_FLAGS="-march=native"などの追加のCMake引数を指定できます。 クロスコンパイルの場合、これらのパラメータは、「ツールチェーンファイルの例」に記載されているように、`-DCMAKE_TOOLCHAIN_FILE=path/to/toolchain.cmake` を通じて追加できます。以下の表に、GCCで使用を検討できるオプションをいくつか示します：

以下の表にリンカーオプションを一覧で示します：

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

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

CMakeプロジェクトコマンドを使用して、QMLコード生成を最適化します。QMLコード生成の詳細については、「qt_add_qml_module」および「QMLとQt Quick のベストプラクティス」を参照してください。

以下の CMake コードスニペットにあるコマンドを実行すると、バイナリのサイズを小さくできます：

set_target_properties(
        ExampleApp
    PROPERTIES
        QT_QMLCACHEGEN_ARGUMENTS "--only-bytecode"
)

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

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

コマンドラインを使用してアプリケーションをビルドする場合は、プラットフォーム固有のガイドに従ってください。