CMake 変数リファレンス

Qt ビルド変数

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

変数説明
QT_HOST_PATHQt をビルドする際に、ホストツールを使用する Qt のインストール先。
QT_FORCE_BUILD_TOOLSホストツールが既に見つかっている場合でも、ツールを強制的にビルドします。Qt をクロスコンパイルする際に、SDK にクロスビルドされたツールがあることを確認するのに便利です。
QT_FORCE_FIND_TOOLSクロスコンパイルしない場合は、QT_HOST_PATH にあらかじめビルドされている Qt ツールを使用します。この変数は、QT_FORCE_BUILD_TOOLSON に設定されている場合にのみ有効になります。それ以外の場合、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() を呼び出す前に、56 を設定する必要があります。

5 に設定すると、qt_ で始まるコマンドはqt5_ で始まるコマンドを呼び出します。6 に設定すると、qt6_ で始まるコマンドを呼び出します。

設定されていない場合、最初のfind_package 呼び出しがデフォルトのバージョンを定義する。

QT_LIBINFIXQt が-libinfix で設定されている場合に、ライブラリ名に使用される infix を保持する文字列。

QT_NO_CREATE_VERSIONLESS_FUNCTIONS

qt_ で始まるコマンドを非表示にし、qt6_ で始まるバージョン管理されたコマンドのみを残します。

QT_NO_CREATE_VERSIONLESS_TARGETS

Qt:: で始まるインポートされたターゲットを非表示にします。代わりに、Qt6:: で始まるターゲットを使用する必要があります。
QT_VISIBILITY_AVAILABLEUnix では、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_DEPLOYMENT_TYPE

ビルドの種類に関係なく、リリースパッケージの署名を強制または無効にします。

QT_ANDROID_GENERATE_JAVA_QTQUICKVIEW_CONTENTS

QtQuickViewContent ベースのクラスを生成可能

QT_ANDROID_MULTI_ABI_FORWARD_VARS

マルチ ABI ビルドで CMake 変数を共有できます。

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::Qml

QT_QML_GENERATE_QMLLS_INI

QML Language Server用の.qmlls.iniファイルの自動生成を可能にする

QT_QML_OUTPUT_DIRECTORY

QMLモジュールがデフォルトで作成されるベース出力ディレクトリ

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 のコード署名を無効にする

標準CMake変数

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

©2024 The Qt Company Ltd. ここに含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。