Novedades de Qt 6.10

Módulos nuevos y restaurados en Qt 6.10

Qt 6.10 añade los siguientes módulos y herramientas:

Nuevas características en Qt 6.10

Qt Core Módulo

• QLocale se actualiza ahora a CLDR v47
• QLocale::uiLanguages() ahora incluye entradas truncadas y está mejor ordenada
• QLocale::toStringLas sobrecargas () para tipos integrales ahora aceptan precisión y anchura
• La configuración regional del sistema se distingue ahora en la salida de qDebug() de la derivada de CLDR para el mismo idioma, script y territorio.
• QLocale::toStringEl separador de exponentes de (double, ...) ahora vuelve a coincidir con el caso solicitado
• QCalendar::daysInMonth() para un año no especificado da ahora el valor máximo
• La nueva clase QRangeModel proporciona una implementación de QAbstractItemModel que puede operar en cualquier rango de C++.
• QXmlStreamReader::readRawInnerData() para recuperar el contenido XML interno sin procesar de un elemento.
• API de gestión de errores para QXmlStreamWriter con las funciones Error enum, error(), errorString() y raiseError().
• QXmlStreamWriter::stopWritingOnErrorSe ha añadido la propiedad (), que permite a los usuarios controlar si la salida se detiene inmediatamente después de encontrar un error.
• Se ha añadido QFuture::cancelChain() para cancelar toda la cadena de continuación utilizando cualquier QFuture no finalizado de la cadena.
• El nuevo qEnvironmentVariableIntegerValue devuelve el valor numérico de una variable de entorno, o std::nullopt si la variable no está establecida o no contiene un número entero.
• QFileInfo::isOther() devuelve verdadero para las entradas del sistema de archivos que no son ni un directorio, ni un archivo normal, ni un enlace simbólico.
• Se ha añadido QSortFilterProxyModel::endFilterChange() tomando un parámetro Direction, para equilibrar una llamada anterior a endFilterChange(). Estas API sustituyen a invalidateFilter(), que quedará obsoleta a partir de Qt 6.13.
• Dos nuevas sobrecargas de QMetaObject::connect() permiten conectar la QMetaMethod de una señal a una función slot o lambda.
• QCborValue::toStringView() y QJsonValue::toStringView() devuelven una vista de la cadena almacenada en el valor, sin ninguna asignación.
• Utilice QDataStream::operator bool() y QTextStream::operator bool() para comprobar si el flujo se encuentra en estado de error.
• Utilice nullTerminate() para añadir un terminador nulo a QByteArray o QString, por ejemplo, después de construirlos mediante QByteArray::fromRawData(). Compruebe si la matriz o cadena tiene terminación nula con nullTerminated().
• QByteArray puede ahora convertirse implícitamente en un std::string_view.

Qt D-Bus El módulo

• QDBusConnectionInterface::serviceCredentials() devuelve las credenciales de conexión para el proceso que actualmente mantiene el servicio de bus especificado.

Qt Graphs Módulo

• Añadido el tipo de gráfico de superficie rellena: DrawFilledSurface
• Se ha añadido la posibilidad de ocultar texto en ejes 2D: QAbstractAxis::textElideMode
• Se ha añadido la posibilidad de ocultar las etiquetas de las porciones pequeñas: QPieSeries::angleSpanVisibleLimit, QPieSeries::angleSpanLabelVisibility, QPieSeries::LabelVisibility
• Soporte multi-eje para gráficos 2D añadido: QAbstractSeries::axisX, QAbstractSeries::axisY
• Soporte Hover para series 2D añadido: QAbstractSeries::isHovered
• Soporte para controlar el recorte del área de trazado en gráficos 2D añadido: clipPlotArea
• Soporte para la consulta de coordenadas de puntos de datos en LineSeries añadido: QLineSeries::dataPointCoordinatesAt
• Soporte para renderizar un corte en una imagen en Bars3D y Surface3D añadidos: Q3DBarsWidgetItem::renderSliceToImage, Q3DSurfaceWidgetItem::renderSliceToImage, QtGraphs3D::SliceCaptureType
• Añadidos: Bars3DNode, Scatter3DNode, y Surface3DNode para añadir gráficos 3D en aplicaciones QtQuick3D dentro de View3Ds
• Añadido soporte de ordenación de dibujo de gráficos para gráficos 2D: QAbstractSeries::zValue
• Añadido soporte de registro categorizado

