이 페이지에서

Qt Wayland Client

Qt Wayland Client 라이브러리는 애플리케이션이 Wayland 클라이언트 역할을 수행하고 Wayland 컴포지터에 연결하는 데 필요한 함수를 제공합니다. 대부분의 사용 사례에서 이 라이브러리는 Wayland QPA 플러그인을 통해 자동으로 사용되므로, 애플리케이션 자체에서 라이브러리의 함수를 직접 사용할 필요가 없습니다.

일반적인 정보는 Qt for Linux를 참조하십시오. Wayland 자체에 대한 자세한 내용은 Wayland and Qt를 참조하십시오.

cmake 함수 qt_generate_wayland_protocol_client_sources() 를 사용하여 사용자 정의 프로토콜 확장을 생성할 수 있습니다.

또한 Qt는 컴포지터 개발을 위한 Qt Wayland Compositor 컴포지터 개발용 모듈을 제공합니다.

모듈 사용

Qt 모듈의 C++ API를 사용하려면 직접 또는 다른 종속성을 통해 모듈 라이브러리에 링크해야 합니다. CMake 및 qmake를 비롯한 여러 빌드 도구가 이를 위해 전용 지원을 제공합니다.

CMake를 사용한 빌드

find_package() 명령을 사용하여 Qt6 패키지 내에서 필요한 모듈 구성 요소를 찾으십시오.

find_package(Qt6 REQUIRED COMPONENTS WaylandClient)
target_link_libraries(mytarget PRIVATE Qt6::WaylandClient)

자세한 내용은 ‘CMake를 사용한 빌드’ 개요를 참조하십시오.

qmake를 사용한 빌드

qmake를 사용하여 모듈을 빌드하도록 구성하려면, 프로젝트의 .pro 파일에서 QT 변수의 값으로 해당 모듈을 추가하십시오:

QT += waylandclient

참고

라이선스 및 저작권 표시

Qt Wayland Compositor 및 Qt Wayland 통합 플러그인은 The Qt Company의 상용 라이선스에 따라 제공됩니다.

또한, Qt Wayland Compositor 는 GNU 일반 공중 사용 허가서(GNU General Public License) 버전 3에 따라 제공되며 , Qt Wayland 통합 플러그인은 GNU 축소 일반 공중 사용 허가서(GNU Lesser General Public License) 버전 3 또는 GNU 일반 공중 사용 허가서(GNU General Public License) 버전 2에 따라 제공됩니다.

자세한 내용은 Qt 라이선스를 참조하십시오.

Qt Wayland Compositor 및 Qt Wayland 통합 플러그인은 다음의 관대한 라이선스에 따라 프로토콜 정의를 사용합니다:

Presentation Time Protocol, version 1

MIT 라이선스

Wayland Color Management Protocol, version 1

MIT 라이선스

Wayland Dialog Protocol, version 1

MIT 라이선스

Wayland EGLStream Controller Protocol, version 1.1.1

MIT 라이선스

Wayland Fractional Scale Protocol, version 1

MIT 라이선스

Wayland Fullscreen Shell Protocol, version unstable v1

MIT 라이선스

Wayland IVI Extension Protocol, version 1.9.1

MIT 라이선스

Wayland KDE DBus Menu Protocol, version 1

GNU 약소 일반 공중 사용 허가서 2.1 또는 그 이후 버전

Wayland Linux Dmabuf Unstable V1 Protocol, version unstable v1, version 3

MIT 라이선스

Wayland Linux Dmabuf V1 Protocol, version v1, version 5

MIT 라이선스

Wayland Pointer Gestures Protocol, version unstable v1, version 2

MIT 라이선스

Wayland Pointer Warp Protocol, version version 1

MIT 라이선스

Wayland Primary Selection Protocol, version 1

MIT 라이선스

Wayland Protocol, version 1.24.0

MIT 라이선스

Wayland Scaler Protocol, version 2

MIT 라이선스

Wayland Session Management Protocol, version experimental V1

MIT 라이선스

Wayland Tablet Protocol, version unstable v2, version 1

MIT 라이선스

Wayland Text Input Protocol v1, version unstable v1

MIT 라이선스

Wayland Text Input Protocol v2, version unstable v2

HPND 라이선스

Wayland Text Input Protocol, version unstable v3

MIT 라이선스

Wayland Viewporter Protocol, version 1

MIT 라이선스

Wayland XDG Foreign Protocol, version 1

MIT 라이선스

Wayland XDG Output Protocol, version unstable v1, version 3

MIT 라이선스

Wayland XDG Shell Protocol, version 1.18

MIT 라이선스

Wayland XDG System Bell Protocol, version 1.18

MIT 라이선스

Wayland xdg-activation Protocol, version unstable v1, version 1

MIT 라이선스

Wayland xdg-decoration Protocol, version unstable v1, version 1

MIT 라이선스

Wayland xdg-toplevel-icon Protocol, version version 1

MIT 라이선스

Wlr Data Control Unstable V1 Protocol, version 2

MIT 라이선스

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