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. 请使用适当的传播范围来准确描述目标的依赖关系和使用要求。