Qt GRPC Módulo

• Mejoras de rendimiento y corrección de errores para QGrpcHttp2Channel. Lea el blogpost aquí.
• Añadidas las interfaces unix-abstract Transportation scheme a QGrpcHttp2Channel.
• Añadidas las interfaces serverInitialMetadata y serverTrailingMetadata a QGrpcOperation.
• Añadidas las opciones QGrpcCallOptions::filterServerMetadata y QGrpcChannelOptions::filterServerMetadata para controlar el filtrado de los metadatos recibidos del servidor.
• Se han añadido QGrpcCallOptions::addMetadata y QGrpcChannelOptions::addMetadata para soportar actualizaciones incrementales de metadatos de cliente.
• Interfaces metadata obsoletas en favor de interfaces basadas en QMultiHash: metadata(QtGrpc::MultiValue), setMetadata(QMultiHash).

Qt GUI El módulo

• QStyleHints::accessibility proporciona acceso a las preferencias de accesibilidad del usuario, como por ejemplo si el sistema ha activado un ajuste para aumentar el contraste.
• Añadido QAccessibilityHints para acceder a ajustes individuales de accesibilidad.
• QRhi: Añadido soporte para enumerar adaptadores gráficos 3D (dispositivos físicos), cuando se ejecuta en Direct 3D 11, 12, o Vulkan, a través de la función enumerateAdapters().
• QPainterPath::setCachingEnabledLa función () puede utilizarse para activar el almacenamiento en caché de valores calculados, lo que aumenta el rendimiento de determinadas operaciones a expensas de un uso adicional de memoria.
• Se ha añadido QPainterPath::trimmed() para devolver una sección de la ruta.

Módulo HttpServer de Qt

• Añadida lista blanca y lista negra de subredes en QHttpServerConfiguration.
• Añadido tiempo de espera configurable en QHttpServerConfiguration.
• Hecho QHttpServerRequest copiable.

Qt Lottie Animation

• Añadido soporte para capas sólidas, nulas y de precomposición.
• Añadida la herramienta lottietoqml. Es una herramienta equivalente a svgtoqml y convierte archivos Lottie en escenas Qt Quick descritas en QML. Actualmente está en vista previa técnica.
• Se ha añadido un complemento para VectorImage que permite cargar archivos Lottie además de SVG. Esta característica está en vista previa técnica y requiere que assumeTrustedSource se establezca en true.
• Se han añadido los ejemplos lottietoqml y qtlottieviewer para demostrar el uso de . Qt Lottie Animation.

Qt Multimedia Módulo

• Añadido un backend de audio nativo PipeWire.
• Compensación de tono de audio para el QMediaPlayer basado en FFmpeg basado en la excelente biblioteca Signalsmith Stretch. El comportamiento se puede personalizar a través de la propiedad pitchCompensation.
• QCapturableWindow ahora se puede construir a partir de QWindow tanto en C++ como en QML.
• Se ha añadido una nueva clase QPlaybackOptions que permite a los usuarios controlar las opciones de reproducción multimedia de bajo nivel de FFmpeg, por ejemplo, la intención de reproducción, el tiempo de espera de la red y el tamaño de la sonda.
• En QAudioSink y QAudioSource, se han añadido métodos que permiten a los usuarios operar con el búfer de audio subyacente en recuento de fotogramas en lugar de en recuento de bytes.

Qt Network Módulo

• Añadido el método fromFile() a QSslCertificate.
• Añadido el método setDateTimeValue() a QHttpHeaders, un método práctico para establecer valores de fecha y hora en las cabeceras HTTP.
• Se han añadido métodos a QHttpHeaders para recuperar valores como QDateTime, enteros o listas de estos tipos.

Qt Protobuf Módulo

• Añadido Qt Protobuf Mutable Getters a los mensajes Protobuf generados, haciéndolos accesibles mediante el prefijo mut.

