En esta página

qt_generate_wayland_protocol_client_sources

Genera enlaces C++ del lado del cliente para un archivo .XML del protocolo Wayland.

El comando está definido en el componente « WaylandClient » del paquete « Qt6 », que se puede cargar de la siguiente manera:

find_package(Qt6 REQUIRED COMPONENTS WaylandClient)

Este comando se introdujo en Qt 6.0.

Sinopsis

qt_generate_wayland_protocol_client_sources(target
                                            [PUBLIC_CODE | PRIVATE_CODE]
                                            [NO_INCLUDE_CORE_ONLY]
                                            FILES file1.xml [file2.xml ...])

Si los comandos sin versión están desactivados, utiliza en su lugar qt6_generate_wayland_protocol_client_sources(). Admite el mismo conjunto de argumentos que este comando.

Descripción

qt_generate_wayland_protocol_client_sources() crea los pasos de compilación necesarios para ejecutar wayland-scanner y qtwaylandscanner en uno o más archivos de protocolo de Wayland. A su vez, estas herramientas generarán código de enlace en C y C++ para implementar los protocolos, y los archivos resultantes se compilarán como parte del target.

Las opciones PUBLIC_CODE y PRIVATE_CODE (añadidas en Qt 6.8) se corresponden con las opciones public-code y private-code de wayland-scanner. PUBLIC_CODE hará que se exporten los símbolos del código generado por wayland-scanner.

Antes de Qt 6.12, el valor por defecto era PUBLIC_CODE. A partir de Qt 6.12, el valor por defecto es PRIVATE_CODE si la política de Qt qt_cmake_policy_qtp0006 está establecida en NEW. En general, se recomienda encarecidamente utilizar PRIVATE_CODE.

Por defecto, se invoca wayland-scanner con el argumento --include-core-only, lo que garantiza que el código generado incluya "wayland-client-core.h". Este comportamiento se puede desactivar mediante la opción NO_INCLUDE_CORE_ONLY, que cambia la inclusión a "wayland-client.h".

Nota: En general, se desaconsejael uso de NO_INCLUDE_CORE_ONLY. "wayland-client.h" incluye una versión precompilada del protocolo Wayland básico que puede entrar en conflicto con versiones más recientes del protocolo u otros encabezados (como versiones anteriores de Vulkan). Utiliza esta opción únicamente si tienes un requisito específico para tipos que no están presentes en el encabezado básico y eres consciente de los posibles conflictos en el momento de la compilación.

qt_generate_wayland_protocol_client_sources() activará la generación de los archivos necesarios para implementar el lado cliente del protocolo. qt_generate_wayland_protocol_server_sources() es la función equivalente para el compositor.

Consulta los ejemplos de «Custom Shell » o «Custom Extension » para ver una demostración de cómo utilizar estas funciones.

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