En esta página

Wayland y Qt

Wayland se desarrolló como alternativa a X11 en Linux. Su objetivo principal es gestionar cómo se muestra el contenido de las aplicaciones conjuntamente en una pantalla compartida, y cómo un usuario puede interactuar con varias aplicaciones que comparten los mismos dispositivos de entrada.

Esta función en un sistema operativo suele denominarse «servidor de pantalla». El servidor de pantalla de Wayland también puede denominarse en ocasiones «compositor » o «gestor de ventanas», en referencia a las tareas específicas que realiza como parte de sus funciones.

A continuación, ofreceremos una breve introducción a Wayland y a su función en Qt. Para obtener más detalles e información sobre Wayland, consulta la documentación oficial.

¿Qué es un servidor de pantalla?

El servidor de pantalla es la parte del sistema operativo que gestiona el espacio de pantalla y otros recursos compartidos. En un sistema de escritorio típico, es posible que haya muchas aplicaciones independientes ejecutándose al mismo tiempo, cada una de las cuales espera poder mostrar gráficos en la pantalla y recibir entradas.

El servidor de pantalla actúa como enlace entre la aplicación y los recursos compartidos, como la pantalla y los dispositivos de entrada. Un servidor de pantalla típico en un sistema de escritorio coloca el contenido de las aplicaciones en «ventanas» rectangulares diferenciadas, que el usuario puede mover y redimensionar. El servidor de pantalla se encarga de que el contenido de la aplicación se muestre en la posición correcta en la pantalla, de que la ventana activa reciba las entradas del teclado, de que las ventanas superpuestas se dibujen en el orden correcto, etc.

En otros tipos de sistemas, el servidor de visualización puede ser más restrictivo. Si la pantalla es, por ejemplo, el salpicadero de un coche o el panel de control de una carretilla elevadora, puede que no sea conveniente mover o cambiar el tamaño de las ventanas. En su lugar, cada aplicación puede quedar fijada en un área predefinida de la pantalla y recibir entradas de dispositivos preasignados.

En cualquier caso, siempre que haya varios procesos aislados compitiendo por los mismos recursos, un servidor de visualización resulta útil.

El papel de Wayland

El nombre «Wayland» puede referirse a varios conceptos relacionados:

  • Un conjunto de protocolos para la comunicación entre un servidor de pantalla y sus clientes.
  • Una biblioteca escrita en C con funciones para la comunicación entre procesos, que sirve de base para la implementación de dichos protocolos.
  • Un lenguaje basado en XML para ampliar el protocolo, así como una herramienta para generar código de enlace en C a partir de dichas ampliaciones.

Qt proporciona implementaciones tanto para el lado del cliente como para el del servidor del protocolo.

Las aplicaciones Qt normales pueden ejecutarse como clientes en un servidor de pantalla Wayland seleccionando el complemento QPA «wayland» (esta es la opción predeterminada en algunos sistemas). Para ello, utiliza la opción -qpa wayland. Además, el Qt Wayland Compositor módulo puede utilizarse para desarrollar el propio servidor de pantalla.

Qt también cuenta con funciones prácticas para ampliar fácilmente los protocolos de Wayland con nuevas interfaces.

Wayland y otras tecnologías

En el escritorio de Linux, Wayland es una alternativa a X11 y sus extensiones relacionadas. En esencia, es un servidor de pantalla con composición, y el término «compositor» se utiliza a menudo para describir el servidor Wayland. Esto significa que los clientes renderizan el contenido en un búfer fuera de pantalla, que posteriormente se «compone» con el de otros clientes en la pantalla, lo que permite efectos de ventana como sombras proyectadas, transparencia, desenfoque de fondo, etc.

Un principio de diseño importante de los protocolos X11 originales es que el servidor de visualización puede ejecutarse en un terminal ligero que cuente únicamente con una pantalla y dispositivos de entrada. Sus clientes se ejecutarían entonces en sistemas remotos con mayor potencia de procesamiento, comunicándose con el servidor a través de una conexión de red.

