Cambios en Qt XML
Qt 6 son el resultado de un esfuerzo deliberado por hacer que el marco sea más eficiente y fácil de usar.
Intentamos mantener la compatibilidad binaria y de código fuente para todas las API públicas en cada versión. Sin embargo, algunos cambios eran inevitables para hacer de Qt un marco de trabajo mejor y adaptarlo a los estándares modernos.
Qt 6 aplica las normas de XML 1.0 de forma más estricta que Qt 5. En Qt 5, el analizador de XML era más flexible, permitiendo ciertas construcciones que no cumplían con la especificación XML 1.0. Qt 6 corrige este comportamiento, garantizando que el manejo del XML siga correctamente el estándar. Si tu aplicación depende de un comportamiento que se permitía incorrectamente en Qt 5, es posible que tengas que ajustar tus documentos XML o tu lógica de procesamiento en consecuencia.
Para obtener más detalles sobre las reglas de XML 1.0, consulta la especificación oficial de XML del W3C: Lenguaje de marcado extensible (XML) 1.0 (quinta edición)
En este tema resumimos esos cambios en Qt XML y ofrecemos orientación para gestionarlos.
Analizador «Simple API for XML» (SAX)
Se han eliminado todas las clases SAX de Qt XML. Utiliza QXmlStreamReader para leer archivos XML. A continuación se indican algunos pasos sencillos para portar tu código actual a QXmlStreamReader:
Por ejemplo, si tienes un código como
QFile *file = new QFile(...);
QXmlInputSource *source = new QXmlInputSource(file);
Handler *handler = new Handler;
QXmlSimpleReader xmlReader;
xmlReader.setErrorHandler(handler);
xmlReader.setContentHandler(handler);
if (xmlReader.parse(source)) {
... // do processing
} else {
... // do error handling
}puedes reescribirlo como
QFile file = ...;
QXmlStreamReader reader(&file);
while (!reader.atEnd()) {
reader.readNext();
... // do processing
}
if (reader.hasError()) {
... // do error handling
}QDom y QDomDocument
Dado que las clases SAX se han eliminado de Qt XML, QDomDocument se ha reimplementado utilizando QXmlStreamReader. Esto provoca algunos cambios de comportamiento:
- Los valores de los atributos se normalizarán. Por ejemplo,
<tag attr=" a \n b " />es equivalente a<tag attr="a b"/>. - Ya no se permiten nombres de atributos calificados idénticos. Esto significa que los atributos de un elemento deben tener nombres únicos.
- Ya no se permiten prefijos de espacio de nombres no declarados.
Para más detalles, véase: Normalización de valores de atributos en XML 1.0
Caracteres de control
En Qt 6, los caracteres de control como U+0000—U+001F, U+007F y U+0080—U+009F ahora se rechazan correctamente según las reglas de XML 1.0. En Qt 5 se permitían erróneamente. Antes de utilizar XML con Qt 6, asegúrate de que tus documentos XML solo contengan caracteres válidos que cumplan con XML 1.0. Si son necesarios caracteres de control, codifícalos utilizando un formato seguro para texto.
Para más detalles, véase: Caracteres en XML 1.0
Entidades HTML en XML
En Qt 6, las entidades HTML ya no son válidas a menos que se declaren explícitamente en una definición de tipo de documento (DTD). En Qt 5, se permitían ciertas entidades específicas de HTML (por ejemplo, ), incluso sin declaración. Para garantizar la compatibilidad en Qt 6, utiliza referencias numéricas de caracteres, define las entidades necesarias en una DTD o, si tu contenido depende de entidades HTML, procesa el XML como HTML en su lugar.
Para más detalles, consulta: Codificación de caracteres en entidades en XML 1.0
Nodos de texto que contienen únicamente espacios
Por defecto, los nodos de texto que contienen únicamente caracteres de espaciado se eliminan y no aparecerán en el ` QDomDocument`. En Qt 5, para modificar este comportamiento se utilizaba la sobrecarga ` QDomDocument::setContent()` que permitía proporcionar un ` QXmlReader `. Esa sobrecarga se eliminó en Qt 6.0, pero desde Qt 6.5 se puede pasar ` QDomDocument::ParseOption::PreserveSpacingOnlyNodes ` como opción de análisis para especificar que se deben conservar los nodos de texto que solo contienen espacios.
Si utilizas QDomDocument y dependes de alguna de estas opciones, debes actualizar tu código y tus documentos XML en consecuencia.
Biblioteca de compatibilidad Qt Core5
Si su aplicación o biblioteca no se puede portar en este momento, las clases ` QXmlSimpleReader ` y las relacionadas siguen existiendo en `Qt5Compat` para que las bases de código antiguas sigan funcionando. Si desea seguir utilizando esas clases SAX, debe enlazar con el nuevo módulo `Qt5Compat` y añadir esta línea a su archivo `qmake ` ` .pro `:
QT += core5compatEn caso de que ya hayas portado tu aplicación o biblioteca al sistema de compilación CMake, añade lo siguiente a tu archivo « CMakeList.txt »:
PUBLIC_LIBRARIES
Qt::Core5Compat© 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.