Portar aplicaciones en C++ a Qt 6 utilizando las comprobaciones de Clazy
Hemos implementado algunas comprobaciones y correcciones en el marco Clazy para ayudarte a portar tus aplicaciones de Qt 5 a Qt 6. En sus propias palabras: «Clazy es un complemento para el compilador que permite a Clang comprender la semántica de Qt». Descarga Clazy (https://invent.kde.org/sdk/clazy) y sigue leyendo para que la migración a Qt 6 resulte más fluida.
Las comprobaciones de Clazy se pueden ejecutar como complemento durante la compilación o a través de una base de datos de compilación JSON utilizando clazy-standalone. Las correcciones se aplican posteriormente, utilizando clang-apply-replacements.
Comprobaciones de Clazy específicas para la migración a Qt 6
Las siguientes comprobaciones están pensadas para facilitar la migración de Qt 5 a Qt 6.
qt6-deprecated-api-fixesqt6-header-fixesqt6-qhash-signatureqt6-fwd-fixesmissing-qobject-macro
Las comprobaciones deben ejecutarse con Qt 5. El código corregido solo se compilará con Qt 6. Por este motivo, las comprobaciones mencionadas anteriormente deben ejecutarse de una sola vez. Clazy recomienda ejecutar una prueba cada vez para evitar conflictos al aplicar las correcciones, pero esto no es posible cuando se ejecutan esas comprobaciones como complemento.
Cómo aplicar las comprobaciones de Clazy
Aquí se explica detalladamente cómo configurar tu proyecto para ejecutarlo con Clazy y cómo seleccionar y aplicar las comprobaciones: https://invent.kde.org/sdk/clazy#setting-up-your-project-to-build-with-clazy.
Si no quieres ejecutar las comprobaciones como complemento, sino a través de una base de datos de compilación JSON, debes utilizar clazy-standalone. Consulta https://invent.kde.org/sdk/clazy#clazy-standalone-and-json-database-support para obtener instrucciones.
En resumen, suponiendo que tengas instalada una versión actualizada de Clazy, a continuación se explica lo que hay que hacer para ejecutar las comprobaciones como un complemento.
Configura tu proyecto para que se ejecute con Clazy.
Si utilizas qmake
Añade las siguientes líneas a tu comando de qmake, según corresponda a tu sistema operativo:
-spec linux-clang QMAKE_CXX="clazy"
-spec macx-clang QMAKE_CXX="clazy"Para Windows con MSVC, añada « QMAKE_CXX="clazy-cl.bat" ».
Ejecuta qmake.
Si utilizas CMake
Añade: -DCMAKE_CXX_COMPILER=clazy al comando de CMake.
Ejecuta cmake.
Selecciona las comprobaciones:
export CLAZY_CHECKS="qt6-deprecated-api-fixes,qt6-header-fixes,
qt6-qhash-signature,qt6-qlatin1stringchar-to-u,qt6-fwd-fixes,missing-qobject-macro"Activa las correcciones:
export CLAZY_EXPORT_FIXES=ONConfigura los directorios que Clazy debe ignorar:
export CLAZY_IGNORE_DIRS=.*lib_dir.*Esto evitará que las comprobaciones de Clazy se ejecuten en los archivos de las bibliotecas. Esto es necesario si las rutas de las bibliotecas se incluyen con -I y -F en lugar de -isystem y -framework. También es necesario para evitar advertencias de la comprobación « qt-header-fixes », si los encabezados que activan la comprobación están incluidos en los archivos de las bibliotecas incluidas.
Compila tu código.
Durante la compilación, se crean archivos « .yaml » junto a los archivos fuente.
Para aplicar los «fixits», ejecuta:
clang-apply-replacements <path_to_yaml_files>Esto modificará los archivos fuente; considera la posibilidad de hacer una copia de seguridad de tu código.
Si hay algún conflicto entre las correcciones, se te notificará y no se modificará ningún archivo.
No todas las adaptaciones se pueden realizar con correcciones automáticas. Presta especial atención a las advertencias que aparecen durante la compilación para identificar el código que habrá que modificar manualmente.
Cómo aplicar las comprobaciones de Clazy en Qt Creator
Puedes acceder a las comprobaciones de Clazy en Qt Creator seleccionando « Tools » > « Options » > « Analyzer » (o Qt Creator > Preferences > Analyzer en macOS).
Debes crear tu propia configuración y seleccionar las comprobaciones de Clazy dedicadas a la adaptación que encontrarás en las secciones «Nivel 2» y «Nivel manual» en Qt Creator, versión 4.14.1 o posterior. Puedes utilizar el filtro «qt6» para localizar la mayoría de las comprobaciones. Asegúrate de seleccionar únicamente las comprobaciones que figuran en la lista anterior.

Nota: Te recomendamos que desmarques todas las demás comprobaciones, excepto las de portabilidad, para facilitar la aplicación de correcciones y evitar conflictos innecesarios.
Para ejecutar las comprobaciones, selecciona « Analyze » > « Clang-Tidy and Clazy ».
Para obtener más información sobre cómo configurar y ejecutar las comprobaciones de Clazy, consulta Qt Creator: Clang Tools.
Una advertencia
En Qt Creator, no se avisa de los conflictos entre soluciones. Si hay más de una solución en la misma línea, ten cuidado al aplicarlas.
Una vez aplicado un «fixit», al volver a ejecutar las comprobaciones se producirá un error, ya que el nuevo código solo se compilará con Qt 6.
© 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.