Por el contrario, Wayland se ha diseñado partiendo de la observación de que, en las configuraciones modernas, el cliente y el servidor de visualización suelen ejecutarse en el mismo hardware. La computación distribuida, el almacenamiento remoto y la funcionalidad de escritorio remoto suelen gestionarse mediante otros mecanismos. Incorporar esto en el protocolo permite compartir la memoria gráfica entre el cliente y el servidor: cuando el compositor coloca el contenido del cliente en pantalla, basta con copiarlo de una parte de la memoria gráfica a otra.

Para que esto funcione de forma óptima, el controlador gráfico debe ser compatible con Wayland. Esta compatibilidad se proporciona a través de una extensión de EGL denominada EXT_platform_wayland.

Nota: Qt Wayland también admite la composición en sistemas en los que no se admite « EXT_platform_wayland », ya sea a través de « XComposite » o copiando el contenido de la aplicación a la memoria compartida de la CPU. No obstante, para obtener un rendimiento óptimo, recomendamos sistemas con controladores compatibles.

X11 se ha ampliado para admitir características como la composición y el renderizado directo, pero Wayland está diseñado desde cero en torno a este caso de uso. Además, pretende ser ligero y extensible, en contraste con la complejidad que ha ido adquiriendo X11 con el paso del tiempo.

Extensibilidad y sistemas embebidos

Dado que Wayland tiene un núcleo mínimo y es fácilmente extensible, resulta una herramienta ideal a la hora de desarrollar plataformas Linux integradas.

Las funciones del sistema de ventanas al estilo de escritorio, por ejemplo, no forman parte del protocolo básico. En su lugar, Wayland cuenta con una categoría especial de extensiones de protocolo denominadas «shells» que permiten al cliente gestionar sus superficies. Las características propias de un escritorio se proporcionan a través de un shell denominado XDG Shell. Para otros tipos de sistemas, se puede utilizar un «shell» más especializado (y quizás más restrictivo). Por ejemplo, a la hora de crear sistemas de tipo « In-Vehicle Infotainment », podría ser preferible el IVI Shell.

El servidor Wayland difunde una lista de los protocolos (o «interfaces») que admite cuando un cliente se conecta, y el cliente puede vincularse a los que desee utilizar. Puede tratarse de cualquiera de las interfaces estándar, pero también es fácil añadir nuevas extensiones. Wayland define un formato XML fácil de entender para definir protocolos, y la herramienta waylandscanner puede utilizarse para generar código C a partir de ellos. (En Qt, también disponemos de qtwaylandscanner, que genera código de enlace adicional en C++).

Una vez que un cliente se vincula a una interfaz, puede realizar «solicitudes» al servidor y este puede enviar «eventos» al cliente. Las solicitudes y los eventos, así como sus argumentos, se definen en el archivo XML que describe el protocolo.

A la hora de crear una plataforma desde cero, cuando se controla el código tanto del servidor como de los clientes, añadir extensiones es una forma sencilla y controlada de incorporar funcionalidades del sistema operativo.

Multiproceso o monoproceso

A la hora de crear una plataforma integrada sencilla con Qt, una opción perfectamente viable es que todas las partes de la interfaz de usuario se ejecuten en un único proceso. Sin embargo, a medida que el sistema se vuelve más complejo, es posible que te interese plantearte un sistema multiproceso. Aquí es donde entra en juego Wayland. Con Qt, en cualquier momento del proceso de desarrollo, puedes optar por cambiar entre un sistema de proceso único y uno multiproceso.

Ventajas del sistema multiproceso

Los siguientes diagramas ilustran la diferencia entre los sistemas multiproceso y de un solo proceso.

Esquema de la arquitectura de un cliente Wayland multiproceso

Arquitectura de cliente multiproceso

Diagrama de una arquitectura de cliente EGLFS de un solo proceso

Arquitectura de cliente de un solo proceso

El Qt Wayland Compositor módulo es ideal para crear el servidor de visualización y el compositor en sistemas multiproceso en Linux embebido. El uso de la arquitectura multiproceso ofrece las siguientes ventajas:

Estabilidad
Mayor facilidad para recuperarse cuando los clientes se cuelgan o fallanSi tienes una interfaz de usuario compleja, el uso de múltiples procesos resulta útil, ya que si una parte de la interfaz de usuario falla, no afecta a todo el sistema. Del mismo modo, la pantalla no se bloqueará, incluso si un cliente se bloquea.