Qt Qml Módulo

• Añadido un nuevo tipo QML TreeModel que permite definir una estructura de árbol en el archivo QML y funciona con TreeView.
• Añadido el tipo QML SortFilterProxyModel para ordenar y filtrar los datos del modelo. Esta característica está en vista previa técnica.
• Añadida la propiedad delegateModelAccess a DelegateModel y a todas las vistas. Ahora puede escribir a través de las propiedades requeridas en el modelo.
• Añadido el tipo QML Synchronizer. El sincronizador mantiene dos o más propiedades sincronizadas sin utilizar enlaces. Esta característica está en vista previa técnica.
• Añadidas reglas de personalización del punto y coma a qmlformat. Ahora puede controlar si se añade punto y coma al final de las sentencias JS.
• Añadidas nuevas advertencias qmllint enfocadas a mejorar la compatibilidad con Qt Creator, incluyendo comprobaciones de limitaciones específicas de Qt Design Studio, advertencias adicionales relacionadas con JavaScript y varias advertencias nuevas relacionadas con enums e importaciones QML.
• Se ha eliminado la compatibilidad con la manipulación de estructuras de filas complejas de TableModel.
• Se ha modificado el orden de los parámetros role y value en TableModel::setData para resolver una ambigüedad.

Qt Quick Módulo

• Añadido el tipo QML FlexboxLayout para organizar los elementos rápidos de forma flexible, similar a CSS Flexbox. Esta función se encuentra en la vista previa técnica.

Qt Quick Controls Módulo

• El estilo FluentWinUI3 ha mejorado la compatibilidad con temas de contraste en Windows 11.
• Añadido SearchField Control

Qt Quick Dialogs Módulo

• Se ha añadido la propiedad popupType que se puede utilizar para controlar si un diálogo no nativo debe abrirse en una ventana separada o como un elemento en la escena existente. Esto no tiene efecto cuando se utilizan diálogos nativos.

Qt Quick Módulo Efectos

Qt Quick Módulo 3D

• Se ha añadido emitType a los emisores de forma para permitir la emisión de partículas en función de las normales de la superficie de la forma.
• Se han implementado emisores reversed para permitir que las partículas se ejecuten desde la hora de finalización hasta la hora de inicio.
• Varias mejoras y cambios relacionados con los mapas de luz:
  • Se han introducido tamaños de lightmap basados en texels por unidad, añadiendo las propiedades Model::texelsPerUnit y Lightmapper::texelsPerUnit y sustituyendo la propiedad Model::lightmapBaseResolution, ahora obsoleta.
  • Se ha introducido la propiedad Lightmapper::source para establecer una fuente de mapa de luz para toda la escena, sustituyendo y dejando obsoleta la propiedad BakedLightmap::loadPrefix.
  • Se ha añadido una eliminación de ruido de medios no locales (NLM) basada en la GPU para los mapas de luz horneados, controlada mediante la propiedad Lightmapper::denoiseSigma.
  • Se ha mejorado la ventana de horneado de mapas de luz para mostrar una barra de progreso y una estimación del tiempo restante.
  • El baking se realiza ahora en su propio contexto RHI y no bloquea el renderizado de la aplicación en ejecución.
  • Se ha reducido el uso de RAM y VRAM al bakear ciertas escenas.
  • Se ha añadido una herramienta de visualización de mapas de luz para depurar los archivos de mapas de luz bakeados a través de la interfaz gráfica de usuario o de la línea de comandos.
• Corregida la importación de color para glTF2 baseColorFactor convirtiendo correctamente de lineal a sRGB, alineándolo con la especificación.
• Añadido CapsuleGeometry a QtQuick3D.Helpers con texturas fijas, soporte de creación asíncrona y propiedad uvProfile expuesta.

Qt Quick Módulo 3D XR

• Expuesto method para solicitar escaneo de sala para anclajes espaciales.

Qt Quick Módulo 3D Physics

• Obsoleto CapsuleGeometry en favor del mejorado en QtQuick3D.

Qt Quick Módulo VectorImage

