Auf dieser Seite

qt_add_win_app_sdk

Fügt der Anwendung die Windows App SDK-Bibliothek hinzu.

Der Befehl ist in der Komponente „ Core “ des Pakets „ Qt6 “ definiert, das wie folgt geladen werden kann:

find_package(Qt6 REQUIRED COMPONENTS Core)

Dieser Befehl wurde in Qt 6.9 eingeführt.

Hinweis: Dieser Befehl befindet sich in der Technologievorschau und kann sich in zukünftigen Versionen ändern.

Übersicht

qt_add_win_app_sdk(<TARGET>)

Seit 6.10:

qt_add_win_app_sdk(<TARGET> [<PROPAGATION>])

Wenn versionslose Befehle deaktiviert sind, verwenden Sie stattdessen „ qt6_add_win_app_sdk() “. Dieser Befehl unterstützt dieselben Argumente wie der vorliegende Befehl.

Beschreibung

Fügt dem Projekt Windows App SDK-Header-Dateien hinzu und verknüpft die erforderlichen Bibliotheken mit dem angegebenen CMake-Ziel. Das Windows App SDK wird als NuGet-Paket bereitgestellt, sodass es problemlos in verwalteten Apps verwendet werden kann. Für nicht verwaltete C++-Anwendungen werden jedoch Header-Dateien benötigt. Die Funktion führt die folgenden Schritte aus:

  1. Versucht, das Windows App SDK und das Tool „cppwinrt.exe“ zu finden
  2. Generiert Windows App SDK-Header mithilfe des Tools „cppwinrt.exe“
  3. Bindet diese Header-Dateien ein und verknüpft die Bibliothek mit dem angegebenen CMake-Ziel

Argumente

PROPAGATION

Legt die Sichtbarkeit von Include-Verzeichnissen, Link-Verzeichnissen und verknüpften Bibliotheken für das Ziel fest. Dieses Argument wird direkt an die folgenden CMake-Befehle übergeben:

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

Es bestimmt, wie diese Eigenschaften auf das Ziel selbst angewendet werden und ob sie an andere Ziele weitergegeben werden, die mit diesem Ziel verknüpft sind.

Zulässige Werte:

  1. PRIVATE: Die Einstellungen (Include-Verzeichnisse, Link-Verzeichnisse und verknüpfte Bibliotheken) gelten nur für das aktuelle Ziel. Sie sind für Ziele, die mit diesem verknüpft sind, nicht sichtbar.
  2. PUBLIC: Die Einstellungen werden auf das aktuelle Ziel angewendet und auch an alle Ziele weitergegeben, die mit diesem verknüpft sind. Verwenden Sie diese Option, wenn die Abhängigkeit sowohl für den Bau des Ziels als auch für dessen Verbraucher erforderlich ist.
  3. INTERFACE: Die Einstellungen werden beim Erstellen des aktuellen Ziels nicht verwendet, werden jedoch an Ziele weitergegeben, die mit diesem verknüpft sind. Dies wird typischerweise für reine Header-Bibliotheken oder Schnittstellenziele verwendet, die Nutzungsanforderungen offenlegen, ohne diese für ihren eigenen Build zu benötigen.

Hinweise

  1. Dieses Argument ist optional.
  2. Wird es weggelassen, entspricht das Standardverhalten dem von „PRIVATE“ (oder geben Sie Ihren tatsächlichen Standardwert an).
  3. Verwenden Sie den geeigneten Weitergabebereich, um die Abhängigkeiten und Nutzungsanforderungen Ihres Ziels genau zu beschreiben.

Warnung: Dieser Befehl wird auf Nicht-MSVC-Plattformen nicht unterstützt.

© 2026 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.