CMake 変数リファレンス
Qt ビルド変数
Qt をビルドする際に、CMake 変数を使用してビルド結果を制御することができます。
| 変数 | 説明 |
|---|---|
| QT_HOST_PATH | Qt をビルドする際に、ホストツールを使用する Qt のインストール場所。 |
QT_FORCE_BUILD_TOOLS | ホストツールが既に見つかっている場合でも、ツールを強制的にビルドします。Qt をクロスコンパイルする際に、SDK にクロスビルドされたツールがあることを確認するのに便利です。 |
QT_FORCE_FIND_TOOLS | クロスコンパイルしない場合は、QT_HOST_PATH にあらかじめビルドされている Qt ツールを使用します。この変数は、QT_FORCE_BUILD_TOOLS がON に設定されている場合にのみ有効になります。それ以外の場合、QT_FORCE_FIND_TOOLS はデフォルトの動作に影響しません。 |
モジュール変数
find_package でロードされた Qt モジュールは様々な変数を設定します。
注意： これらの変数に直接アクセスする必要はほとんどありません。モジュールに対するリンクのような一般的なタスクは、各モジュールが定義しているライブラリターゲットを通して行う必要があります。
例えば、find_package(Qt6 COMPONENTS Widgets) が成功すると、以下の変数が利用可能になります：
| 変数 | 説明 |
|---|---|
Qt6Widgets_COMPILE_DEFINITIONS | ライブラリに対してビルドするときに使用するコンパイル定義のリスト。 |
Qt6Widgets_DEFINITIONS | ライブラリに対してビルドするときに使用する定義のリスト。 |
Qt6Widgets_EXECUTABLE_COMPILE_FLAGS | ライブラリに対して実行可能ファイルをビルドするときに使用するフラグの文字列。 |
Qt6Widgets_FOUND | モジュールが正常に見つかったかどうかを示すブール値。 |
Qt6Widgets_INCLUDE_DIRS | ライブラリに対してビルドするときに使用するインクルード・ディレクトリのリスト。 |
Qt6Widgets_LIBRARIES | モジュールのインポートターゲットの名前：Qt6::Widgets |
Qt6Widgets_PRIVATE_INCLUDE_DIRS | ライブラリに対してビルドし、プライベートな Qt API を使用するときに使用する、プライベートなインクルードディレクトリのリスト。 |
Qt6Widgets_VERSION | モジュールのバージョンを含む文字列。 |
find_package で見つかるすべてのパッケージについて、これらの変数と同等のものが利用可能です。
インストール変数
さらに、特定のパッケージではなく、Qt のインストールそのものに関連する変数もあります。
| 変数 | 説明 |
|---|---|
| Qt 5 と Qt 6 のプロジェクトが混在している場合に、qt_ コマンドが転送する Qt のバージョンを制御する整数です。find_package() を呼び出す前に、5 か6 を設定する必要があります。
設定されていない場合、最初の |
QT_LIBINFIX | Qt が-libinfix で設定されている場合に、ライブラリ名に使用される infix を保持する文字列です。 |
| qt_ で始まるコマンドを非表示にし、qt6_ で始まるバージョン管理されたコマンドのみを残します。 |
| Qt:: で始まるインポートされたターゲットを非表示にします。代わりに、Qt6:: で始まるターゲットを使用する必要があります。 |
QT_VISIBILITY_AVAILABLE | Unix では、Qt ライブラリとプラグインが-fvisibility=hidden でコンパイルされたかどうかを示すブール値です。これは、選択されたシンボルのみがエクスポートされることを意味します。 |
プロジェクト変数
これらの変数は、Qt が提供する CMake コマンドに影響を与えます。プロジェクト、ツールチェーンファイル、サードパーティパッケージによって設定されます。
Qt6::Core
ホストシステムの Android 固有のアーキテクチャ | |
Android SDKの場所 | |
プロジェクトパッケージがビルドされるABIのリスト | |
Androidアプリケーションに渡す引数のリスト | |
自動検出された Qt for Android SDK のリストを使用してマルチ ABI パッケージをビルドできるようにします。 | |
ビルドの種類に関係なく、リリースパッケージの署名を強制または無効にします。 | |
QtQuickViewContent ベースのクラスを生成可能 | |
マルチ ABI ビルドで CMake 変数を共有できます。 | |
指定したキーストア、エイリアス、ストアパスワードで .aab パッケージに署名します。 | |
指定されたキーストア、エイリアス、ストアパスワードでパッケージに署名します。 | |
一部のターゲットプラットフォームでランタイムバイナリを展開するためのプレフィックス相対サブディレクトリ | |
ランタイム依存関係の検索から除外されるディレクトリ | |
一部のターゲットプラットフォームでプログラム実行ファイルを配置するためのプレフィックス相対サブディレクトリ | |
一部のターゲットプラットフォームでライブラリを配置するためのプレフィックス相対サブディレクトリ | |
一部のターゲットプラットフォームで Qt プラグインをデプロイするためのプレフィックス相対サブディレクトリ | |
デプロイのベースとなる場所 | |
いくつかのターゲットプラットフォームで QML プラグインを配置するための、プレフィックスに関連するサブディレクトリ | |
デプロイサポートを設定するためにインクルードするファイル名 | |
一部のターゲット プラットフォームで Qt トランスレーションをデプロイするための、プレフィックスに関連するサブディレクトリです。 | |
デプロイツールの冗長モードを有効にする | |
クロスコンパイル時のホスト Qt インストールの場所 | |
翻訳可能な文字列の言語を指定します。 | |
プロジェクトの国際化に使用する言語のリスト | |
すべてのターゲットで使用される iOS 起動画面のストーリーボードへのパス | |
Android デプロイ時にプロジェクトでビルドされた共有ライブラリターゲットの収集を防ぐ | |
Android デプロイ時にインポートされたターゲットの収集を防止 | |
iOSのターゲット確定時にフォールバックアプリバンドルIDの提供を無効にする | |
iOS でのターゲットの確定時に、フォールバック チーム ID の提供を無効にする | |
qt_standard_project_setup()を呼び出した後に変更が加えられないようにする | |
対応する ABI の Qt for Android へのパスを指定する変数のセット | |
ターゲット Android ごとのビルドディレクトリの使用を可能にする |
Qt6::InterfaceFramework
すべてのifcodegen関数で冗長ロギングを有効にする | |
ifcodegen テンプレートの検索パス |
Qt6::Multimedia
iOS で FFmpeg のコード署名を無効にする |
Qt6::Qml
の .qmlls.ini ファイルの自動生成を有効にするQML Language Server | |
QML ファイルのバイトコードまたは C++ コードへのコンパイルを無効にする | |
QMLモジュールがデフォルトで作成されるベース出力ディレクトリ |
標準 CMake 変数
| cmake_autogen_better_graph_multi_config | マルチコンフィギュレーションジェネレータの依存関係グラフを改善します。 |
© 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.
