En esta página

Qt GRPC

Qt GRPC, junto con el Qt Protobuf módulo, permite una comunicación rápida y eficiente en cuanto al espacio con gRPC™ servidores. Integra a la perfección los servicios de gRPC en el marco de trabajo de Qt, lo que permite la comunicación entre diferentes lenguajes de programación o entornos, independientemente de si el servidor está basado en Qt.

Descripción general

gRPC es un marco de trabajo multiplataforma de alto rendimiento para llamadas a procedimientos remotos (RPC). Utiliza el compilador Protobuf (protoc) para generar interfaces de cliente y servidor a partir de las secciones « service » de un esquema Protobuf para diversos lenguajes de programación. Se utiliza habitualmente para conectar servicios en arquitecturas de tipo microservicios o para vincular aplicaciones móviles y navegadores con sistemas de backend. Para obtener más detalles, consulta la Introducción a gRPC.

Qt GRPC Consta de API de C++ y Qt Quick que gestionan la naturaleza asíncrona de las llamadas a procedimientos remotos (RPC) mediante el conocido mecanismo de señales y ranuras (Signals & Slots ). También proporciona herramientas de línea de comandos y una API de CMake para agilizar la generación de interfaces específicas de Qt utilizando protoc.

Qt GRPC Actualmente admite funcionalidad del lado del cliente. Esto significa que puede comunicarse con un servidor compatible con gRPC. Puede tratarse de tu propio servidor con su API protobuf o de una API disponible públicamente, como las API de Google.

Uso del módulo

Requisitos previos del módulo

  • protoc, el compilador de Protocol Buffers, es necesario para ejecutar los complementos del generador de código de Qt. Consulta Instalación de Protoc.
  • Opcional: compatibilidad con SSL.
  • Opcional: gRPC C++ para ejecutar los ejemplos.

Nota: Consulta el «Ejemplo de instalación para Windows con vcpkg» para obtener instrucciones sobre cómo instalar gRPC y Protobuf, y cómo ejecutar los ejemplos de Qt GRPC.

API de C++

Para añadir archivos protobuf a un proyecto basado en Qt y generar el código fuente necesario, utiliza el compilador protoc junto con los complementos de Qt qtgrpcgen y qtprotobufgen.

Un ejemplo básico de un archivo de proyecto de CMake que utiliza Qt GRPC podría tener este aspecto:

cmake_minimum_required(VERSION 3.16...3.22)
project(MyProject)

find_package(Qt6 REQUIRED COMPONENTS Protobuf Grpc)
qt_standard_project_setup()

qt_add_executable(MyApp main.cpp)

qt_add_protobuf(MyApp
    PROTO_FILES
        path/to/messages.proto
)

qt_add_grpc(MyApp CLIENT
    PROTO_FILES
        path/to/service.proto
)

target_link_libraries(MyApp PRIVATE Qt6::Protobuf Qt6::Grpc)

API de QML

Los tipos QML del módulo están disponibles a través de la importación « QtGrpc ». Para utilizar los tipos, añade la siguiente instrucción de importación a tu archivo .qml:

import QtGrpc

Artículos y guías

Referencias

Ejemplos

Licencias y atribuciones

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

Por otra parte, Qt GRPC en Qt 6.12.0 puede contener módulos de terceros bajo las siguientes licencias permisivas:

gRPC, version 1.50.1

Licencia Apache 2.0

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