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 应用程序 SDK 头文件
3. 包含这些头文件并将库链接到给定的 CMake 目标

参数

PROPAGATION

指定目标的包含目录、链接目录和链接库的传播可见性。此参数将直接传递给以下 CMake 命令：

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

它决定了这些属性如何应用于目标本身，以及是否会传播到与之链接的其他目标。

接受值：

1. PRIVATE：设置（包含目录、链接目录和链接库）仅应用于当前目标。链接到该目标的其他目标将看不到这些设置。
2. 公开：设置应用于当前目标，也会传播到与之链接的任何目标。当构建目标及其用户都需要依赖关系时，请使用此选项。
3. INTERFACE：在构建当前目标时不使用该设置，但会传播到与之链接的目标。这通常用于仅头文件的库或接口目标，这些库或目标暴露了使用要求，但其自身的构建却不需要这些要求。

注释

1. 此参数为可选参数。
2. 如果省略，默认行为等同于 PRIVATE（或指定实际默认行为）。
3. 请使用适当的传播范围来准确描述目标的依赖关系和使用要求。