ECMFindQmlModule

Finds QML import modules to set them as runtime dependencies.

Because QML modules are not compile time requirements, they can be easy to miss by packagers and developers, causing QML apps to fail to display. Use this CMake module to ensure a QML module is installed at compile time during CMake configuration.

Internally, this CMake module looks for the qmldir and, if needed, uses qmlplugindump to find the plugins and set them up as runtime dependencies.

ecm_find_qmlmodule(<module_name>
  <version> # Optional for Qt6 builds
  [REQUIRED] # Since 6.0
)

Usage example:

ecm_find_qmlmodule(org.kde.kirigami 2.1)
ecm_find_qmlmodule(org.kde.kirigami 2.1 REQUIRED) # CMake will fail if the required version is not found
ecm_find_qmlmodule(org.kde.kirigami) # Find it without a given version
ecm_find_qmlmodule(org.kde.kirigami REQUIRED) # CMake will fail if it is not found

Since 5.38.0.