En esta página

Protobuf Qt Core Types Module

Ofrece compatibilidad para utilizar tipos nativos de « Qt Core » en Protobuf. Más información...

Este módulo se introdujo en Qt 6.6.

Descripción detallada

Qt::ProtobufQtCoreTypes es una biblioteca con mensajes protobuf predefinidos diseñada para encapsular una selección de tipos de Qt Core.

Lista de tipos de Qt Core compatibles:

Qt Core Uso

Para habilitar la compatibilidad con los tipos « Qt Core », añade «ProtobufQtCoreTypes» como dependencia a tu proyecto CMake:

...
find_package(Qt REQUIRED COMPONENTS Protobuf ProtobufQtCoreTypes)
... # After target creation
target_link_libraries(${TARGET} PRIVATE Qt::ProtobufQtCoreTypes)

Antes de realizar cualquier serialización o deserialización de mensajes que utilicen tipos de Qt Core como campos, llama al método de registro:

// e.g. in main.cpp
QtProtobuf::qRegisterProtobufQtCoreTypes();
...

Todos los mensajes compatibles se describen en un archivo .proto especial, QtCore.proto, que describe los tipos de Qt del módulo Qt Core.

También puede utilizar el archivo para generar código para otros lenguajes o marcos de trabajo.

Importa el módulo de tipos Qt Core necesario en tu archivo .proto de interfaz. Por ejemplo:

syntax = "proto3";

package project.module.component;

import "QtCore/QtCore.proto";

message QUrlMessage {
    QtCore.QUrl url = 1;
}

El generador de Qt Protobuf detecta los tipos de Qt Core, proporcionados por el paquete ProtobufQtCoreTypes, y los utiliza directamente. Esto te ofrece la flexibilidad de utilizar estos tipos sin necesidad de conversiones adicionales.

En CMake, puedes extraer la ruta de inclusión de proto de la biblioteca utilizando la propiedad de destino « QT_PROTO_INCLUDES »:

qt_add_protobuf(MyProtoLib
    PROTO_FILES
        MyQtCoreTypesUsage.proto
    PROTO_INCLUDES
        $<TARGET_PROPERTY:Qt::ProtobufQtCoreTypes,QT_PROTO_INCLUDES>
)

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