En esta página

Migración a Qt 6

Hay muchos cambios en Qt entre la versión anterior, Qt 5, y Qt 6. Antes de actualizar a Qt 6, asegúrate de que tu aplicación de Qt 5 esté actualizada a la versión 5.15. La última versión de Qt 5 es la que presenta menos cambios a la hora de migrar a Qt 6. Sin embargo, es posible que las API marcadas como «deprecadas» u «obsoletas» en Qt 5.15 hayan sido eliminadas en Qt 6.

A continuación se indican los aspectos que debes comprobar si vas a migrar tus aplicaciones de Qt 5 a Qt 6.

Desactiva el uso de las API de C++ obsoletas en Qt 5.15

El uso de una API considerada obsoleta en Qt suele aparecer en forma de advertencia del compilador. También puedes convertir ese uso en un error definiendo la macro de C++ ` QT_DISABLE_DEPRECATED_UP_TO ` en tu sistema de compilación. Para desactivar cualquier API obsoleta en la versión 5.15 o en versiones anteriores de Qt, define la macro como ` 0x050F00`, que es «5.15.0» codificado como número hexadecimal.

Por ejemplo, en un archivo de proyecto qmake, define la macro con:

DEFINES += QT_DISABLE_DEPRECATED_UP_TO=0x050F00

En CMake, puede utilizar `add_compile_definitions`:

add_compile_definitions(QT_DISABLE_DEPRECATED_UP_TO=0x050F00)

Consulta los cambios en los módulos

Uno de los objetivos de la versión Qt 6 es mantener un marco optimizado, lo que implica la eliminación de algunos módulos de Qt 5 en Qt 6. En algunos casos, las API de un módulo obsoleto están disponibles en otro módulo. En futuras versiones de Qt 6, es posible que se añadan módulos nuevos o anteriores.

Prueba de regresiones gráficas

Las aplicaciones QML cuentan con un nuevo backend gráfico, por lo que debes comprobar que no haya regresiones. Ya no se garantiza que OpenGL sea el valor predeterminado en las plataformas de destino, por lo que debes comprobar que tu código gráfico siga generando los efectos que deseas.

Sigue siendo posible utilizar llamadas a OpenGL en aplicaciones Qt, pero las API de OpenGL se han trasladado al Qt OpenGL módulo. El backend gráfico para las aplicaciones Qt Widgets no ha cambiado con respecto a Qt 5.

Alta resolución (DPI)

Qt 6 es compatible con pantallas de alta resolución (DPI) en todas las plataformas y tendrá en cuenta automáticamente la resolución de la pantalla al utilizar API de nivel superior, como Qt Widgets o Qt Quick. Las aplicaciones solo tienen que proporcionar recursos de alta resolución, como imágenes e iconos. Esta función está siempre activada.

Qt 6 cambia la política de redondeo del factor de escala predeterminado de « Qt::HighDpiScaleFactorRoundingPolicy::Round » a « Qt::HighDpiScaleFactorRoundingPolicy::PassThrough » para seguir con precisión la configuración de DPI del sistema operativo. Las aplicaciones que utilicen « Qt Widgets » pueden experimentar fallos gráficos con factores de escala no enteros, por ejemplo, en Windows con una pantalla configurada al 175 %. En ese caso, establece la política de redondeo en « Round » para restablecer el comportamiento de Qt 5.

Consulta «High DPI » para obtener más detalles.

Utiliza las API de integración con la plataforma

En Qt 6 se ha mejorado la integración con las API nativas de las plataformas de destino. Puede utilizar las API de integración con la plataforma para implementar comportamientos nativos que Qt no proporciona. Para Qt 6, compruebe si hay actualizaciones disponibles para la plataforma de destino de su aplicación.

Utilice la herramienta de portabilidad

Existe una herramienta basada en Clazy para facilitar la migración de Qt 5 a Qt 6: Migración de aplicaciones C++ a Qt 6 utilizando Clazy.

Más información

Cambios en QTextStream

El método QTextStream::setCodec() se ha eliminado en Qt 6. Utiliza en su lugar QTextStream::setEncoding().

© 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.