Alles zusammenhalten mit CMake

Bei der Erstellung von QML-Modulen bietet CMake die Infrastruktur, um QML-Typen ordnungsgemäß zu registrieren, die erforderlichen Metadaten zu generieren und sicherzustellen, dass Ihr Modul korrekt verpackt und bereitgestellt werden kann. Diese Seite umreißt den empfohlenen Arbeitsablauf.

Verwendung von qt_add_qml_module

Der Befehl qt_add_qml_module ist der Standard und empfohlene Weg, um QML-Module zu erstellen. Er behandelt alle komplexen Details der QML-Modul-Erstellung:

qt_add_qml_module(my_qml_module
    URI MyModule
    QML_FILES
        MyType.qml
        AnotherType.qml
    SOURCES
        mytype.cpp mytype.h
)

Dieser einzelne Befehl:

• Erzeugt das Modulziel
• Registriert QML-Typen aus C++- und QML-Dateien
• Erzeugt eine qmldir-Datei
• Behandelt die Typregistrierung
• Richtet die richtigen Importpfade ein
• Aktiviert QML-Tooling-Unterstützung(qmllint, qmlls, etc.)

Hinzufügen weiterer QML-Dateien

Für QML-Dateien, die nach dem ersten Aufruf von qt_add_qml_module hinzugefügt werden, verwenden Sie qt_target_qml_sources:

qt_target_qml_sources(my_qml_module
    QML_FILES
        DynamicallyAddedType.qml
)

Dies kann je nach Plattform, Konfiguration oder anderen Faktoren geschehen.

Ausführliche CMake-Referenz

Vollständige Details zu allen CMake-Befehlen, -Eigenschaften, -Variablen und -Richtlinien finden Sie unter CMake-Integration für QML.