CMake 変数リファレンス

Qt ビルド変数

Qt をビルドする際、CMake 変数を使用してビルド結果を制御することができます。

変数	説明
QT_HOST_PATH	通常のビルドまたはクロスコンパイルのいずれにおいても、別の Qt ビルド中にホストツールを使用できるホスト側の Qt インストール先のパスです。
`QT_FORCE_BUILD_TOOLS`	ホストツールがすでに検出されている場合でも、ビルドツールの使用を強制します。Qt をクロスコンパイルする際、SDK にクロスビルドされたツールが含まれていることを確認するために役立ちます。
`QT_FORCE_FIND_TOOLS`	クロスコンパイルを行わない場合、`QT_HOST_PATH` にあるプリビルド済みの Qt の 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_DEFAULT_MAJOR_VERSION`	Qt 5 と Qt 6 のプロジェクトが混在している場合に、`qt_` コマンドが転送する Qt バージョンを制御する整数です。それぞれの`find_package()` を呼び出す前に、`5` または`6` のいずれかに設定する必要があります。 `5` に設定した場合、`qt_` で始まるコマンドは、`qt5_` で始まる対応するコマンドを呼び出します。`6` に設定した場合、`qt6_` で始まる対応するコマンドを呼び出します。設定されていない場合、最初の`find_package` の呼び出しがデフォルトのバージョンを定義します。
`QT_LIBINFIX`	Qt が`-libinfix` で構成されている場合、ライブラリ名で使用される接頭辞を格納する文字列。
`QT_NO_CREATE_VERSIONLESS_FUNCTIONS`	`qt_` で始まるコマンドを非表示にし、`qt6_` で始まるバージョン付きコマンドのみを残します。
`QT_NO_CREATE_VERSIONLESS_TARGETS`	`Qt::` で始まるインポートされたターゲットを非表示にします。代わりに、`Qt6::` で始まるターゲットを使用する必要があります。
`QT_VISIBILITY_AVAILABLE`	Unix では、Qt ライブラリおよびプラグインが`-fvisibility=hidden` でコンパイルされたかどうかを示すブール値です。これは、選択されたシンボルのみがエクスポートされることを意味します。

プロジェクト変数

これらの変数は、Qt が提供する CMake コマンドに影響を与える可能性があります。これらは、プロジェクト、ツールチェーンファイル、またはその他のサードパーティ製パッケージによって設定される場合があります。

`Qt6::Core`

ANDROID_NDK_HOST_SYSTEM_NAME	ホストシステムの Android 固有のアーキテクチャ
ANDROID_SDK_ROOT	Android SDKの場所
QT_ANDROID_ABIS	プロジェクトのパッケージがビルドされる対象となる ABI のリスト
QT_ANDROID_APPLICATION_ARGUMENTS	Androidアプリケーションに渡す引数のリスト
QT_ANDROID_BUILD_ALL_ABIS	自動検出された「Qt for Android SDK」リストを使用して、マルチABIパッケージのビルドを有効にします
QT_ANDROID_CREATE_SYMLINKS_ONLY	Gradle プロジェクトディレクトリ下の依存関係に対してのみシンボリックリンクを作成する
QT_ANDROID_DEPLOYMENT_TYPE	ビルドタイプに関係なく、リリースパッケージの署名を強制または無効にする
QT_ANDROID_GENERATE_JAVA_QTQUICKVIEW_CONTENTS	QtQuickViewContent ベースのクラスの生成を有効にする
QT_ANDROID_GRADLE_MULTI_MODULE	マルチモジュール Gradle プロジェクトから Android パッケージをビルドする
QT_ANDROID_MULTI_ABI_FORWARD_VARS	マルチABIビルドでCMake変数を共有できるようにします
QT_ANDROID_POST_BUILD_GRADLE_CLEANUP	Androidパッケージの作成後にGradleのクリーンアップを実行する
QT_ANDROID_SIGN_AAB	指定されたキーストア、エイリアス、およびストアパスワードを使用して .aab パッケージに署名します
QT_ANDROID_SIGN_APK	指定されたキーストア、エイリアス、およびストアパスワードを使用してパッケージに署名します
QT_DEPLOY_BIN_DIR	一部のターゲットプラットフォーム上でランタイムバイナリをデプロイするための、プレフィックス相対のサブディレクトリ
QT_DEPLOY_IGNORED_LIB_DIRS	ランタイム依存関係の検索から除外されるディレクトリ
QT_DEPLOY_LIBEXEC_DIR	一部のターゲットプラットフォームでプログラムの実行ファイルをデプロイするための、プレフィックス相対のサブディレクトリ
QT_DEPLOY_LIB_DIR	一部のターゲットプラットフォームでライブラリをデプロイするための、プレフィックス相対のサブディレクトリ
QT_DEPLOY_PLUGINS_DIR	一部のターゲットプラットフォーム上で Qt プラグインを展開するための、プレフィックス相対のサブディレクトリ
QT_DEPLOY_PREFIX	デプロイのベースディレクトリ
QT_DEPLOY_QML_DIR	一部のターゲットプラットフォームにおける QML プラグインのデプロイ用の、プレフィックス相対のサブディレクトリ
QT_DEPLOY_SUPPORT	デプロイメントサポートの設定に含めるファイル名
QT_DEPLOY_TRANSLATIONS_DIR	一部のターゲットプラットフォームにおける Qt 翻訳のデプロイ用のプレフィックス相対サブディレクトリ
QT_ENABLE_VERBOSE_DEPLOYMENT	デプロイメントツールの詳細モードを有効にする
QT_HOST_PATH	クロスコンパイル時のホストQtのインストール場所
QT_I18N_SOURCE_LANGUAGE	翻訳可能な文字列の言語を指定します
QT_I18N_TRANSLATED_LANGUAGES	プロジェクトの国際化に使用する言語の一覧
QT_IOS_LAUNCH_SCREEN	すべてのターゲットで使用される iOS 起動画面ストーリーボードへのパス
QT_NO_COLLECT_BUILD_TREE_APK_DEPS	Androidデプロイ時に、プロジェクトでビルドされた共有ライブラリターゲットの収集を防止します
QT_NO_COLLECT_IMPORTED_TARGET_APK_DEPS	Android デプロイ時に、インポートされたターゲットが収集されないようにする
QT_NO_SET_XCODE_BUNDLE_IDENTIFIER	iOS でのターゲットの確定時に、フォールバックのアプリバンドル ID の指定を無効化します
QT_NO_SET_XCODE_DEVELOPMENT_TEAM_ID	iOS でのターゲットの最終化時に、フォールバックのチーム ID の指定を無効にする
QT_NO_STANDARD_PROJECT_SETUP	qt_standard_project_setup() へのその後の呼び出しによる変更を防止する
QT_PATH_ANDROID_ABI_<ABI>	対応する ABI 用の Qt for Android へのパスを指定する変数のセット
QT_USE_TARGET_ANDROID_BUILD_DIR	ターゲットごとの Android ビルドディレクトリの使用を有効にする

`Qt6::InterfaceFramework`

IFCODEGEN_VERBOSE	すべての ifcodegen 関数に対して詳細ログ出力を有効にする
QT_IFCODEGEN_TEMPLATE_SEARCH_PATH	ifcodegen テンプレートの検索パス

`Qt6::Multimedia`

QT_NO_FFMPEG_XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY

iOS での FFmpeg コード署名を無効にする

`Qt6::Qml`

QT_QMLLINT_CONTEXT_PROPERTY_DUMP	lint ターゲットでのコンテキストプロパティのダンプを有効にする
QT_QML_GENERATE_AOTSTATS	QML コンパイラの統計情報の収集を有効にするかどうかを制御します
QT_QML_GENERATE_QMLLS_INI	以下の .qmlls.ini ファイルの自動生成を有効にするQML Language Server
QT_QML_GENERATE_QMLLS_INI_NO_CMAKE_CALLS	.qmlls.ini ファイル内の no-cmake-calls の値をカスタマイズするQML Language Server
QT_QML_NO_CACHEGEN	QML ファイルのバイトコードまたは C++ コードへのコンパイルを無効化
QT_QML_NO_QML_PREVIEW (global property)	Qt6::Qml にリンクする実行ファイルに対して、qmlpreview のサポートが自動的に設定されるかどうかを制御します
QT_QML_OUTPUT_DIRECTORY	デフォルトで QML モジュールが作成されるベース出力ディレクトリ

標準の CMake 変数

CMAKE_AUTOGEN_BETTER_GRAPH_MULTI_CONFIG

マルチコンフィギュレーションジェネレータの依存関係グラフを改善します

CMake コマンドリファレンス CMake プロパティリファレンス

© 2026 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.