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. 타깃의 종속성 및 사용 요구 사항을 정확하게 설명하려면 적절한 전파 범위를 사용하십시오.