qt_add_win_app_sdk

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

このコマンドは 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_include_directories()
3. target_link_directories()

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

受け入れられる値

1. PRIVATE: 設定（インクルード・ ディレクトリ、リンク・ディレクトリ、およびリンクされたライブラリ）は、現在のターゲットにのみ適用されます。このターゲットに対してリンクするターゲットには表示されません。
2. PUBLIC: 設定は現在のターゲットに適用され、それに対してリンクするターゲットにも伝搬されます。依存関係がターゲットのビルドとそのコンシューマの両方に必要な場合に使用します。
3. INTERFACE: 設定は現在のターゲットのビルド時には使用されませんが、そのターゲットに対してリンクするターゲットには伝搬されます。これは通常、ヘッダのみのライブラリや、自身のビルドに必要なく使用要件を公開するインターフェイスターゲットに使用されます。

注意事項

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