Auf dieser Seite

Bereitstellung von QML-Anwendungen

Diese Seite enthält Informationen zur Bereitstellung von QML-Anwendungen. Sie behandelt die Verwendung von „ Qt Creator “ für die Bereitstellung sowie die Nutzung des Qt-Ressourcensystems, um QML-Dateien und andere Ressourcen zusammen mit der ausführbaren Anwendungsdatei zu bündeln.

Die Bereitstellung von Anwendungen mit Qt Creator

Qt CreatorQt Creator stellt QML-Anwendungen bereit und bündelt sie für verschiedene Plattformen. Für mobile Geräte kann Anwendungen direkt in die jeweiligen Plattform-Paketformate, wie z. B. APK, bündeln.

Wenn Sie Ihre Anwendungen auf der Zielplattform ausführen, muss Ihre Anwendung auf den Speicherort der QML-Bibliotheken zugreifen können. Wenn Sie qmake verwenden, verweist die Umgebungsvariable „ QT_INSTALL_QML “ auf den Speicherort der Bibliotheken. Die Qt-Installationsprogramme installieren die QML-Bibliotheken in folgenden Verzeichnissen: <version>/ <COMPILER>/qml directory.

Verwendung des Qt-Ressourcensystems mit QML

Das Qt-Ressourcensystem ermöglicht es, Ressourcendateien als Binärdateien in einer ausführbaren Anwendungsdatei zu speichern. Das Qt-Ressourcensystem wird für QML-Anwendungen verwendet, da es ermöglicht, auf QML-Dateien und andere Ressourcen – wie Bilder und Audiodateien – über das URI-Schema des Ressourcensystems statt über relative oder absolute Pfade zu Dateisystemressourcen zu verweisen.

Hinweis: Die Verwendung des Ressourcensystems bedeutet, dass die ausführbare Anwendungsdatei in der Regel neu kompiliert werden muss, sobald eine QML-Quelldatei geändert wird, um die Ressourcen im Paket zu aktualisieren.

Die CMake-QML-Modul-API fügt Ihre QML-Dateien automatisch in das Ressourcensystem ein. Um darauf zuzugreifen, laden Sie Ihre Haupt-QML-Datei als Ressource oder als URL mit dem Schema „ qrc “. Den Pfad im Ressourcensystem, unter dem Ihre QML-Dateien abgelegt sind, erhalten Sie durch Verkettung von:

  • die „ RESOURCE_PREFIX “, die Sie an ` qt_add_qml_module` übergeben haben,
  • /qt/qml, falls Sie „ RESOURCE_PREFIX “ nicht an ` qt_add_qml_module ` übergeben haben und die Richtlinie `QTP0001` auf „ NEW “ gesetzt ist.
  • /, wenn Sie RESOURCE_PREFIX nicht an ` qt_add_qml_module ` übergeben haben und die Richtlinie QTP0001 auf „ not “ ( NEW) gesetzt ist.
  • Falls Sie „ NO_RESOURCE_TARGET_PATH “ nicht an „qt_add_qml_module“ übergeben haben: Die an „qt_add_qml_module“ übergebene „ URI “, wobei Punkte durch Schrägstriche ersetzt wurden.

Beispielsweise wird ein Modul namens „ My.Own.Module “ an folgendem Speicherort abgelegt:

  • :/qt/qml/My/Own/Module/ wenn Sie „ /qt/qml “ als „ RESOURCE_PREFIX “ angegeben haben oder „ RESOURCE_PREFIX “ nicht übergeben haben und die Richtlinie „QTP0001“ auf „ NEW “ gesetzt ist.
  • :/My/Own/Module/ wenn Sie / als RESOURCE_PREFIX angegeben haben oder RESOURCE_PREFIX nicht bestanden haben und die Richtlinie QTP0001 nicht auf NEW eingestellt ist.
  • :/Some/Prefix/My/Own/Module/ wenn Sie „ Some/Prefix/ “ als RESOURCE_PREFIX
  • :/ wenn Sie NO_RESOURCE_TARGET_PATH

Sobald dies erledigt ist, werden alle in QML über relative Pfade angegebenen Dateien aus dem Ressourcensystem geladen. Die Nutzung des Ressourcensystems ist für die QML-Ebene vollständig transparent; das bedeutet, dass der gesamte QML-Code über relative Pfade auf Ressourcendateien verweisen und das Schema „ qrc “ nicht verwenden sollte. Dieses Schema sollte nur aus C++-Code heraus verwendet werden, um auf Ressourcendateien zu verweisen.

Hinweis: Bei Verwendung von qmake müssen Sie Ihre Dateien manuell im Ressourcensystem ablegen. Informationen dazu finden Sie im qmake-Handbuch und in der allgemeinen Dokumentation zum Ressourcensystem. Es wird empfohlen, sich dennoch an die oben beschriebene Konvention zur Pfadbenennung zu halten.

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