Cómo hacer que Qt esté disponible en proyectos de CMake
Actualmente, el único método compatible para que Qt esté disponible en los proyectos de los usuarios es tenerlo preinstalado en el sistema, o cualquier flujo de trabajo equivalente que compile Qt con antelación y lo ponga a disposición de find_package, como vcpkg.
Al utilizar Qt Creator o qt-cmake (qt-cmake.bat en Windows), la ruta de instalación de Qt se reenvía automáticamente a la llamada subyacente a CMake.
Al utilizar cmake directamente, las rutas de búsqueda generales que utiliza CMake deberían cubrir la mayoría de las instalaciones de Qt que no sean de usuario. Para tener un mayor control sobre qué paquete de Qt utilizar, puedes pasar https://cmake.org/cmake/help/latest/variable/PackageName_ROOT.html Qt6_ROOT como variable de entorno o de caché que apunte a la ruta de instalación de Qt, o añadiendo o apéndicando a CMAKE_PREFIX_PATH de manera similar. Por ejemplo, si la ruta de instalación es "~/Qt/6.12.0/gcc_64", se pasaría en la línea de comandos como -DQt6_ROOT=$HOME/Qt/6.12.0/gcc_64.
Nota: Al realizar una compilación cruzada (compilar para una plataforma distinta a aquella en la que te encuentras, como WebAssembly o Android) y al utilizar « cmake » sin modificaciones, configura « CMAKE_TOOLCHAIN_FILE » en lugar de rutas de búsqueda como « Qt6_ROOT » o « CMAKE_PREFIX_PATH ». En Linux, el archivo de la cadena de herramientas (específico para una plataforma de destino concreta) suele encontrarse en una ruta similar a esta: « "~/Qt/6.12.0/wasm_singlethread/lib/cmake/Qt6/qt.toolchain.cmake" ». Establece las variables necesarias, como CMAKE_PREFIX_PATH, CMAKE_FIND_ROOT_PATH y QT_HOST_PATH.
cmake_minimum_required(VERSION 3.16)
project(helloworld)
find_package(Qt6 REQUIRED)El paquete Qt se divide en varios módulos que debes incluir en función del alcance de tu proyecto; el más básico de ellos es
find_package(Qt6 REQUIRED COMPONENTS Core)CMake moderno admite otros proveedores de dependencias, como FetchContent; sin embargo, no se admite el uso de Qt con FetchContent debido a la estrecha integración de las funciones de Qt dentro del propio CMake. Tampoco se admite la incorporación de fuentes de Qt a través de add_subdirectory ni mediante submódulos de Git.
Nota: No se admitellamar a find_package(Qt6) en un subdirectorio distinto de aquel en el que se utiliza, ni dentro de un function. Hacerlo puede provocar diversos errores en lugares impredecibles.
En su lugar, llama repetidamente a ` find_package(Qt6) ` en todos los ámbitos de subdirectorios que utilicen funciones de Qt XML, o bien traslada la llamada a ` find_package(Qt6) ` al archivo raíz ` CMakeLists.txt`.
© 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.