Qt für HarmonyOS CMake-API

Hinweis: Die HarmonyOS-CMake-API befindet sich in der Technologievorschau und kann sich in zukünftigen Versionen ändern.

Auf dieser Seite werden die CMake-Befehle, Ziel-Eigenschaften und Variablen aufgeführt, mit denen festgelegt wird, wie eine Qt-Anwendung in ein HarmonyOS Ability Package (HAP) gepackt wird.

Wenn Sie mit `qt_add_executable()` eine Qt-Ausführungsdatei erstellen und dabei HarmonyOS als Zielplattform angeben, generiert Qt automatisch ein Build-Ziel namens „ <target>_make_hap “, das das HAP erzeugt. Die folgenden Befehle, Eigenschaften und Variablen steuern den Inhalt dieses HAP sowie die Metadaten, die in die HarmonyOS-Manifestdateien geschrieben werden.

Ein HarmonyOS-Anwendungsbündel wird durch zwei Arten von Manifesten beschrieben: das Manifest auf Anwendungsebene „ app.json5 “, das Metadaten enthält, die für das gesamte Bündel gelten, und das Manifest auf Modulebene „ module.json5 “, das ein einzelnes HAP-Modul innerhalb dieses Bündels beschreibt. Die folgenden Ziel-Eigenschaften spiegeln diese Aufteilung wider: Die „ QT_HARMONYOS_APP_* “-Eigenschaften legen Metadaten auf Anwendungsebene fest, wie z. B. Hersteller, Version, Bezeichnung und Symbol, während Eigenschaften wie „QT_HARMONYOS_MODULE_DESCRIPTION“ und „QT_HARMONYOS_ABILITY_ORIENTATION“ Metadaten auf Modulebene festlegen. Die vollständige Liste finden Sie im Abschnitt „Ziel-Eigenschaften“ weiter unten.

Befehle

qt_add_harmonyos_permission() fügt der Anwendung eine HarmonyOS-Berechtigung hinzu.

Ziel-Eigenschaften

Die folgenden Ziel-Eigenschaften beeinflussen die Erstellung des HAP:

QT_HARMONYOS_ABILITY_ORIENTATION	Die Richtlinie zur Bildschirmausrichtung der HarmonyOS-Fähigkeit.
QT_HARMONYOS_APP_BUNDLE_NAME	Der Bundle-Name der HarmonyOS-Anwendung.
QT_HARMONYOS_APP_ICON	Das Symbol der HarmonyOS-Anwendung.
QT_HARMONYOS_APP_LABEL	Die Bezeichnung der HarmonyOS-Anwendung.
QT_HARMONYOS_APP_NAME	Der Name der HarmonyOS-Anwendung.
QT_HARMONYOS_APP_VENDOR	Der Anbieter der HarmonyOS-Anwendung.
QT_HARMONYOS_APP_VERSION_CODE	Der Versionscode der HarmonyOS-Anwendung.
QT_HARMONYOS_APP_VERSION_NAME	Der Versionsname der HarmonyOS-Anwendung.
QT_HARMONYOS_COMPATIBLE_SDK_VERSION	Die kompatible SDK-Version der HarmonyOS-Anwendung.
QT_HARMONYOS_COMPILE_SDK_VERSION	Die SDK-Version, mit der die HarmonyOS-Anwendung kompiliert wurde.
QT_HARMONYOS_EXTRA_LIBS	Zusätzliche Bibliotheken, die mit dem HarmonyOS-Ziel bereitgestellt werden sollen.
QT_HARMONYOS_EXTRA_PLUGINS	Zusätzliche Qt-Plugins, die mit dem HarmonyOS-Ziel bereitgestellt werden sollen.
QT_HARMONYOS_MODULE_DESCRIPTION	Die Beschreibung des HarmonyOS-Moduls.
QT_HARMONYOS_MODULE_DEVICE_TYPES	Die vom HarmonyOS-Modul unterstützten Gerätetypen.
QT_HARMONYOS_PACKAGE_SOURCE_DIR	Pfad zu einer benutzerdefinierten HarmonyOS-Paketvorlage.
QT_HARMONYOS_TARGET_ARCHS	Die Zielarchitekturen der HarmonyOS-Anwendung.
QT_HARMONYOS_TARGET_SDK_VERSION	Die Ziel-SDK-Version der HarmonyOS-Anwendung.

Variablen

Die folgenden Variablen beeinflussen die Erstellung des HAP:

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