• Añadido soporte para SVG animados que coincide con el soporte de animación en Qt SVG.
• Añadido API para indicar si el archivo fuente es de confianza o no.
• Añadido API para controlar el comportamiento de la animación.
• Mediante la inclusión de un plugin proporcionado por Qt Lottie AnimationVectorImage ahora también puede mostrar archivos Lottie. Esta función se considera una vista previa técnica y requiere que assumeTrustedSource se ajuste a true.

Qt Serial Port Módulo

• Añadido soporte para limitar el tamaño del buffer de escritura usando la propiedad writeBufferSize.

Qt Serial Bus Módulo

• Añadido el constructor de movimientos que faltaba en QCanBusDeviceInfo.
• Convertir QCanBusFrame::FrameType y QCanBusFrame::FrameError en QMetaEnums.
• El plugin SocketCAN ya no establece un bitrate por defecto para evitar advertencias en tiempo de ejecución. La configuración de la tasa de bits debe hacerse mediante el sistema ip link set ... o mediante libsocketcan y QCanBusDevice::setConfigurationParameter(QCanBusDevice::BitRateKey, ...).
• El plugin VirtualCAN soporta ahora hasta diez canales CAN virtuales de can0 a can9.

Módulo Qt SQL

Qt SVG Módulo

• Añadido soporte para animaciones CSS para las propiedades fill-opacity, stroke-opacity y opacity.
• Añadido un ejemplo que demuestra cómo ver archivos SVG.

Qt Test Módulo

• Los benchmarks basados en datos ahora identifican tanto los datos globales como los locales en nombres de texto plano
• Los rastreos de lldb ahora están desactivados en Apple Silicon
• Cuando QTest imprime valores de punto flotante en una comparación, ahora da la precisión completa e incluye una versión hexfloat

Módulo Qt VirtualKeyboard

• Añadida información PURL y CPE a los archivos de atribución de fuentes de terceros.
• Añadida distribución de teclado en letón.

Qt WebEngine Módulo

• Añadido soporte para extensiones Chromium, usando QWebEngineExtensionManager y QWebEngineExtensionInfo
• Añadido soporte para añadir certificados CA de confianza adicionales a un perfil de sitio web sin añadirlos al almacén de certificados de la plataforma: setAdditionalTrustedCertificates
• Añadido soporte para caché Back/Forward habilitada usando QWebEngineSettings::BackForwardCacheEnabled

Qt WebView Módulo

• Añadido el plugin WebView2 para la plataforma Windows. El nuevo backend utiliza una API COM nativa del navegador Edge basado en Chromium llamada WebView2. Por lo tanto, ahora puede proporcionar contenido web sin necesidad de enviar Qt WebEngine.

Qt Widgets Módulo

• Se ha añadido compatibilidad con el modo de contraste aumentado para los estilos de widgets de fusión, macOS y Windows 11.
• El manejo de eventos por defecto del editor en las vistas de elementos se ha trasladado a la nueva función QAbstractItemDelegate::handleEditorEvent(), que los manejadores de eventos personalizados pueden utilizar para continuar con el manejo de eventos estándar.
• Utilice setSupportedDragActions() en QListWidget, QTableWidget, y QTreeWidget para cambiar las acciones de arrastre admitidas.
• Las nuevas propiedades QLayout::horizontalSizeConstraint y QLayout::horizontalSizeConstraint permiten establecer individualmente las restricciones de tamaño horizontal y vertical del widget.

Qt XML Módulo

Módulo Qt MQTT

• Añadir soporte para WebSockets/Secure WebSockets

Herramientas

Generador de documentación QDoc

