우분투 24.04의 웨이랜드 환경에서 터치패드 제스처가 작동하지 않는 문제 해결

포인터를 정상적으로 움직이면 두 손가락 스크롤은 여전히 ​​작동할 수 있지만, 익숙한 세 손가락 스와이프 동작으로는 더 이상 액티비티가 열리거나 작업 공간이 전환되지 않습니다. 우분투 24.04에서는 이러한 증상이 종종 "Wayland 제스처가 비활성화됨"으로 잘못 진단됩니다. 표준 GNOME 데스크톱에는 내장된 세 손가락 시스템 제스처를 위한 별도의 마스터 스위치가 없습니다. 여기서 중요한 질문은 제스처가 어디에서 멈추는지입니다. 세션, 터치패드 설정, libinput, GNOME Shell 또는 하드웨어 자체 중 어느 쪽에서 멈추는지 파악하는 것입니다.

이 가이드는 빠르고 되돌릴 수 있는 점검부터 시작하여 입력 진단으로 넘어갑니다. Ubuntu 24.04 LTS는 지원되는 시스템에서 기본적으로 Wayland 기반 GNOME을 사용하며, GNOME은 활동 개요를 열거나 작업 공간을 전환하기 위한 세 손가락 스와이프 기능을 지원합니다. 기본 libinput 스택은 지원되는 터치패드에서 스와이프 및 핀치 이벤트를 보고할 수 있습니다. 이 두 가지 사실을 바탕으로 명확한 문제 해결 경로를 설정할 수 있습니다. Wayland 사용 여부를 확인하고, 터치패드가 활성화되어 있는지 확인한 후, 기본 GNOME 제스처를 테스트하고, 마지막으로 libinput이 여러 손가락 이벤트를 수신하는지 확인합니다.

1. 현재 Wayland 세션에 있는지 확인하십시오.

터미널을 열고 다음 명령을 실행하세요:

echo $XDG_SESSION_TYPE

예상 결과는 입니다 wayland. 만약 명령이 를 출력한다면 x11, 다른 입력 경로를 문제 해결 중인 것입니다. Ubuntu는 여전히 Xorg 세션을 제공할 수 있으며, 해당 세션에서의 제스처 동작은 네이티브 GNOME Wayland 환경과 완전히 동일하지 않습니다.

Xorg 환경에서 기본 Wayland 세션을 사용하려면 로그아웃하십시오. 로그인 화면에서 계정을 선택하고 세션 선택기를 열어, 해당 옵션이 표시되면 "Ubuntu on Xorg" 대신 "Ubuntu"를 선택하십시오 . 하드웨어, 그래픽 드라이버, 원격 데스크톱 세션 또는 관리자 정책에 따라 제공되는 세션이 달라질 수 있으므로, 옵션을 사용할 수 없는 이유를 확인하지 않고 강제로 선택하지 마십시오.

GNOME의 공식 제스처 동작은 GNOME 도움말: 터치패드 및 터치스크린에서 제스처 사용 에 설명되어 있습니다 .

2. 터치패드가 활성화되어 있는지 확인하십시오.

설정 > 마우스 및 터치패드를 엽니다 . 터치패드가 활성화되어 있는지 확인합니다. 두 손가락 스크롤과 기본 탭 기능도 테스트해 보세요. GNOME 설정 패널은 데스크톱이 터치패드를 인식할 때만 터치패드 제어 기능을 표시하므로, 터치패드 항목이 없는 것은 단순한 외관상의 문제가 아니라 터치패드 작동에 대한 중요한 단서입니다.

기본 Ubuntu 24.04 설정 패널에서 "세 손가락 제스처" 토글을 찾느라 시간을 낭비하지 마세요. GNOME Shell에 내장된 시스템 제스처는 일반적으로 해당 설정 패널에서 별도의 켜기/끄기 스위치로 제어되지 않습니다. 포인터 이동과 두 손가락 스크롤은 작동하지만 세 손가락 제스처가 작동하지 않으면 다음 테스트로 진행하세요.

터치패드 조작 방법에 대한 자세한 내용은 GNOME 도움말: 터치패드로 클릭, 드래그 또는 스크롤하기를 참조하세요 .

3. 앱별 제스처가 아닌 기본 GNOME 제스처를 테스트하세요.

터치패드에서 세 손가락으로 위쪽으로 스와이프하세요. GNOME에서 활동 개요가 열립니다. 더 위로 스와이프하면 응용 프로그램 보기가 열립니다. 세 손가락으로 왼쪽 또는 오른쪽으로 스와이프하면 작업 공간이 전환됩니다. 이러한 동작은 Firefox, 브라우저 확장 프로그램, 데스크톱 추가 기능 또는 타사 제스처 데몬에서 제공하는 기능이 아닌 GNOME Shell 제스처이므로 가장 적합한 기준 테스트입니다.

