En esta página

Qt Protobuf

El complemento generador « Qt Protobuf » genera clases basadas en Qt a partir de archivos « .proto ». Puedes utilizar estas clases para serializar y deserializar los mensajes protobuf asociados.

Descripción general

¿Qué son los Protocol Buffers?

Los Protocol Buffers son un mecanismo independiente del lenguaje y de la plataforma, y extensible, para serializar datos estructurados; es compacto y fácil de usar:

  • El usuario define la estructura de los datos en archivos ` .proto `.
  • El compilador Proto se ejecuta durante la compilación de los archivos « .proto » para generar código en diversos lenguajes de programación.

El formato resultante es adecuado para el tráfico de red o el almacenamiento de datos a largo plazo.

¿Qué problemas resuelven los Protocol Buffers?

Los Protocol Buffers proporcionan un formato de serialización para paquetes de datos tipados y estructurados de hasta unos pocos megabytes de tamaño. Permiten la ampliación con nueva información sin invalidar los datos existentes ni requerir la actualización del código. Para obtener más información, consulta la Descripción general de Protocol Buffers.

Ventajas de su uso Qt Protobuf

Puedes utilizar el mecanismo de Protocol Buffers en cualquier proyecto basado en Qt:

  • Sin necesidad de llamar explícitamente a un compilador de Protocol Buffers.
  • Sin necesidad de integrar manualmente el código generado en el árbol del proyecto.
  • Para acceder a la API de serialización y deserialización.
  • Para disponer de un mecanismo de propiedades integrado para los mensajes Protobuf generados.
  • Para obtener compatibilidad integrada con el cliente gRPC, consulta el módulo «Qt GRPC ».
  • Para obtener compatibilidad integrada con tipos QML para los mensajes Protobuf generados.
  • Para utilizar Qt Core y Qt GUI como parte del esquema *.proto.

Uso del módulo

Los Protocol Buffers de Google proporcionan un generador llamado protoc que admite extensiones. La herramienta qtprotobufgen es una extensión para protoc y requiere que instales protoc en tu sistema host. Para obtener más información sobre la instalación, consulta Instalación de Protoc.

API de QML

Los tipos QML del módulo están disponibles a través de las opciones QML y QML_URI de la macro qt_add_protobuf(). El nombre de importación es igual al nombre del paquete .proto o al definido por la opción QML_URI en la macro qt_add_protobuf(). Para utilizar los tipos, añade la siguiente instrucción de importación a tu archivo .qml:

import my.proto.package.uri

API de C++

Para utilizar la API de C++ de un módulo de Qt es necesario enlazar con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.

Compilación con CMake

Utiliza el comando « find_package() » para localizar el componente del módulo necesario en el paquete « Qt6 »:

find_package(Qt6 REQUIRED COMPONENTS Protobuf)
target_link_libraries(mytarget PRIVATE Qt6::Protobuf)

Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».

Artículos y guías

Referencias

Ejemplos

Licencias y atribuciones

El módulo « Qt Protobuf » está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo licencias de software libre: la Licencia Pública General Reducida de GNU, versión 3; la Licencia Pública General de GNU, versión 2; o la Licencia Pública General de GNU, versión 3. Consulta «Licencias de Qt» para obtener más detalles.

Por otra parte, la herramienta « qtprotobufgen » de Qt 6.12.0 puede contener módulos de terceros bajo las siguientes licencias permisivas:

protobuf, version 21.9

Licencia BSD de 3 cláusulas «Nueva» o «Revisada»

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