• QDoc ahora puede añadir automáticamente enlaces "ver fuente" a cada declaración de API de C++. Habilite la función con la nueva familia url.sources de variables de configuración (url.sources.enabled, url.sources.rootdir, url.sources.linktext).
• QDoc detecta ahora la herencia circular en tipos QML utilizando el algoritmo de búsqueda de ciclos de Floyd e informa del problema en lugar de quedarse atascado en un bucle infinito.
• Los grupos de propiedades QML definidos en archivos .qml se reconocen y muestran como una única propiedad agrupada cuando se documentan con comandos \qmlproperty.
• Los archivos fuente generados por herramientas Qt (moc_, uic_, qrc_, etc.) ahora se omiten automáticamente, lo que acorta el tiempo de compilación de QDoc en proyectos grandes.
• El tipo de datos mostrado para una propiedad QML dentro de un archivo .qml ahora se puede anular directamente en el comando \qmlproperty, incluso para propiedades no suavizadas.
• La opción documentationinheaders ya no se ofrece como avance tecnológico, sino que se considera estable. Se introdujo por primera vez en Qt 6.9.
• Al generar la salida DocBook, QDoc incluye ahora notas de sobrecarga.
• Las señales y ranuras sobrecargadas ahora incluyen un fragmento contextual para mostrar su uso.
• QDoc puede enlazar con bibliotecas Clang desde LLVM 21.
• Los archivos .index incluyen el tipo de retorno declarado en \fn-commands. Esto es útil para construcciones multi-proyecto, cuando los autores sobrescriben el tipo de retorno de una función con auto.
• Ahora puede documentar sus enumeraciones QML con el nuevo comando \qmlenum nuevo. QDoc crea una nueva sección, Enumeraciones QML, en la documentación generada.
• La sangría de los fragmentos de código está ahora normalizada, eliminando el exceso de espacio en blanco del margen izquierdo. Esto significa que los fragmentos de código fuente que están muy sangrados (por ejemplo, en una serie muy anidada de declaraciones if) se presentarán como si no estuvieran anidados.
• QDoc ahora analiza correctamente los alias de plantilla con parámetros por defecto.
• QDoc ya no enlaza automáticamente a funciones obsoletas si existen alternativas no obsoletas.
• Puede evitar la traducción automática de cadenas mediante el nuevo comando \notranslate.

Qt Linguist