핀치 투 줌은 다릅니다. libinput은 핀치 제스처를 인식할 수 있지만, 핀치 동작으로 콘텐츠가 확대/축소되는지 여부는 애플리케이션과 툴킷에 따라 다릅니다. 한 애플리케이션에서 세 손가락으로 작업 영역을 스와이프하는 동작은 정상적으로 작동하지만 핀치 동작은 작동하지 않는 경우, 이는 Wayland 전체가 아닌 해당 애플리케이션의 문제일 가능성이 높습니다.

4. libinput이 터치패드를 인식하는지 확인합니다.

Ubuntu는 libinput-tools입력 진단을 위한 패키지를 제공합니다. 해당 libinput명령어가 설치되어 있지 않으면 다음 명령어로 추가하세요.

sudo apt update
sudo apt install libinput-tools

다음으로 장치 목록을 나열하세요.

sudo libinput list-devices

사용하는 터치패드에 해당하는 라이브러리 블록을 찾으세요. 정확한 모델명, 이벤트 노드, 크기 및 구성은 노트북마다 다릅니다. 중요한 것은 libinput이 해당 장치를 터치패드로 인식하고 예상되는 기능을 제공하는지 여부입니다. Ubuntu 24.04 패키지는 Ubuntu Noble 패키지 카탈로그 에 문서화되어 있으며 , 명령어 자체는 Ubuntu libinput 매뉴얼 페이지 에 설명되어 있습니다 .

터치패드가 표시되지 않는다면 libinput list-devices, 이는 더 이상 GNOME 제스처 문제만은 아닙니다. 펌웨어/BIOS 설정에서 장치가 나타나는지, 하드웨어 터치패드 토글이 활성화되어 있는지, 그리고 재부팅 후 커널에서 장치를 인식하는지 확인하십시오. GNOME에서 제스처를 인식하려면 노트북의 커널, I2C-HID 또는 펌웨어 관련 문제를 해결해야 합니다.

5. 원본 동작 이벤트를 시청하세요

가장 유용한 테스트는 세 손가락을 움직일 때 libinput이 제스처 이벤트를 발생시키는지 확인하는 것입니다. 실행 방법:

sudo libinput debug-events

그다음 세 손가락으로 스와이프 동작을 수행하세요. 지원되는 하드웨어에서는 스와이프 시작, 업데이트, 종료와 같은 제스처 이벤트 라인이 표시됩니다. 정확한 이벤트 노드, 타이밍, 변화량 및 형식은 다를 수 있습니다. 이 명령은 일반적으로 /dev/input/event*기기 정보를 직접 읽기 때문에 루트 권한이 필요합니다.

우분투 공식 libinput-debug-events 매뉴얼 페이지에서는 이 도구를 디버깅 도우미로 설명하고 출력 형식이 변경될 수 있다고 경고합니다. libinput 자체의 제스처 문서에서는 스와이프 및 핀치 제스처가 생성되는 방식을 설명합니다.

제스처 이벤트가 나타나면 하드웨어와 libinput 경로가 정상적으로 작동하는 것입니다. 다음으로 GNOME Shell, 확장 프로그램, 세션 상태 및 업데이트를 확인하십시오. 멀티핑거 제스처 이벤트가 나타나지 않으면 손가락을 완전히 벌리고 다시 테스트하십시오. 기본 포인터 이벤트는 나타나지만 세 손가락 제스처가 전혀 작동하지 않으면 터치패드에 필요한 멀티터치 기능이 없거나 커널/펌웨어 문제로 인해 충분한 접촉을 보고하지 못하는 것일 수 있습니다.

6. 최신 Ubuntu 24.04 업데이트를 설치하세요.

드라이버를 교체하거나 하위 수준 구성 파일을 편집하기 전에 설치된 24.04 패키지를 최신 버전으로 업데이트하십시오.

sudo apt update
sudo apt upgrade

업데이트로 인해 새 커널, 그래픽 스택 또는 재시작이 필요한 기타 구성 요소가 설치되는 경우 시스템을 재부팅하십시오. 제스처 처리는 커널 입력 드라이버, libinput, Mutter/GNOME Shell 및 애플리케이션 등 여러 계층에 걸쳐 이루어지므로, 이미 수정된 버그라도 업데이트되지 않은 시스템에서는 계속 표시될 수 있습니다.

임의의 Synaptics 패키지를 다운로드하거나 이전 Ubuntu 버전을 기준으로 작성된 튜토리얼에서 가져온 오래된 Xorg 설정 파일을 복사하지 마십시오. 표준 Wayland GNOME 세션에서는 libinput이 관련 입력 라이브러리이며, Xorg 전용 설정 파일은 GNOME Shell 제스처를 복구하는 신뢰할 수 있는 방법이 아닙니다.

7. GNOME Shell 확장 기능을 일시적으로 비활성화합니다.

