qt_add_win_app_sdk

アプリケーションに Windows App SDK ライブラリを追加します。

このコマンドは、Qt6 パッケージのCore コンポーネントに定義されており、次のように読み込むことができます:

find_package(Qt6 REQUIRED COMPONENTS Core)

このコマンドは Qt 6.9 で導入されました。

概要

qt_add_win_app_sdk(<TARGET>)

6.10以降：

qt_add_win_app_sdk(<TARGET> [<PROPAGATION>])

バージョン指定なしのコマンドが無効になっている場合は、代わりに `qt6_add_win_app_sdk() ` を使用してください。このコマンドと同じ引数セットをサポートしています。

説明

プロジェクトに Windows App SDK のインクルードファイルを追加し、指定された CMake ターゲットに必要なライブラリをリンクします。Windows App SDK はNuGetパッケージとして提供されているため、マネージド アプリでは簡単に使用できます。ただし、アンマネージド C++ アプリケーションの場合は、ヘッダーファイルが必要です。この関数は以下の手順を実行します:

1. Windows App SDK および cppwinrt.exe ツールの検索を試みます
2. cppwinrt.exe ツールを使用して Windows App SDK のヘッダーファイルを生成します
3. それらのヘッダーファイルをインクルードし、指定された CMake ターゲットにライブラリをリンクする

引数

PROPAGATION

ターゲットに対するインクルードディレクトリ、リンクディレクトリ、およびリンクされるライブラリの伝播可視性を指定します。この引数は、以下の CMake コマンドに直接渡されます：

1. target_include_directories()
2. target_link_directories()
3. target_link_libraries()

これにより、これらのプロパティがターゲット自体にどのように適用されるか、またそれらをリンク元とする他のターゲットに伝播されるかどうかが決定されます。

許容される値:

1. PRIVATE: 設定（インクルードディレクトリ、リンクディレクトリ、およびリンクされたライブラリ）は、現在のターゲットにのみ適用されます。このターゲットに対してリンクを行うターゲットからは、これらの設定は見えません。
2. PUBLIC: 設定は現在のターゲットに適用されるほか、このターゲットに対してリンクを行うすべてのターゲットにも波及します。依存関係が、ターゲットのビルドと、その利用側双方で必要とされる場合にこれを使用します。
3. INTERFACE: 設定は現在のターゲットのビルド時には使用されませんが、これにリンクするターゲットには伝播されます。これは通常、ヘッダーのみのライブラリや、自身のビルドには必要としないが使用要件を公開するインターフェース・ターゲットに使用されます。

注

1. この引数はオプションです。
2. 省略された場合、デフォルトの挙動は PRIVATE と同等になります（または、実際のデフォルトを指定してください）。
3. ターゲットの依存関係や使用要件を正確に記述するために、適切な伝播スコープを使用してください。