• Se ha añadido soporte para organizar traducciones basadas en ID con etiquetas personalizadas en Qt Linguist y lupdate.
• Se ha introducido una función de vista previa de formularios QML en Qt Linguist para la validación visual de traducciones en contexto.
• Se ha actualizado Qt Linguist con una interfaz de usuario renovada, que incluye nuevos iconos, una paleta de colores mejorada y una mejor gestión del modo oscuro.
• lupdate y lrelease permiten ahora mezclar traducciones basadas en ID y en texto dentro del mismo documento.
• Eliminado el analizador sintáctico basado en Clang de lupdate.
• Soporte unificado para meta cadenas (comentarios como //: y //~) a través de diferentes lenguajes de programación en lupdate.
• Añadidos nuevos ejemplos de i18n a la documentación.
• lrelease ahora proporciona la opción -fail-on-unfinished para que falle la compilación si hay traducciones sin terminar.
• Desaprobado el uso de //= metastring comments para establecer IDs para traducciones basadas en texto.

Cambios en la plataforma

Cambios en el sistema de compilación

• El uso de un módulo Qt privado Foo ahora requiere una llamada a find_package(Qt6 COMPONENTS FooPrivate) para que el objetivo Qt6::FooPrivate esté disponible.
• Se ha añadido una opción DISCARD_FILE_CONTENTS a qt_add_resources().
• Se ha eliminado la opción FILENAME_VARIABLE de qt6_generate_deploy_[app_]script, que quedó obsoleta en Qt 6.6.0.
• Se ha añadido el argumento NO_PLUGINS a qt_deploy_runtime_dependencies. Esto desactiva completamente el despliegue de plugins.
• Añadidos los argumentos INCLUDE_PLUGIN_TYPES, EXCLUDE_PLUGIN_TYPES, INCLUDE_PLUGINS, y EXCLUDE_PLUGINS a qt_deploy_runtime_dependencies.
• Añadidos argumentos para seleccionar plugins Qt a qt_generate_deploy_app_script.
• qt6_import_plugins ya no tiene efecto en el despliegue de plugins con la API de despliegue de CMake en Linux.
• qt6_deploy_runtime_dependencies ahora soporta las siguientes banderas de selección de plugins en Linux: INCLUDE_PLUGINS, INCLUDE_PLUGIN_TYPES, EXCLUDE_PLUGINS, EXCLUDE_PLUGIN_TYPES.
• Se ha añadido la opción DISCARD_QML_CONTENTS a qt_add_qml_module(), que elimina el contenido original de los archivos QML y JS del sistema de recursos del destino.

Plataformas de escritorio

Windows

• Los binarios preconstruidos para Windows en ARM también incluyen QtWebEngine y QtWebView.

Linux

• Los binarios precompilados de escritorio de Linux se crean ahora con RHEL9, que aumenta el requisito mínimo de glibc de 2.28 a 2.34.

macOS

• Las ventanas que optan por el rango dinámico ampliado (EDR) ahora desencadenan un evento de exposición al cambiar el brillo de la pantalla
• Ahora se admite la propiedad de accesibilidad titleUIElement.
• La integración del menú de servicio ahora tiene en cuenta el texto enriquecido
• QOperatingSystemVersion::MacOSTahoe representa macOS 26
• Se han añadido mapeos para WhatsThisCursor y BusyCursor
• QImage::toCGImage() propaga ahora el espacio de color de la imagen

Cliente Wayland en Linux

Plataformas móviles

Android

Qt para Android

• Actualizado Gradle a la versión 8.14.2 y Android Gradle Plugin AGP a la versión 8.10.1.
• Añadido soporte para Android 12 Splash Screen.
• Añadido soporte para Android 16KB tamaños de página.
• Añadido un ejemplo (QtJennyDemo) para acceder a las APIs de Android a través de envoltorios C++ producidos por un generador de código (QtJenny).
• Cambiado Android 16 (API 36) como máxima versión de plataforma soportada.

Qt Quick para Android

• Añadido soporte de múltiples argumentos para señales bajo QtQuickView.
• Añadido soporte para registrar escuchadores de señales antes de que QML esté completamente cargado.
• API Java públicas en formato javadoc.

iOS

• Añadido soporte QPointingDevice para Apple Pencil
• Rotación fija para Apple Pencil estándar
• Añadido soporte para la función hover para Apple Pencil 2nd gen o posterior
• Las ventanas que optan por el rango dinámico extendido (EDR) ahora desencadenan un evento de exposición al cambiar el brillo de la pantalla
• Las solicitudes de actualización ahora se pausan cuando la aplicación sale del estado activo.
• QScreen ahora también informa de orientaciones de pantalla invertidas
• RLIMIT_STACK refleja ahora el tamaño efectivo de la pila.
• QImage::toCGImage() ahora propaga el espacio de color de la imagen

Plataformas integradas

Boot to Qt

• Se ha añadido soporte para Yocto 5.2 (Walnascar).
• Se actualizaron los niveles de compatibilidad para el hardware de destino con las placas compatibles para el nivel 2:
  • NXP i.MX 93 11x11 LPDDR4X EVK.
• Niveles de Soporte para Hardware de Destino fue actualizado con placas soportadas para el Nivel 3:
  • Toradex Colibri iMX6 ULL.

Sistemas operativos en tiempo real

• El soporte de sistemas operativos en tiempo real sólo se proporciona para las versiones LTS. Para las versiones que no son LTS, el soporte está disponible exclusivamente a través de los Servicios Profesionales.

Módulos obsoletos en Qt 6.10

Los siguientes módulos están obsoletos. Desaconsejamos encarecidamente su uso en código nuevo.

• Qt Charts
• Qt Data Visualization

Los módulos Qt Charts y Qt DataVisualization están obsoletos. Siguen formando parte del software con licencia, y siguen siendo parte del Proyecto Qt. Sin embargo, para código nuevo recomendamos que utilices Qt Graphs. Consulte también la documentación de {Qt Graphs Migración desde Qt Charts}{migración desde Qt Charts} y migración desde Qt Data Visualization.

Para más información sobre el ciclo de vida de los módulos en Qt, véase QUIP-14.

Lista de cambios en la API

Estas páginas contienen una visión general de los cambios de la API en Qt 6.10:

• Nuevas clases y funciones en Qt 6.10
• Clases obsoletas

Problemas conocidos

Para información sobre problemas conocidos en Qt 6.10 vea el Wiki de Qt.