Nota: Si tu cliente está obligado por ley a mostrar información crítica para la seguridad, plantéate utilizar Qt Safe Renderer.

Protección contra posibles fugas de memoriaEn un sistema multiproceso, si un cliente tiene una fuga de memoria y consume mucha memoria, esa memoria se recupera cuando dicho cliente se cierra. A diferencia de lo que ocurre en un sistema monoproceso, la fuga de memoria persiste hasta que se reinicia todo el sistema.
Seguridad
En un sistema de un solo proceso, todos los clientes pueden acceder a la memoria de los demás. Por ejemplo, no existe aislamiento para la transferencia de datos confidenciales; cada línea de código debe ser igualmente fiable. Este aislamiento está presente, por diseño, en los sistemas multiproceso.
Rendimiento
Si dispones de una CPU con varios núcleos, un sistema multiproceso puede ayudar a distribuir la carga de forma uniforme entre los distintos núcleos, lo que permite un uso más eficiente de la CPU.
Interoperabilidad
En un sistema multiproceso, puedes interactuar con clientes que no sean de Qt, siempre y cuando dichos clientes sean compatibles con Wayland o X11. Por ejemplo, si utilizas GStreamer para vídeo o si deseas utilizar una aplicación de navegación creada con otro kit de herramientas de interfaz de usuario, puedes ejecutar estos clientes junto con tus otros clientes basados en Qt.

Ventajas e inconvenientes del sistema multiproceso

Al pasar de un único proceso a un sistema multiproceso, es importante tener en cuenta las siguientes ventajas e inconvenientes:

Mayor consumo de memoria de vídeo
Esto puede suponer una limitación para los dispositivos integrados. En el modo multiproceso, cada cliente necesita disponer de su propio búfer gráfico, que envía al compositor. En consecuencia, se utiliza más memoria de vídeo en comparación con el caso del proceso único: donde todo se dibuja de una sola vez y no es necesario almacenar las diferentes partes en búferes intermedios.
Mayor consumo de memoria principal
Aparte de cierta sobrecarga adicional a nivel del sistema operativo, la ejecución de varios clientes también puede suponer un mayor consumo de memoria principal, ya que algunas partes deben duplicarse una vez por cada cliente. Por ejemplo, si se ejecuta QML, cada cliente requiere un motor QML independiente. Por consiguiente, si se ejecuta un único cliente que utiliza controles de Qt Quick, estos se cargan una sola vez. Si luego se divide este cliente en varios clientes, se cargan los controles « Qt Quick » varias veces, lo que se traduce en un mayor coste de arranque para inicializar los clientes.
Almacenamiento repetido de recursos gráficos
En un sistema de un solo proceso, si utilizas las mismas texturas, fondos o iconos en muchos lugares, esas imágenes solo se almacenan una vez. Por el contrario, si utilizas estas imágenes en un sistema multiproceso, tendrás que almacenarlas varias veces. En este caso, una solución consiste en compartir los recursos gráficos entre clientes. Qt ya permite compartir recursos de imagen en la memoria principal entre procesos sin necesidad de recurrir a Wayland. Por otro lado, compartir texturas de la GPU entre procesos requiere soluciones más complejas. Con Qt, estas soluciones pueden desarrollarse como protocolos de extensión de Wayland y, por ejemplo, mediante QQuickImageProvider.
Latencia entre la entrada y el fotón
En un sistema de un solo proceso, la aplicación accede directamente al búfer de fotogramas principal. Esto significa que, en una configuración de este tipo, se puede minimizar la latencia entre los eventos de entrada y su representación en pantalla. En un sistema multiproceso, el contenido de la aplicación debe someterse a un búfer triple para garantizar que el cliente no dibuje en los búferes mientras el servidor los está leyendo simultáneamente, ya que eso provocaría «tearing». Esto significa que existe una latencia implícita en un sistema multiproceso.

¿Por qué utilizar Wayland en lugar de X11 o soluciones personalizadas?

Como se ha descrito anteriormente, X11 no es la opción óptima para las configuraciones típicas de los sistemas actuales. Es bastante voluminoso y complejo, y carece de capacidad de personalización. De hecho, resulta difícil ejecutar un cliente con fluidez con X11 y alcanzar los 60 fps sin que se produzcan desgarros. Wayland, por el contrario, es más fácil de implementar, ofrece un mejor rendimiento y contiene todos los componentes necesarios para funcionar de manera eficiente en el hardware gráfico moderno. Para los sistemas embebidos y multiproceso en Linux, Wayland es el estándar.

