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.
- La herramienta qtprotobufgen genera clases Qt a partir de definiciones de mensajes Protobuf. Utiliza el comando CMake qt_add_protobuf para automatizar este proceso.
- La herramienta qtgrpcgen genera interfaces a partir de definiciones de servicios protobuf. Utiliza el comando CMake qt_add_grpc para automatizar este proceso.
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 QtGrpcArtículos y guías
- Qt GRPC Guía del cliente
- Comandos de CMake en Qt6 GRPC
- Qt GRPC Consideraciones de seguridad
- Qt GRPC Descripción general de los interceptores
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:
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.