QT_ADD_WIN_APP_SDK

응용 프로그램에 윈도우 앱 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 앱 SDK 포함 파일을 추가하고 필요한 라이브러리를 지정된 CMake 대상에 링크합니다. Windows 앱 SDK는 관리되는 앱에서 쉽게 사용할 수 있도록 NuGet 패키지로 제공됩니다. 그러나 관리되지 않는 C++ 애플리케이션의 경우 헤더 파일이 필요합니다. 이 함수는 다음 단계를 수행합니다:

  1. Windows 앱 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. 비공개: 설정(디렉터리, 링크 디렉터리 및 링크 라이브러리 포함)이 현재 대상에만 적용됩니다. 이 대상에 대해 링크하는 대상에는 표시되지 않습니다.
  2. 공개: 설정이 현재 대상에 적용되며 이 대상에 대해 링크하는 모든 대상에도 전파됩니다. 대상을 빌드할 때와 대상을 사용하는 소비자 모두에게 종속성이 필요한 경우 이 설정을 사용합니다.
  3. 인터페이스: 설정은 현재 대상을 빌드할 때는 사용되지 않지만 대상에 대해 링크하는 대상에 전파됩니다. 일반적으로 자체 빌드에 필요하지 않고 사용 요구 사항을 노출하는 헤더 전용 라이브러리 또는 인터페이스 대상에 사용됩니다.

참고

  1. 이 인수는 선택 사항입니다.
  2. 생략하면 기본 동작은 PRIVATE와 동일합니다(또는 실제 기본값 지정).
  3. 적절한 전파 범위를 사용하여 대상의 종속성 및 사용 요구 사항을 정확하게 설명하세요.

경고: 이 명령은 MSVC가 아닌 플랫폼에서는 지원되지 않습니다.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.