qt_add_win_app_sdk

Ajoute la bibliothèque Windows App SDK à l'application.

La commande est définie dans le composant « Core » du paquet « Qt6 », qui peut être chargé comme suit :

find_package(Qt6 REQUIRED COMPONENTS Core)

Cette commande a été introduite dans Qt 6.9.

Synopsis

qt_add_win_app_sdk(<TARGET>)

Depuis la version 6.10 :

qt_add_win_app_sdk(<TARGET> [<PROPAGATION>])

Si les commandes sans version sont désactivées, utilisez plutôt qt6_add_win_app_sdk(). Elle prend en charge le même ensemble d’arguments que cette commande.

Description

Ajoute les fichiers d'en-tête du SDK Windows App au projet et lie les bibliothèques nécessaires à la cible CMake spécifiée. Le SDK Windows App est fourni sous forme de package NuGet afin de pouvoir être facilement utilisé dans les applications gérées. Cependant, pour les applications C++ non gérées, des fichiers d'en-tête sont nécessaires. La fonction effectue les étapes suivantes :

1. Tente de localiser le SDK d’applications Windows et l’outil cppwinrt.exe
2. Génère les en-têtes du SDK d’applications Windows à l’aide de l’outil cppwinrt.exe
3. Inclut ces fichiers d'en-tête et lie la bibliothèque à la cible CMake spécifiée

Arguments

PROPAGATION

Spécifie la visibilité de propagation des répertoires d’inclusion, des répertoires de liaison et des bibliothèques liées pour la cible. Cet argument est transmis directement aux commandes CMake suivantes :

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

Il détermine comment ces propriétés s'appliquent à la cible elle-même et si elles sont propagées aux autres cibles qui s'y lient.

Valeurs acceptées :

1. PRIVATE : les paramètres (répertoires d'inclusion, répertoires de liaison et bibliothèques liées) s'appliquent uniquement à la cible actuelle. Ils ne sont pas visibles pour les cibles qui s'y lient.
2. PUBLIC : les paramètres s’appliquent à la cible actuelle et sont également propagés à toute cible qui s’y lie. Utilisez cette option lorsque la dépendance est requise à la fois pour la compilation de la cible et pour ses consommateurs.
3. INTERFACE : les paramètres ne sont pas utilisés lors de la compilation de la cible actuelle, mais sont propagés aux cibles qui s’y lient. Cette option est généralement utilisée pour les bibliothèques « header-only » ou les cibles d’interface qui exposent des exigences d’utilisation sans en avoir besoin pour leur propre compilation.

Remarques

1. Cet argument est facultatif.
2. S’il est omis, le comportement par défaut est équivalent à PRIVATE (ou à la valeur par défaut que vous avez spécifiée).
3. Utilisez la portée de propagation appropriée pour décrire avec précision les dépendances et les exigences d’utilisation de votre cible.