Novedades de Qt 6.12
Módulos nuevos y recuperados en Qt 6.12
Qt 6.12 incorpora los siguientes módulos y herramientas:
- El módulo «Qt Qml Design Support», con un conjunto de tipos para registrar y hacer referencia a objetos en QML. Está pensado para futuras herramientas de diseño de « Qt Quick ».
Nuevas características de Qt 6.12
Módulo ActiveQt
Sin cambios destacables.
Qt Bluetooth Módulo
- El backend de Android ahora respeta los parámetros de intervalo mínimo y máximo de publicidad proporcionados a través de QLowEnergyAdvertisingParameters al iniciar la publicidad BTLE.
Módulo Qt Canvas Painter
- El módulo Qt Canvas Painter ha dejado de estar en fase de «Technology Preview» y ahora cuenta con mantenimiento completo (soporte técnico).
- El módulo ha incorporado ` QtCanvas2D`, una nueva API de QML respaldada por Qt Canvas Painter. Esta API sigue en fase de «Technology Preview».
- QCanvasPath Ha incorporado una sobrecarga de ` addPath()` para analizar directamente cadenas de trazados SVG.
- QCanvasPainter Se han añadido QCanvasPainter::FillRule y QCanvasPainter::setFillRule() para admitir la regla de relleno «EvenOdd» en los rellenos de trazados.
- QCanvasGradient Se ha añadido setImage() para crear degradados directamente a partir de una imagen.
- QCanvasRadialGradient Se han añadido constructores y las funciones ` setInnerCenterPosition()` y ` setOuterCenterPosition()` para admitir degradados radiales no simétricos (de dos centros).
Qt CoAP Módulo
No hay cambios destacables.
Qt Core Módulo
- QRangeModelSe han ampliado los puntos de personalización ` RowOptions ` y ` ItemAccess ` del módulo para admitir `
headerData()`, así como `flags()` por fila y por elemento. ` QRangeModel ` ahora admite ` drag'n'drop handling ` con gestión de tipos MIME personalizada y segura en ambos puntos de personalización, además de las propiedades ` supportedDragActions ` y ` supportedDropActions `. ` QRangeModel ` ahora también implementa ` sort()` con soporte para ` sortCollator ` para la ordenación según la configuración regional, y ` match()` para la coincidencia rápida de contenido. - Se ha añadido qSharedPointerStaticCast como nueva función libre para conversiones estáticas de QSharedPointer.
- QSortFilterProxyModel Se ha incorporado la enumeración ` DataChangeRelevanceFlag ` y el método virtual ` dataChangeRelevanceFlags()`, lo que permite a las subclases controlar si una señal de origen `
dataChanged` activa un nuevo filtrado o una nueva ordenación. - El nuevo método ` QAbstractItemModel::compareData()` es una nueva API protegida para comparar dos `QVariant`, diseñada específicamente para casos de uso de vistas de elementos.
- qfloat16 Se han añadido operadores de incremento y decremento, así como un operador unario operator+.
- QVariant Se han añadido constructores a partir de referencias rvalue.
- QMap y ` QMultiMap ` ahora implementan los seis operadores relacionales.
- QVarLengthArray Se ha añadido ` removeAt()`, que se corresponde con la API de ` QList `.
- Los métodos ` fromString()` de ` QDateTime`, ` QDate` y ` QTime`, así como ` toDateTime()`, ` toDate()` y ` toTime()` de ` QLocale`, utilizan ahora un nuevo analizador sintáctico que es más rápido con muchos formatos.
- QTimeZone ahora acepta identificadores de alias de la IANA en formato canónico CLDR en su constructor y en isTimeZoneIdAvailable(). QTimeZone::availableTimeZoneIds() ahora incluye esos alias.
- QFile::copy() ahora acepta un argumento opcional de « QFileDevice::Permissions ». « QSaveFile » ahora aplaza la aplicación de los permisos solicitados hasta « commit » ().
- Qt::compareThreeWay() ha incorporado una sobrecarga para
std::pair. - QCalendarPermission Se ha añadido un modo de acceso ` WriteOnly `.
- QFileSystemWatcher Ahora puede utilizar
inotifyen FreeBSD 15 y versiones posteriores. - QStandardPaths En macOS, ahora incluye el directorio `
/Library/Preferences` de todo el sistema en ` standardLocations()`. En iOS, ` PublicShareLocation ` devuelve la ruta correcta y ` TemplatesLocation ` se indica correctamente como no compatible. - QEasingCurve Se ha añadido fromCubicBezier(), una función auxiliar para crear curvas de suavizado Bézier cúbicas.
- QJsonObject Se han añadido los iteradores const de estilo STL cbegin() y cend(). QJsonDocument ha incorporado constructores de valor a la derecha (rvalue) de QJsonArray y QJsonObject.
Qt D-Bus Módulo
No hay cambios destacables.
Qt Graphs Módulo
- Qt Canvas Painter ahora se puede utilizar como motor de renderizado para gráficos 2D. Actívalo durante la configuración con el indicador de configuración
-feature-graphs-2d-high-performance-backend. - Se ha añadido « QLogValueAxis » (LogValueAxis en QML), un nuevo tipo de eje logarítmico para gráficos 2D.
- QXYSeries Se han añadido las propiedades « values », « valueMapping », « valueMin » y « stepSize » para la introducción declarativa de datos desde QML.
- QPieSeries Se han añadido las propiedades ` sliceData ` y ` sliceLabels ` para la introducción declarativa de datos desde QML.
- QValueAxis y QLogValueAxis ha incorporado la propiedad labelPostFormat para personalizar el texto de las etiquetas de los ejes.
- Q3DGraphsWidgetItem Se han añadido las propiedades « panEnabled » y « dragMode » para habilitar y configurar el desplazamiento en los gráficos 3D.
- QDateTimeAxis Se ha añadido la propiedad ` tickCount `.
Qt GRPC Módulo
- Se ha añadido la compresión de peticiones del lado del cliente. La nueva enumeración ` QtGrpc::CompressionAlgorithm ` se puede seleccionar mediante ` QGrpcChannelOptions::setRequestCompression()` y ` QGrpcCallOptions::setRequestCompression()` para comprimir los mensajes salientes.
- Se han añadido supportedCompressionAlgorithms(), acceptedCompressionAlgorithms() y setAcceptedCompressionAlgorithms() a QGrpcChannelOptions para controlar qué algoritmos de compresión anuncia el cliente en el encabezado de solicitud
grpc-accept-encodingy está dispuesto a aceptar en las respuestas del servidor. - Se han añadido maximumReceiveMessageSize() y setMaximumReceiveMessageSize() a QGrpcChannelOptions y QGrpcCallOptions para limitar el tamaño de los mensajes entrantes.
Qt GUI Módulo
- Se ha añadido compatibilidad con el renderizado indirecto a QRhi. Ahora se pueden crear búferes de tipo
IndirectDrawBuffery emitir llamadas de dibujo indirectas mediante QRhiCommandBuffer. - QRhi Se ha incorporado el indicador de características ShaderDrawParameters para consultar la compatibilidad con los parámetros integrados de dibujo de shaders (p. ej.,
gl_DrawID). - El backend de Vulkan « QRhi » utiliza ahora
VK_EXT_device_faultpara informar de detalles adicionales sobre la pérdida de dispositivos. - QAccessibilityHints Se ha añadido una propiedad « motionPreference » para las preferencias de accesibilidad de movimiento reducido.
- QStyleHints Se ha añadido toolTipWakeUpDelay, lo que permite a las aplicaciones consultar o ajustar el retraso antes de que aparezca una información sobre herramientas.
- QImageReader Se ha añadido effectiveSize(), que devuelve el tamaño de la imagen respetando autoTransform().
- QTextCursor::deletePreviousChar() (Retroceso) ahora gestiona correctamente las secuencias de emojis de varias unidades de código.
- Se ha añadido Qt::InputMethodHint::ImhNoFullscreen para solicitar que el método de entrada no ocupe toda la pantalla.
- Se ha añadido Qt::InputMethodHint::ImhDecimalNumbersOnly para restringir la entrada a números que incluyan el punto decimal, pero no a números negativos.
Qt HTTP Server El módulo
- QHttpServerConfiguration ha incorporado setMaximumConnections() para limitar el número total de conexiones simultáneas, y setMaximumConnectionsPerHost() para limitar las conexiones por dirección IP.
Qt Image Formats Módulo
No hay cambios destacables.
Qt Lottie Animation Módulo
- Se ha añadido compatibilidad con la capa de texto de Lottie, incluida la representación de trazados de glifos.
- Se ha añadido compatibilidad con las dimensiones animadas en los elementos de forma de elipse, rectángulo y poliestrella de Lottie, así como con los trazos degradados, las máscaras de capa y la función de orientación automática de la capa.
- Se ha añadido compatibilidad con las funciones de reasignación temporal y estiramiento temporal de Lottie.
- Se ha introducido el tipo ` LottieVectorImageController ` para controlar la reproducción de animaciones de Lottie en un ` VectorImage`. Este tipo expone las propiedades ` currentFrame`, ` frameRate`, ` startFrame` y ` endFrame `, junto con métodos de reproducción como ` play()`, ` pause()` y ` gotoAndPlay()`.
Qt MQTT Módulo
No hay cambios destacables.
Qt Multimedia El módulo
- QScreenCapture y QWindowCapture han incorporado la propiedad maximumFrameRate para limitar la velocidad de fotogramas de captura. Esta misma propiedad está disponible en los tipos QML ScreenCapture y WindowCapture.
- QAudioSource QAudioSink y han incorporado los métodos () y () para consultar y controlar el tamaño del periodo del búfer de audio nativo. nativePeriodFrameCount setNativePeriodFrameCount
- Se han añadido QMediaCaptureSession::setNativeVideoSource() y el elemento QML GStreamerVideoSource, lo que permite que una canalización personalizada de GStreamer envíe fotogramas de vídeo a un QMediaCaptureSession.
- QMediaMetaData::ThumbnailImage está obsoleto; los backends ya no lo rellenarán. Utiliza CoverArtImage en su lugar.
- QSoundEffect Ahora siempre emite sourceChanged después de setSource(), incluso cuando la URL no cambia.
Qt Network Módulo
- Se han introducido QSslKeyingMaterial y QSslConfiguration::keyingMaterial() / setKeyingMaterial() para exponer los exportadores de material de clave TLS (RFC 5705).
- QHostInfo Se ha añadido clearCache() para vaciar la caché de resultados de DNS mediante programación.
- QHttpHeaders Se han añadido los operadores de flujo de QDataStream, rangeValues() para analizar el encabezado «
Range» y setRangeValues() para configurarlo. La nueva clase QHttpHeaderRange representa un rango de un solo byte dentro de ese encabezado. - El backend TLS de OpenSSL ahora admite la compilación con OpenSSL 4.
Qt Network Módulo de autorización
No hay cambios destacables.
Qt OPC UA Módulo
No hay cambios destacables.
Módulo Qt OpenAPI
- La función `qt_add_openapi_client() ` ahora admite las opciones `
GENERATE_DOCUMENTATION` y `DOCUMENTATION_OUTPUT_DIRECTORY` para generar documentación basada en Doxygen junto con el código del cliente. - Se ha añadido compatibilidad con la característica «oneOf » del esquema.
- Se han renombrado los getter de las propiedades del modelo generado. Ahora Q_PROPERTY expone los mismos nombres de propiedad que los utilizados en el archivo YAML.
- Los métodos de la API del cliente generados ya no son virtuales.
Qt Positioning El módulo
- QGeoSatelliteInfo::SatelliteSystem ha incorporado entradas para los sistemas de satélites IRNSS y SBAS.
Qt Print Support Módulo
No hay cambios destacables.
Qt Protobuf Módulo
- Las propiedades Qt de las clases de mensajes generadas ahora se marcan con el modificador FINAL de forma predeterminada. Esto permite que las herramientas de Qml apliquen optimizaciones de rendimiento y generen código más eficiente. Utiliza la nueva opción «
GENERATE_NON_FINAL_PROPERTIES» de qt_add_protobuf() para volver al comportamiento anterior.
Qt Qml Módulo
- QQmlEngine se ha añadido setExternalSingletonInstance() para registrar un objeto C++ creado externamente como un singleton de QML. Ahora se puede combinar QML_UNCREATABLE con QML_SINGLETON.
- string.arg() en QML ahora admite varios argumentos, en consonancia con las convenciones de JavaScript.
- Se ha añadido la función global ` Qt.escapeHtml()` para escapar caracteres especiales de HTML en QML.
- Al instanciar un componente al que le faltan propiedades obligatorias, el motor ahora informa de un error en lugar de construir en silencio un objeto incompleto.
- QQmlProperty es un tipo de valor con nombre denominado qmlProperty ahora. Se puede utilizar como tipo de propiedad, argumento de función o tipo de retorno en QML.
- QtQml.Models import: El SortFilterProxyModel ha incorporado los tipos de filtro compuestos RangeFilter, RegExpFilter, AllOfFilter y AnyOfFilter, así como una versión mejorada de FunctionFilter que acepta nombres de roles como argumentos separados.
- Qt.labs.qmlmodels import: TreeModel ha incorporado los métodos insertRow() y moveRows().
- Qt Qml Compilador: Se han eliminado
QQmlSA::FixSuggestion::hint()yQQmlSA::FixSuggestion::setHint().QQmlSA::FixSuggestion::fixDescription()ha pasado a llamarse QQmlSA::FixSuggestion::description().
Qt Quick Módulo
- Se ha añadido el singleton QML « Color », que proporciona funciones de utilidad para la manipulación del color.
- AnimatedImage El tipo ha adquirido las propiedades ` loops` y ` finishBehavior `, así como una señal ` finished()`.
- El tipo ` Text ` ahora representa correctamente todos los valores de ` QTextCharFormat::UnderlineStyle ` (como `
DashUnderline`, `WaveUnderline` y `SpellCheckUnderline`) que se pueden aplicar mediante el marcado HTML en el modo `RichText` o a través de ` QTextCharFormat ` en la API de C++. Anteriormente, todos los estilos de subrayado se representaban como líneas continuas. - Se ha añadido la propiedad « strokeGradient » al tipo « ShapePath ».
- Rectangle::color Ahora se puede restablecer a su valor por defecto (blanco) asignando «
undefined» a la propiedad en QML. - El tipo « FolderListModel » de « Qt.labs.folderlistmodel » ha incorporado las propiedades « showDot » y « showDotDot ».
- El tipo « VectorImage » de QtQuick.VectorImage ha incorporado las propiedades « asynchronous », « status », « retainWhileLoading » y « generatedItem ».
Qt Quick Módulo de controles
- Se ha añadido el estilo «
QtQuick.Controls.Native».import QtQuick.Controls.Nativeselecciona el estilo más adecuado para la plataforma para la que se compila en tiempo de compilación. De este modo, combina las ventajas de la selección de estilos en tiempo de compilación con la posibilidad de que la aplicación tenga una apariencia específica para cada plataforma. - ToolTip Se ha añadido la propiedad « policy » para controlar la visibilidad automática de las descripciones emergentes.
- ComboBox Se ha añadido la propiedad « highlightOnHover ».
- RangeSlider Se ha añadido una propiedad ` crossingEnabled ` para permitir o impedir que los dos controladores se crucen entre sí.
- Menu Se ha añadido la propiedad « separatorsCollapsible ».
- MenuItem Ahora muestra el atajo de teclado a partir de un ` Action` asociado.
- SearchField Ahora permite la navegación con teclas si su ` TextInput ` está vacío.
- Se ha añadido un subconjunto de las API existentes de « TextField » a « SearchField » para mayor comodidad: «selectTextByMouse», «selectedText», «selectionStart», «selectionEnd», «cursorPosition», «select()», «selectWord()» y «deselect()».
Qt Quick Módulo de diálogos
No hay cambios destacables.
Qt Quick Módulo de efectos
No hay cambios destacables.
Qt Quick Módulo «Test»
- TestCaseLa propiedad ` optional ` de ` Test` ha quedado obsoleta en ` Qt Quick ` Test. Utiliza en su lugar ` skip()`.
Qt Quick Módulo 3D
- Se ha añadido el tipo QML ` SkyMaterial ` para renderizar un cielo procedural y generar datos de iluminación basados en imágenes.
- Se ha añadido QuadTextureProvider a QtQuick3D.Helpers import. Un tipo QML utilizado para renderizar una textura cuádruple mediante un sombreador de fragmentos personalizado.
- Model Se ha añadido la propiedad ` instancingLodFactor ` para el control manual del nivel de detalle al utilizar la instanciación de la GPU.
- ExtendedSceneEnvironment Se han añadido las propiedades ` ssrThickness ` y ` ssrMaxSteps ` para un control más preciso de los reflejos en el espacio de pantalla.
- RuntimeLoader Se han añadido los métodos ` query()` y ` queryAll()` para buscar objetos por nombre o tipo dentro de una escena cargada dinámicamente.
Qt Quick Módulo 3D XR
- Se ha añadido compatibilidad con la configuración de vista única (
XR_VIEW_CONFIGURATION_TYPE_PRIMARY_MONO), lo que permite que las aplicaciones Qt Quick 3D XR se ejecuten en dispositivos 2D XR, como las gafas de RA.
Qt Quick Módulo de física 3D
- Se han añadido cinco tipos de articulaciones para restringir el movimiento de los cuerpos físicos: DistanceJoint, FixedJoint, PrismaticJoint, RevoluteJoint y SphericalJoint. Todos comparten el tipo base común PhysicsJoint.
Qt Remote Objects Módulo
- Las propiedades « registryUrl » y « persistedStore » disponen ahora de señales de notificación de cambios.
Qt SCXML Módulo
No hay cambios destacables.
Qt Sensors Módulo
No hay cambios destacables.
Qt Serial Port Módulo
No hay cambios dignos de mención.
Qt Spatial Audio Módulo
No hay cambios destacables.
Qt Serial Bus Módulo
No hay cambios destacables.
Qt SQL Módulo
No hay cambios destacables.
Qt SVG Módulo
- Los archivos SVG animados ya son compatibles con QMovie y AnimatedImage.
Módulo StyleKit de Qt Labs
- Se ha introducido QStyleKitStyle, una subclase de QStyle que aplica estilos basados en StyleKit a las aplicaciones de QWidget.
- El estilo ofrece ahora implementaciones para los tipos de controles de Qt Quick « RoundButton » y « MenuSeparator », sustituyendo así la alternativa genérica.
Módulo Qt TaskTree
- QtTaskTree::For ha incorporado una sobrecarga que acepta
qsizetypecomo recuento de iteraciones. Úsala como atajo paraFor(RepeatInterator(n)). - QtTaskTree::Forever Ahora es convertible implícitamente a ` QtTaskTree::Group`.
- QtTaskTree::ListIterator Se ha añadido una sobrecarga que acepta una función getter que devuelve ` QList`.
Qt Test Módulo
- Los resultados de las pruebas de rendimiento incluyen ahora la varianza y la desviación estándar entre los distintos backends de medición (tiempo, ticks de CPU, eventos, Valgrind).
- El registrador de pruebas de rendimiento en texto plano ahora formatea los resultados de coma flotante utilizando notación científica para garantizar la coherencia.
- Cuando se especifican en la línea de comandos funciones de prueba inexistentes junto con otras válidas, las pruebas válidas se ejecutan de todos modos.
Qt Virtual Keyboard Módulo
No hay cambios destacables.
Qt WebEngine Módulo
- QWebEngineNavigationRequest Se ha añadido la propiedad «userInitiated» para distinguir las navegaciones iniciadas por el usuario de las programáticas.
- QWebEngineProfile Se ha añadido setCryptoModulePasswordFunction() para proporcionar una llamada de retorno para desbloquear tokens de hardware PKCS#11.
Qt WebSockets Módulo
No hay cambios destacables.
Qt PDF Módulo
- QPdfSearchModel ha incorporado una propiedad «status» y una enumeración «Status» para indicar si una búsqueda está en curso, inactiva o completada.
- QPdfView Ahora admite el zoom con la rueda del ratón y la tecla Control, centrado en la posición del cursor.
- render() ha incorporado argumentos opcionales para especificar el formato de imagen y el color de fondo.
Qt WebView Módulo
- WebView ahora puede cargar contenido del sistema de recursos de Qt (URL de tipo
qrc:/) en Android, iOS, macOS y Windows.
Qt Widgets Módulo
- QTreeView ha incorporado la función QTreeView::itemDecorationRect(), que devuelve el rectángulo delimitador de la decoración (icono) correspondiente a un índice determinado.
- QStyle::StandardPixmap Ha incorporado QStyle::SP_TabScrollLeftButton, QStyle::SP_TabScrollRightButton, QStyle::SP_TabScrollUpButton y QStyle::SP_TabScrollDownButton para los botones de desplazamiento de la barra de pestañas.
- QDialogButtonBox Se han añadido QDialogButtonBox::standardButtonText() y QDialogButtonBox::standardButtonShortcut(), que devuelven el texto y el atajo de un QDialogButtonBox::StandardButton, respectivamente.
- En macOS, el modo unificado de título y barra de herramientas de QMainWindow se ha modernizado para utilizar vistas de efectos en el diseño del fondo.
Qt XML Módulo
No hay cambios destacables.
Herramientas
Qt Assistant
- Qt Assistant ahora muestra correctamente los diagramas SVG con tema claro u oscuro cuando está activo un esquema de colores oscuro, igual que en la documentación en línea de Qt.
Herramientas de línea de comandos de QML
- Se ha añadido la opción «
--only-explicit-categories» a qmllint para suprimir todas las advertencias predeterminadas. - Los tipos no registrados utilizados en propiedades y métodos de tipos registrados se registran ahora en qmltypes como tipos «opacos». Esto evita las advertencias en las herramientas, permite que el autocompletado y la función «ir a la definición» funcionen en qmlls, y habilita la compilación de enlaces a C++ en más lugares.
- Se han modificado qmllint y qmlls para que solo avisen una vez sobre los tipos desconocidos, en lugar de generar advertencias por cada enlace y cada uso del tipo desconocido.
- Se han añadido nuevas advertencias a qmllint y qmlls para:
- Miembros de tipos QML ocultos.
- Variantes de archivo seleccionadas incompatibles (opcional).
- Tipos QML instanciados de forma recursiva.
- Tipos QML a los que se hace referencia por su nombre de archivo en lugar de por su nombre en qmldir o
QT_QML_SOURCE_TYPENAME. - Usos en JavaScript de la sobrecarga de `
new Array()` que toma más de un argumento.
- Se ha añadido funcionalidad en ` QML Language Server ` para:
- Envolver componentes en un cargador mediante una acción de código.
- Buscar definiciones en C++ de tipos declarados mediante
QML_FOREIGN. - Mostrar el progreso durante las reconstrucciones en segundo plano de la información de tipos QML.
Generador de documentación QDoc
- Conceptos de C++20: El nuevo \concept comando «topic» genera una página de referencia específica para un concepto de C++20, que incluye una lista de los tipos y funciones documentados que están sujetos a dicho concepto. Las referencias a conceptos en las sinopsis de C++ enlazan con estas páginas tanto en la salida HTML como en la de DocBook, y los parámetros de plantilla restringidos directamente por un concepto (como
template <Integral T>) muestran el nombre del concepto en lugar de la palabra clave «typename». Los enlaces a conceptos funcionan más allá de los límites de los módulos a través de los archivos «.index». enable_ifLas restricciones SFINAE basadas en «requires» se representan como cláusulas «requires» legibles en lugar de parámetros de plantilla booleanos opacos y sin nombre, ampliando así la compatibilidad con la cláusula «requires» de C++20 introducida en Qt 6.11. Cuando una función también tiene una cláusula «requires» explícita, ambas se combinan.- Las funciones con valores por defecto explícitos y las funciones eliminadas llevan las etiquetas «
[default]» y «[delete]» en la sinopsis, mientras que las funciones miembro especiales generadas por el compilador se etiquetan como «[implicit]». Estas etiquetas enlazan con cppreference.com. En el caso de dichas funciones sin un \fn bloque, QDoc genera automáticamente la documentación sin emitir advertencias. La documentación explícita anula el texto generado, y al establecer la variable de configuración showautogenerateddocs enfalse, se omite de la salida. - QDoc distingue entre «amigos ocultos» —funciones «friend» que solo pueden encontrarse mediante la búsqueda dependiente de argumentos— y las declaraciones «friend» que simplemente conceden acceso. Documenta los «amigos ocultos», incluidos los definidos fuera de línea, utilizando su sintaxis natural de función libre, como
\fn operator==(const MyClass &, const MyClass &), en lugar de un nombre calificado por la clase. - Una tabla unificada sustituye a los párrafos dispersos de documentación comparativa generados por la \compares y \compareswith , que muestra de un vistazo con qué tipos se compara una clase y qué categoría de comparación se aplica a cada relación.
- El \a ahora valida los nombres de los parámetros de plantilla. QDoc advierte sobre los parámetros de plantilla no documentados en clases y alias de tipo, así como sobre los parámetros no de tipo o de plantilla-plantilla no documentados en funciones.
- Personaliza el descriptor de estado y el mensaje generados por el \preliminary comando con la variable de configuración preliminar, lo que permite utilizar términos como «Technology Preview» en lugar del valor por defecto. Los comandos de estado establecen una prioridad coherente: «
\preliminary» tiene prioridad sobre «\modulestate», y «\internal» tiene prioridad sobre ambos. - Un estado establecido en un tema de tipo «
\module» o «\qmlmodule», como «\preliminary» o «\deprecated», se propaga a los miembros del módulo, a menos que un miembro establezca su propio estado. - El nuevo \qmluncreatabletype comando «topic» documenta los tipos QML que están registrados en el sistema de tipos de QML pero que no pueden instanciarse. QDoc también detecta automáticamente los tipos anotados con la macro
QML_UNCREATABLE. - Las propiedades, señales y métodos asociados se anotan en las páginas principales de referencia de QML, no solo en las páginas de «todos los miembros».
- El \qmlmethod comando requiere una firma completa; QDoc avisa cuando falta el tipo de retorno o la lista de parámetros no se analiza correctamente.
- Las instrucciones «include» en la documentación de las clases reflejan los nombres reales de los archivos de cabecera indicados por Clang. Los proyectos que utilizan encabezados de conveniencia al estilo de Qt (como
<QString>) siguen funcionando automáticamente. - Cada proyecto obtiene un único archivo
.indexen el directorio de salida base, que sustituye a las copias específicas de cada formato en los subdirectorios correspondientes. Las rutas relativas de la variable de configuración «indexes» se resuelven en función de la ubicación del archivo.qdocconf, en consonancia con otras variables de ruta. - Los archivos HTML generados incluyen entradas automáticas en
<meta name="keywords">basadas en el tipo de página (clase, tipo QML, módulo, ejemplo, etc.), lo que facilita el posprocesamiento y la generación del mapa del sitio. Los bloques de código llevan etiquetas compatibles con el resaltado de sintaxis de highlight.js. - Pequeñas mejoras en la creación de documentación: utiliza \meta
qdoc-suppress-inheritancepara suprimir la línea «Inherits:» en los tipos que heredan de una clase base, únicamente a efectos de documentación; \list se respetan los valores iniciales de cero o inferiores;\#representa el carácter literal «#» en los destinos de los enlaces\l; y \details impone su argumento de resumen delimitado por llaves, tal y como se documenta. - Se ha añadido compatibilidad con LLVM/Clang 22.
Qt Linguist
- Ahora «lupdate» conserva los finales de línea existentes en los archivos
.ts. En Windows, los archivos con finales de línea CRLF se actualizan in situ con CRLF; los archivos con finales de línea LF y los archivos nuevos conservan LF. - Qt Linguist Cuenta con una nueva opción, -web-help, para utilizar la documentación web en línea si se desea.
Resource Compiler (rcc)
- rcc ahora deduplica los datos de recursos utilizando el hash SHA256 basado en el contenido. Los archivos idénticos incrustados en una colección de recursos de Qt se almacenan solo una vez, lo que reduce el tamaño de los recursos compilados sin necesidad de modificar el código fuente de la aplicación.
Cambios en la plataforma
Cambios en el sistema de compilación
Compilación de Qt
- Ahora, para compilar Qt se requiere CMake 3.25 o posterior.
- Se ha añadido la función de CMake «
static_compiler_runtime» para vincular de forma estática las bibliotecas de tiempo de ejecución de C++. En Windows (MSVC), esto utiliza el método Hybrid CRT, lo que elimina la dependencia del paquete redistribuible de Visual C++. - La compilación de Qt para Android utiliza ahora Gradle en lugar de invocar directamente «
javac» para los objetivos JAR de Qt.
API de CMake
- El uso de Qt requiere ahora CMake 3.25 o posterior.
- Las siguientes funciones de la API de CMake han salido de la fase de «Technology Preview» y ahora son totalmente compatibles: qt_finalize_project(), qt_extract_metatypes(), qt_deploy_translations(), QT_TARGETS_FOLDER, QT_RESOURCE_PREFIX, QT_DEPLOY_SUPPORT y QT_ENABLE_VERBOSE_DEPLOYMENT.
- La propiedad de destino «
qt_no_entrypoint» ha pasado a llamarse «QT_NO_ENTRYPOINT». El nombre antiguo sigue siendo válido para garantizar la compatibilidad con versiones anteriores. - Se ha añadido la política de CMake «
QTP0006». Cuando se establece en «NEW», las funciones «qt_generate_wayland_protocol_client_sources() » y «qt_generate_wayland_protocol_server_sources()» utilizan por defecto «PRIVATE_CODE» en lugar de «PUBLIC_CODE». - Los mensajes de progreso de`qt_add_shaders()` ahora se registran con el nivel de registro `
DEBUG` en lugar de `NOTICE`, lo que los oculta de la salida predeterminada de la compilación. Pasa `--log-level=NOTICE` a CMake para restablecer el comportamiento anterior. - qt_add_qml_module() cuenta ahora con una opción «
NO_GENERATE_QTCONF» para suprimir la generación automática de «qt.conf» en el directorio de compilación. - El sistema de compilación ofrece ahora un objetivo <exe>_qmlpreview para cada ejecutable con un módulo QML. Al «compilar» ese objetivo, el sistema de compilación inicia la utilidad qmlpreview con los argumentos correctos y te permite obtener una vista previa en QML de tu ejecutable. En concreto, resuelve automáticamente las rutas de los archivos .qrc.
- Ahora están disponibles dos nuevos valores de destino: QT_WINDOWS_APP_PROJECT_IDENTIFIER y QT_WINDOWS_APP_PROJECT_EXECUTION_LEVEL. Véase también la sección sobre Windows más abajo.
Plataformas de escritorio
Windows
- Los proyectos CMake ahora generan e incorporan automáticamente un manifiesto de aplicación para los ejecutables de Windows compilados con qt_add_executable(). El manifiesto declara la compatibilidad con Windows 10/11, habilita el reconocimiento de rutas largas y configura el nivel de ejecución del UAC. Dos nuevas propiedades de destino de CMake controlan el manifiesto generado: QT_WINDOWS_APP_PROJECT_IDENTIFIER establece el nombre de identidad del ensamblado, y QT_WINDOWS_APP_PROJECT_EXECUTION_LEVEL establece el nivel de ejecución. Consulta Qt para Windows - Implementación para obtener más detalles.
- windeployqt incorpora las opciones
--appxy--appx-certificatepara generar un archivo «AppxManifest.xml» adecuado para empaquetar como un paquete appx de la Tienda Windows. - QOperatingSystemVersion::Windows11_25H2 Se añade (10.0.26200) como constante con nombre para la versión del sistema operativo.
- En Windows, el complemento de plataforma ahora obtiene el espacio de color de cada pantalla a partir de su perfil ICC mediante
ColorProfileGetDisplayDefault, en lugar de indicar siempre sRGB. - El backend de fuentes DirectWrite ahora lee la tabla GASP de cada fuente para seleccionar la estrategia de suavizado adecuada según la fuente y el tamaño del punto, lo que se ajusta mejor a la intención del diseñador de la fuente.
- Se ha vuelto a habilitar la caché de disco de los shaders para los controladores actuales de las GPU de Intel. Llevaba varios años deshabilitada de forma incondicional para los gráficos de Intel en Windows; ahora se utiliza en su lugar una comprobación de la versión del controlador, lo que mejora el rendimiento 3D de Qt Quick en el hardware moderno de Intel.
- QWizard Ya no se aplica el estilo del asistente de Aero cuando el sistema está en modo oscuro, ya que no se representa correctamente.
- Ahora se admite plenamenteARM64EC con Visual Studio 2026. No hay paquetes de instalación. Algunos módulos, como Qt WebEngine, Qt WebView y Qt Quick 3D Physics, no son compatibles.
Linux
- QDesktopServices::openUrl() ahora da prioridad al servicio de portal de escritorio XDG de
org.freedesktop.portal.OpenURI, si está disponible, frente axdg-openy las demás alternativas. El portal puede comportarse de forma diferente a las aplicaciones utilizadas anteriormente. - Se han actualizado las alternativas utilizadas cuando no hay ningún portal disponible: ahora se reconoce
kde-opende Plasma 6, mientras que se ha eliminado la compatibilidad conkfmclient, de la era de KDE 3. - La nueva propiedad « motionPreference » se rellena a partir de la configuración del escritorio: la clave «
reduced-motion» en el espacio de nombres del portal «org.freedesktop.appearance» y la configuración «org.gnome.desktop.interface» de GNOME en «enable-animations». - El cuadro de diálogo nativo de fuentes de GTK3 ahora respeta las opciones de filtrado de fuentes de QFontDialog, tanto para fuentes escalables frente a no escalables como para fuentes monoespaciadas frente a proporcionales.
- El puente de accesibilidad AT-SPI ahora notifica a las tecnologías de asistencia los cambios en los estados «expandido» y «expandible».
- Las fuentes añadidas desde los recursos de Qt se registran de nuevo correctamente cuando se ejecutan con fontconfig 2.17.1 o posterior.
- En X11, las ventanas de información ya no se vuelven a crear cada vez que se muestran.
- QNetworkProxy Ahora entiende el esquema «
socks5h» en las variables de entorno «*_PROXY» cuando se utiliza el backend libproxy.
macOS
- QScreen::grabWindow() ahora utiliza ScreenCaptureKit en lugar de
CGDisplayCreateImageForRect, que ha quedado obsoleto. La primera vez que se utilice la API, aparecerá un mensaje solicitando permiso. - QWindows Los elementos anidados en «
NSView» no invertidos conservan ahora su posición relativa a la esquina superior izquierda de la supervista cuando se cambia el tamaño de esta. QCocoaNativeInterface::setEmbeddedInForeignView()Ya no es necesario ni está admitido incrustar una jerarquía de vistas Qt en unNSViewajeno. Qt ahora gestiona esto automáticamente.- Las aplicaciones en entorno de pruebas compiladas con una versión estática de Qt ahora son reubicables por defecto en las plataformas de Apple.
- QMainWindowEl modo unificado de título y barra de herramientas de «'» se implementa ahora mediante Qt::ExpandedClientAreaHint y Qt::NoTitleBarBackgroundHint, en lugar del estilo texturizado
NSWindow, que ha quedado obsoleto. - QStandardPaths::standardLocations() incluye ahora el directorio
/Library/Preferences, válido para todo el sistema, paraConfigLocation,GenericConfigLocationyAppConfigLocation.
Cliente Wayland en Linux
- Se ha añadido compatibilidad con la extensión del protocolo Wayland «
XdgSessionManager» para la restauración de sesiones. - El tema de decoración «bradient» del lado del cliente muestra ahora indicaciones para los botones de minimizar, maximizar y cerrar.
Compositor de Wayland
- Se ha añadido compatibilidad con el protocolo estable «
linux-dmabuf-v1», versión 4. Para utilizarlo, selecciona «linux-dmabuf-v1» como integración del búfer del cliente. La implementación anterior (versión 3) sigue estando disponible con el nombre «linux-dmabuf-unstable-v1» por motivos de compatibilidad.
HarmonyOS
Qt 6.12 introduce la compatibilidad con HarmonyOS (nivel de API de OpenHarmony 23, HarmonyOS 6.1.0) como vista previa tecnológica. Se admite Vulkan, mientras que la accesibilidad y EmbeddedUIExtensionAbility aún no están disponibles.
Se proporcionan las siguientes herramientas y funciones de CMake para facilitar la compilación y el despliegue de aplicaciones Qt en HarmonyOS:
- harmonydeployqt empaqueta una aplicación Qt como un paquete de aplicación de HarmonyOS (HAP), copia las bibliotecas y los complementos de Qt necesarios, genera los metadatos de
build-profile.json5ymodule.json5, y admite la incorporación de la configuración de firma del HAP. harmonyostestrunnerejecuta las pruebas automáticas de Qt en un dispositivo HarmonyOS conectado o en un emulador a través dehdc, activadas desdectest.- qt_add_harmonyos_permission() declara los permisos de HarmonyOS que requiere la aplicación.
Las propiedades clave de los objetivos de CMake para la implementación en HarmonyOS incluyen:
- QT_HARMONYOS_EXTRA_LIBS: bibliotecas compartidas adicionales que se deben incluir en el HAP.
- QT_HARMONYOS_EXTRA_PLUGINS: complementos Qt adicionales que se van a implementar.
- QT_HARMONYOS_PACKAGE_SOURCE_DIR: un directorio cuyo contenido se integra en la plantilla de proyecto de HarmonyOS generada antes de compilar el HAP.
Para obtener una lista completa de las limitaciones conocidas de la plataforma, consulta la página wiki de limitaciones de la plataforma Qt para HarmonyOS.
Plataformas móviles
Android
Qt para Android
- Se ha actualizado Gradle a la versión 9.5.1 y el complemento de Gradle para Android a la versión 9.2.1.
- Se ha actualizado la versión predeterminada del SDK de destino a Android 17 (nivel de API 37).
- Se ha añadido compatibilidad con el gesto predictivo de «Atrás» en Android 13 y versiones posteriores. Qt transmite los eventos de «Atrás» a través de
OnBackInvokedCallbacky habilita el atributo del manifiesto «android:enableOnBackInvokedCallback» de forma predeterminada. - Se ha añadido compatibilidad con las compilaciones multimódulo de Gradle, que se activan con QT_ANDROID_GRADLE_MULTI_MODULE. Esta es la base para Play Feature Delivery. CMake gestiona todo el proceso de implementación sin necesidad de androiddeployqt ni herramientas de terceros, lo que hace que las compilaciones sean más rápidas y sencillas.
- Se ha dejado de utilizar la variable de CMake «
QT_USE_ANDROID_MODERN_BUNDLE» en favor de «QT_ANDROID_GRADLE_MULTI_MODULE». El nombre antiguo sigue siendo reconocido por motivos de compatibilidad con versiones anteriores. - Se ha añadido compatibilidad con las sugerencias de métodos de entrada « Qt::InputMethodHint::ImhNoFullscreen », « ImhDecimalNumbersOnly » y « ImhNoEditMenu ».
- Al pulsar la tecla «Atrás», ahora la aplicación pasa a segundo plano en lugar de cerrarse; consulta «Tecla Atrás» y «Gesto de retroceso».
- Mejoras de accesibilidad para TalkBack:
- Qt ahora reacciona a la acción
ACTION_SHOW_ON_SCREEN. - Qt ahora informa de los cambios en el área de visualización desplazada y en la posición de desplazamiento.
- Qt ahora admite los estados «expandible» y «expandido».
- El teclado virtual ya no se abre cuando el foco de accesibilidad se desplaza a un campo de entrada de texto.
- La sugerencia « motionPreference » (Teclas de acceso rápido) ahora refleja la configuración del sistema « Remove animations » (Aplicar teclas de acceso rápido).
- Qt ahora reacciona a la acción
- androidtestrunner ahora reconoce las opciones «
--serial» y «--output», detecta las desconexiones del dispositivo durante la ejecución de una prueba y muestra diagnósticos mejorados de fallos y de «La aplicación no responde» (ANR). - Qt ahora implementa automáticamente las bibliotecas OpenSSL cuando la compilación de FFmpeg incluida las requiere, localizándolas a través de
OPENSSL_ROOT_DIRo vcpkg. - La plantilla de Gradle ya no fuerza el uso de
resConfig "en".
Qt Quick para Android
iOS
- QStandardPaths::PublicShareLocation ahora devuelve
<APPROOT>/Public(que coincide conNSSharedPublicDirectory) en lugar de la ruta sintetizada anteriormente dentro del directorio «Documentos». - standardLocations(
PicturesLocation) ya no contiene una entrada duplicada para la ruta «Documentos/Imágenes» en la que se puede escribir. - QStandardPaths::TemplatesLocation Ahora se indica correctamente que no es compatible con iOS, tal y como se indica en la documentación existente.
Plataformas integradas
Boot to Qt y Qt Onboard
- A partir de Qt 6.12 LTS, las imágenes precompiladas de Boot to Qt ya no están disponibles para su descarga a través de Qt Online Installer ni desde tu cuenta de Qt.
En lugar de los binarios, se introducen dos formatos basados en contenedores:
- Un contenedor de compilación: un entorno listo para usar con todas las herramientas de compilación necesarias preinstaladas, que permite crear rápidamente imágenes de Linux basadas en Yocto para tu hardware de destino.
- Un contenedor de demostración: contiene el Qt Demo Launcher con un conjunto seleccionado de demostraciones que muestran las capacidades de Qt tal y como viene de fábrica.
Los contenedores se introducirán por fases durante el ciclo de lanzamiento de parches de Qt 6.12 LTS, y la distribución completa basada en contenedores estará disponible antes del lanzamiento de Qt 6.12.4.
- Nuevas plataformas:
- Orange Pi 2
- NXP i.MX95
- Qualcomm Dragonwing IQ6
- Qualcomm Dragonwing IQ9
- Renesas RZ/G3E
Sistemas operativos en tiempo real
QNX
- Se ha añadido compatibilidad con Vulkan en QNX.
- Qt Multimedia Ahora se compila en QNX 8.0. La reproducción y la grabación de audio aún no están disponibles, ya que el backend de audio aún no se ha implementado para QNX SDP 8.0.
VxWorks
- Se ha añadido compatibilidad con VxWorks 26.03.
WebAssembly
- QAudioSource y QAudioSink utilizan ahora el backend AudioWorklets de la API Web Audio en lugar de OpenAL, lo que permite la captura de audio de baja latencia nativa del navegador.
- Los fotogramas de vídeo se cargan ahora en WebGL mediante
texImage2Dpara un renderizado sin copia cuando se utiliza Qt Quick. - Se ha añadido compatibilidad con QCameraFormat.
Lista de cambios en la API
Estas páginas contienen una descripción general de los cambios en la API de Qt 6.12:
Problemas conocidos
Para obtener información sobre los problemas conocidos en Qt 6.12, consulta la wiki de Qt.
© 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.