Compilación de una aplicación QML
En «Creación de una aplicación de consola en C++», mostramos el archivo CMakeLists.txt de una sencilla aplicación de consola. Ahora crearemos una aplicación QML que utilice el Qt Quick módulo.
Este es el archivo completo del proyecto:
cmake_minimum_required(VERSION 3.16)
project(helloworld VERSION 1.0.0 LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
find_package(Qt6 6.5 COMPONENTS Quick REQUIRED)
qt_standard_project_setup(REQUIRES 6.5)
qt_add_executable(helloworld
main.cpp
)
qt_add_qml_module(helloworld
URI hello
QML_FILES
main.qml
FramedImage.qml
RESOURCES
img/world.png
)
target_link_libraries(helloworld PRIVATE Qt6::Quick)Repasemos los cambios que hemos realizado, en comparación con la aplicación de consola CMakeLists.txt:
...
find_package(Qt6 6.5 COMPONENTS Quick REQUIRED)En la llamada a « find_package() », sustituimos « Core » por « Quick ». De este modo, CMake cargará el módulo « Qt6Quick » y proporcionará los objetivos « Qt6::Quick » a los que más adelante realizaremos el enlace. CMake también cargará automáticamente los paquetes de los que depende Quick, como « Qt6Qml », que define el comando «qt_add_qml_module()» que utilizaremos a continuación.
También necesitamos Qt 6.5 o una versión posterior.
qt_standard_project_setup(REQUIRES 6.5)El comando ` qt_standard_project_setup() ` establece los valores predeterminados para todo el proyecto en una aplicación Qt típica. Al añadir ` REQUIRES 6.5`, activamos la política QTP0001, que define un prefijo de recursos predeterminado para los módulos QML creados por `qt_add_qml_module()`.
...
qt_add_qml_module(helloworld
URI hello
QML_FILES
main.qml
FramedImage.qml
RESOURCES
img/world.png
)qt_add_qml_module() añade al ejecutable un módulo QML denominado hello, compuesto por dos archivos QML y una imagen. Gracias a QTP0001, el módulo estará disponible en qrc:/qt/qml/hello en el sistema de archivos de recursos, siendo qrc:/qt/qml/ una de las rutas de importación predeterminadas del motor QML.
qt_add_qml_module() también realiza pasos de optimización, como ejecutar el compilador de scripts QML y definir un objetivo helloworld_qmllint que se puede ejecutar para obtener sugerencias adicionales sobre los archivos de .qml por parte de qmllint.
target_link_libraries(helloworld PRIVATE Qt6::Quick)En el comando « target_link_libraries() », vinculamos nuestro ejecutable con « Qt6::Quick ». Esto también vincula automáticamente con los objetivos de los que depende « Qt6::Quick », incluidos « Qt6::Qml » y « Qt6::Core ».
© 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.