Extensiones de shell - Qt Wayland Compositor

En Wayland, los shells son extensiones que proporcionan semántica de superficies. Esto significa que ofrecen formas para que el servidor y el cliente se comuniquen sobre las superficies. Las superficies, en este contexto, también se denominan a menudo «ventanas», que suelen ser la representación de la superficie en el compositor.

Las extensiones de shell proporcionan herramientas para que el cliente y el servidor se comuniquen sobre determinados aspectos:

  • Pueden ofrecer una forma para que el cliente informe al servidor sobre la finalidad de una superficie: ¿se trata, por ejemplo, de una información sobre herramientas, un menú emergente o una ventana de aplicación normal? En función de esto, el servidor puede decidir la geometría de la ventana y cómo puede interactuar el usuario con ella.
  • También pueden proporcionar protocolos para manipular la superficie, como cambiar su tamaño, moverla u ocultarla.

Al igual que otras extensiones, el soporte para los shells se añade a un compositor instanciándolos como hijos directos del objeto de nivel superior ` WaylandCompositor `. Las extensiones de shell compatibles con Qt son:

  • XdgShell es un shell adecuado para sistemas de tipo escritorio, en los que pueden conectarse tantas aplicaciones como se desee y en los que el usuario puede cambiar manualmente el tamaño y la posición de las ventanas.
  • IviApplication es un protocolo minimalista, concebido originalmente para sistemas de In-Vehicle Infotainment. Resulta útil para sistemas embebidos, en los que puede ejecutarse un conjunto predefinido de aplicaciones, a menudo con un espacio en pantalla preasignado. Para obtener más detalles sobre este protocolo, consulta el ejemplo IVI Compositor.
  • QtShell es un shell especializado para aplicaciones Qt que admite las funciones de gestión de ventanas disponibles en Qt. Puede resultar adecuado en una plataforma en la que tanto el compositor como las aplicaciones cliente estén escritas con Qt, y en la que se confíe en que las aplicaciones no abusen de funciones como el posicionamiento manual de ventanas y la opción «traer al frente».
  • WlShell resulta especialmente útil para la compatibilidad con aplicaciones de terceros. Se trata también de un shell de estilo escritorio, pero ha quedado obsoleto y ha sido sustituido por XdgShell.

Al diseñar un sistema integrado desde cero, no hay reglas que determinen qué extensión de shell se debe utilizar. Normalmente será XdgShell o IviApplication. La decisión debe basarse en las funciones que necesitará el sistema y en si hay aplicaciones implicadas que no estén escritas en Qt y que tengan sus propios requisitos.

Un « Qt Wayland Compositor » también puede admitir varias extensiones de shell a la vez. Consulta el ejemplo «Minimal QML» para ver un caso en el que se admiten las tres extensiones de shell mencionadas anteriormente.

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