세 손가락 스와이프가 명확하게 표시 되지만 libinput debug-eventsGNOME에서 아무런 반응이 없다면, 타사 GNOME Shell 확장 프로그램을 일시적으로 비활성화하고 다시 테스트해 보세요. 확장 프로그램은 작업 공간 동작, 창 관리, 개요 동작 또는 제스처 처리를 변경할 수 있습니다. 확장 프로그램 앱이 설치되어 있다면 앱을 사용하거나, 다음 명령어를 사용하여 활성화된 확장 프로그램 목록을 확인하세요.

gnome-extensions list --enabled

의심스러운 확장 프로그램을 하나씩 비활성화하려면 다음 명령을 사용하세요.

gnome-extensions disable EXTENSION_UUID

`list` 명령에서 반환된 식별자로 대체하십시오 EXTENSION_UUID. 셸 확장 프로그램을 변경한 후 로그아웃했다가 다시 로그인하면 깨끗한 세션에서 테스트할 수 있습니다.

이 단계는 진단 목적이며, 확장 프로그램 없이 영구적으로 실행하라는 권장 사항이 아닙니다. 충돌하는 확장 프로그램을 확인했으면 해당 확장 프로그램을 업데이트하거나 설정을 조정하거나 해당 확장 프로그램만 비활성화하십시오.

8. 깨끗한 Wayland 세션에 다시 접속하여 다시 테스트하십시오.

로그아웃한 다음, 로그인 시 일반 Ubuntu Wayland 세션을 선택하고 여러 애플리케이션을 다시 열기 전에 기본 제스처 테스트를 반복하십시오. 이렇게 하면 GNOME Shell의 일시적인 상태가 지워지고 확장 프로그램이나 세션별 프로세스 중 어느 것이 관련되었는지 쉽게 확인할 수 있습니다.

Ubuntu를 선택했는데도 시스템이 항상 Xorg로 돌아가는 경우, 터치패드 문제라고 단정짓기 전에 원인을 조사해 보세요. 그래픽 드라이버 호환성, 원격 액세스 구성 또는 로컬 정책으로 인해 사용 가능한 세션이 변경될 수 있습니다.

Wayland에서 Touchegg 설치가 일반적으로 첫 번째 해결책이 아닌 이유

흔히 제시되는 해결책 중 하나는 제스처 데몬을 즉시 설치하는 것입니다. 이는 일부 환경에서 사용자 지정 동작을 구현하는 데 유용할 수 있지만, Wayland 세션에서 GNOME 내장 제스처가 작동하지 않을 때 가장 먼저 취해야 할 적절한 조치는 아닙니다. GNOME Shell은 이미 자체적인 세 손가락 시스템 제스처를 구현하고 있습니다. libinput이 어떤 제스처를 인식하는지 확인하기 전에 다른 제스처 레이어를 추가하면 문제 진단이 어려워지고 시스템에서 예약된 제스처와 충돌이 발생할 수 있습니다.

GNOME의 휴먼 인터페이스 가이드라인에서는 세 손가락 및 네 손가락 제스처는 시스템 용도로만 사용하도록 되어 있습니다. 따라서 애플리케이션 수준의 제스처 동작은 데스크톱 작업 공간의 제스처와 상호 작용할 수 없습니다. GNOME 포인터 및 터치 가이드라인을 참조하십시오 .

문제가 실제로 해결되었는지 확인하는 방법

"커서가 움직입니다"라는 말에서 멈추지 마십시오. 성공적인 복구는 여러 독립적인 검사를 통과해야 합니다.

• echo $XDG_SESSION_TYPE반환됩니다 wayland.
• 설정에 터치패드 항목이 있으며 일반적인 터치패드 기능이 정상적으로 작동합니다.
• 세 손가락으로 위로 스와이프하면 활동 메뉴가 열립니다.
• 세 손가락으로 왼쪽 또는 오른쪽으로 스와이프하면 작업 공간이 전환됩니다.
• sudo libinput debug-events해당 멀티핑거 제스처 이벤트를 표시합니다.
• 로그아웃이나 재부팅 후에도 제스처 기능은 계속 작동합니다.

libinput 테스트는 성공했지만 업데이트, 확장 프로그램 테스트, 그리고 Wayland에 새로 로그인한 후에도 GNOME 제스처가 여전히 작동하지 않는다면, 문제는 데스크톱 세션 또는 컴포지터 수준의 문제일 가능성이 높습니다. 이 경우, Ubuntu 버전, 커널 버전(`/`/`) uname -r, GNOME Shell 버전(`/`/`) gnome-shell --version, 터치패드 모델(` libinput list-devices/ ...

libinput에서 세 손가락 제스처가 전혀 인식되지 않는다면 하드웨어 성능, 펌웨어 및 커널 지원에 집중하세요. GNOME 작업 공간의 제스처는 정상적으로 작동하지만 특정 애플리케이션의 핀치 또는 탐색 제스처만 작동하지 않는다면 해당 애플리케이션만 별도로 문제 해결을 진행하세요. 이러한 구분이 바로 사소한 입력 문제를 더 큰 시스템 구성 문제로 악화시키지 않고 Ubuntu 24.04에서 터치패드 제스처 문제를 해결하는 핵심입니다.