Sin embargo, si trabajas con hardware antiguo o aplicaciones heredadas, es posible que Wayland no sea una buena opción. El protocolo Wayland está diseñado teniendo en cuenta la seguridad y el aislamiento, y es estricto y conservador en cuanto a la información y las funcionalidades que pone a disposición de los clientes. Aunque esto da lugar a una interfaz más limpia y segura, es posible que algunas funcionalidades que esperan las aplicaciones heredadas ya no estén disponibles en Wayland.

En concreto, hay tres casos de uso habituales en los que Wayland puede no ser la mejor opción:

  1. El hardware o la plataforma son antiguos y solo admiten X11; en ese caso, no tienes otra opción.
  2. Tienes que dar soporte a aplicaciones heredadas que dependen de características que no están presentes en el protocolo Wayland por motivos de seguridad y simplicidad.
  3. Hay que dar soporte a aplicaciones heredadas que utilizan un kit de herramientas de interfaz de usuario que no funciona en absoluto en Wayland. En algunos casos, es posible solucionar este problema ejecutando esas aplicaciones en XWayland.

En la época en que X11 era muy popular, los desarrolladores creaban sus propias soluciones personalizadas para sortear los problemas de X11. Las versiones más antiguas de Qt contaban con el Qt Windowing System (QWS), que ahora ha dejado de utilizarse. Hoy en día, Wayland cubre la mayoría de estos casos de uso, y las soluciones personalizadas son cada vez menos habituales.

Qué ofrece Qt Wayland

Para clientes
Los clientes de Qt pueden ejecutarse en cualquier compositor de Wayland, incluido Weston, el compositor de referencia desarrollado como parte del proyecto Wayland.

Cualquier programa Qt puede ejecutarse como cliente de Wayland (como parte de un sistema multiproceso) o como cliente independiente (un solo proceso). Esto se determina al iniciar el programa, momento en el que puedes elegir entre los distintos backends. Durante el proceso de desarrollo, puedes desarrollar primero el cliente en el escritorio y, posteriormente, probarlo en el hardware de destino. No es necesario ejecutar los clientes en el hardware de destino real en todo momento.

Esquema de una configuración de desarrollo de un cliente Wayland de un solo proceso

Desarrollo de clientes de un solo proceso

Si desarrollas en un equipo Linux, también puedes ejecutar el compositor dentro de una ventana en tu equipo de desarrollo. Esto te permite ejecutar los clientes en un entorno muy similar al del dispositivo de destino. Sin necesidad de recompilar el cliente, también puedes ejecutarlo con ` -platform wayland ` para que se ejecute dentro del compositor. Si utilizas -platform xcb (para X11), puedes ejecutar el cliente en el escritorio. En otras palabras, puedes empezar a desarrollar tus clientes antes de que el compositor esté listo para su uso.

Para servidores
El servidor, o compositor, se conecta a la pantalla y muestra el contenido de cada cliente en ella. El compositor gestiona las entradas y envía los eventos de entrada al cliente correspondiente. A su vez, cada cliente se conecta al compositor y le envía el contenido de sus ventanas. Es el compositor quien decide:

  • Cómo y dónde mostrar el contenido
  • Qué contenido mostrar
  • qué hacer con los distintos búferes gráficos de los clientes

Esto significa que es el compositor quien decide qué se entiende por un sistema multiproceso. Por ejemplo, los clientes podrían formar parte de una escena 3D con ventanas en las paredes, en un sistema de realidad virtual, mapeados a una esfera, etcétera.

El Qt Wayland Compositor existe una API para crear tu propio compositor. Te ofrece total libertad para diseñar una interfaz de usuario personalizada para el compositor y gestionar las ventanas de los distintos clientes. Puedes combinar tanto Qt Quick como QML con Qt Wayland Compositor para crear interfaces de usuario impresionantes y creativas. Para obtener más información, consulta Qt Wayland Compositor.

Qt también ofrece API potentes y fáciles de usar para implementar extensiones de Wayland y utilizarlas desde QML o C++.

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