Corrigir problema com gestos do touchpad que não funcionam no Wayland no Ubuntu 24.04

Você move o cursor normalmente, a rolagem com dois dedos ainda pode funcionar, mas o gesto familiar de deslizar com três dedos não abre mais as Atividades nem alterna entre espaços de trabalho. No Ubuntu 24.04, esse sintoma é frequentemente diagnosticado erroneamente como "gestos Wayland desativados". No ambiente de trabalho GNOME padrão, não há uma opção principal separada para os gestos de três dedos integrados do sistema. A questão importante é onde o gesto para: na sessão, nas configurações do touchpad, no libinput, no GNOME Shell ou no próprio hardware.

Este guia começa com verificações rápidas e reversíveis, e depois avança para o diagnóstico de entrada. O Ubuntu 24.04 LTS usa o GNOME no Wayland por padrão em sistemas compatíveis, e o GNOME documenta gestos de deslizar com três dedos para abrir a visão geral de Atividades e alternar entre espaços de trabalho. A pilha libinput subjacente pode reportar eventos de deslizar e pinçar em touchpads compatíveis. Esses dois fatos nos fornecem um caminho claro para a solução de problemas: confirmar o Wayland, confirmar se o touchpad está ativo, testar o gesto padrão do GNOME e, em seguida, verificar se o libinput recebe eventos de múltiplos dedos.

1. Confirme se você está realmente em uma sessão Wayland.

Abra o Terminal e execute:

echo $XDG_SESSION_TYPE

O resultado esperado é wayland. Se o comando imprimir x11, você está solucionando problemas com um caminho de entrada diferente. O Ubuntu ainda pode oferecer uma sessão Xorg, e o comportamento dos gestos não é idêntico à experiência nativa do GNOME Wayland.

Se você estiver usando o Xorg e quiser a sessão Wayland padrão, faça logout. Na tela de login, selecione sua conta, abra o seletor de sessão e escolha Ubuntu em vez de Ubuntu no Xorg quando essas opções estiverem disponíveis. Hardware, drivers gráficos, sessões de área de trabalho remota ou políticas de administrador podem afetar quais sessões são oferecidas; portanto, não force uma opção ausente sem verificar o motivo da indisponibilidade.

O comportamento oficial dos gestos do GNOME está documentado na Ajuda do GNOME: Usar gestos em touchpads e telas sensíveis ao toque .

2. Certifique-se de que o touchpad esteja ativado.

Abra Configurações > Mouse e Touchpad . Confirme se o touchpad está ativado. Teste também a rolagem com dois dedos e o toque básico. O painel de configurações do GNOME exibe os controles do touchpad somente quando a área de trabalho reconhece um touchpad; portanto, a ausência da seção Touchpad é uma pista importante, e não um problema estético.

Não perca tempo procurando uma opção para ativar/desativar os gestos com três dedos no painel de Configurações padrão do Ubuntu 24.04. Os gestos integrados do sistema GNOME Shell normalmente não são controlados por um botão liga/desliga dedicado nesse painel. Se o movimento do ponteiro e a rolagem com dois dedos funcionarem, mas os gestos com três dedos não, prossiga para o próximo teste.

Para obter informações sobre os controles do touchpad, consulte a Ajuda do GNOME: Clicar, arrastar ou rolar com o touchpad .

3. Teste um gesto padrão do GNOME, não um gesto específico de um aplicativo.

Use três dedos e deslize para cima no touchpad. O GNOME deve abrir a visão geral de Atividades. Um novo deslize para cima abrirá a visualização de aplicativos. Um deslize com três dedos para a esquerda ou para a direita alternará entre os espaços de trabalho. Esses são os melhores testes de referência porque são gestos do GNOME Shell, e não recursos fornecidos pelo Firefox, uma extensão do navegador, um complemento da área de trabalho ou um daemon de gestos de terceiros.

O gesto de pinça para zoom é diferente. O libinput consegue reconhecer gestos de pinça, mas se um gesto de pinça amplia o conteúdo depende do aplicativo e do conjunto de ferramentas. Um gesto de deslizar com três dedos na área de trabalho funcionando, juntamente com um gesto de pinça que não funciona em um aplicativo, geralmente indica um problema com o aplicativo, e não com o Wayland como um todo.

4. Verifique se a libinput reconhece o touchpad.

O Ubuntu fornece o libinput-toolspacote para diagnóstico de entrada. Se o libinputcomando não estiver instalado, adicione-o com:

sudo apt update
sudo apt install libinput-tools

Em seguida, liste os dispositivos:

sudo libinput list-devices

Localize o bloco correspondente ao seu touchpad. O nome exato do modelo, o nó de evento, as dimensões e a configuração variam de acordo com o laptop. O importante é que a libinput liste o dispositivo como um touchpad e exponha as funcionalidades esperadas. O pacote do Ubuntu 24.04 está documentado no catálogo de pacotes do Ubuntu Noble , e o próprio comando é abordado na página de manual da libinput do Ubuntu .

Se o touchpad estiver ausente libinput list-devices, isso não é mais um problema exclusivo dos gestos do GNOME. Verifique se o dispositivo aparece nas configurações de firmware/BIOS, se a opção de ativar/desativar o touchpad está habilitada e se o kernel reconhece o dispositivo após a reinicialização. Problemas específicos do notebook relacionados ao kernel, I2C-HID ou firmware precisam ser resolvidos para que o GNOME possa receber gestos.

5. Observe os eventos de gestos brutos

O teste mais informativo é verificar se a libinput emite eventos de gesto enquanto você move três dedos. Execute:

sudo libinput debug-events

Em seguida, execute um gesto de deslizar com três dedos. Em dispositivos compatíveis, você deverá ver linhas de eventos de gestos, como início, atualização e fim do gesto. O nó de evento exato, o tempo, os incrementos e a formatação podem variar. O comando geralmente requer acesso root, pois lê /dev/input/event*os dispositivos diretamente.

A página de manual oficial do Ubuntu para libinput-debug-events descreve essa ferramenta como um auxiliar de depuração e alerta que seu formato de saída pode mudar. A própria documentação de gestos do libinput explica como os gestos de deslizar e pinçar são gerados.

Se os eventos de gestos aparecerem: o hardware e o caminho do libinput estão funcionando. Em seguida, verifique o GNOME Shell, as extensões, o estado da sessão e as atualizações. Se nenhum evento de gesto com vários dedos aparecer: teste novamente com os dedos claramente separados. Se os eventos básicos do ponteiro aparecerem, mas os gestos com três dedos não funcionarem, o touchpad pode não ter a capacidade multitoque necessária ou um problema no kernel/firmware pode estar impedindo que ele reporte contatos suficientes.

6. Instale as atualizações mais recentes do Ubuntu 24.04.

Antes de substituir drivers ou editar arquivos de configuração de baixo nível, atualize os pacotes instalados do Ubuntu 24.04:

sudo apt update
sudo apt upgrade

Reinicie o sistema se a atualização instalar um novo kernel, pilha gráfica ou outros componentes que exijam reinicialização. O processamento de gestos abrange várias camadas — drivers de entrada do kernel, libinput, Mutter/GNOME Shell e aplicativos — portanto, um bug já corrigido pode permanecer visível em uma máquina que não foi atualizada.

Evite baixar pacotes aleatórios do Synaptics ou copiar trechos de configuração antigos do Xorg de tutoriais escritos para versões anteriores do Ubuntu. Na sessão padrão do Wayland GNOME, a biblioteca de entrada relevante é a libinput, e arquivos de configuração exclusivos do Xorg não são uma maneira confiável de corrigir gestos do GNOME Shell.

7. Desative temporariamente as extensões do GNOME Shell

Se libinput debug-eventso GNOME exibir claramente os gestos de deslizar com três dedos, mas não responder, desative temporariamente as extensões de terceiros do GNOME Shell e teste novamente. As extensões podem alterar o comportamento do espaço de trabalho, o gerenciamento de janelas, o comportamento da visão geral ou o tratamento de gestos. Use o aplicativo Extensões, se estiver instalado, ou liste as extensões ativadas com:

gnome-extensions list --enabled

Desative extensões suspeitas uma de cada vez com:

gnome-extensions disable EXTENSION_UUID

Substitua EXTENSION_UUIDpelo identificador retornado pelo comando list. Sair e entrar novamente após alterar as extensões do Shell pode ajudar a garantir que você esteja testando uma sessão limpa.

Esta etapa é diagnóstica e não uma recomendação para desativar permanentemente as extensões. Depois de identificar a extensão que está causando conflito, atualize-a, ajuste suas configurações ou deixe apenas essa extensão desativada.

8. Reinicie uma sessão Wayland limpa e teste novamente.

Saia da sessão, escolha a sessão normal do Ubuntu Wayland ao iniciar sessão e repita os testes de gestos padrão antes de reabrir vários aplicativos. Isso limpa o estado transitório do GNOME Shell e facilita a identificação de se uma extensão ou um processo específico da sessão estava envolvido.

Se o sistema sempre retornar ao Xorg mesmo quando você selecionar o Ubuntu, investigue o motivo em vez de presumir que o touchpad seja o culpado. A compatibilidade do driver gráfico, a configuração de acesso remoto ou a política local podem alterar a sessão disponível.

Por que instalar o Touchegg geralmente não é a primeira solução no Wayland

Uma sugestão comum é instalar um daemon de gestos imediatamente. Isso pode ser útil para ações personalizadas em alguns ambientes, mas não é a primeira resposta correta quando os gestos integrados do GNOME falham em uma sessão Wayland. O GNOME Shell já implementa seus próprios gestos de sistema com três dedos. Adicionar outra camada de gestos antes de confirmar o que o libinput detecta pode dificultar o diagnóstico e criar conflitos com os gestos reservados pelo sistema.

As Diretrizes de Interface Humana do GNOME observam que os gestos de três e quatro dedos são reservados para uso do sistema. É por isso que o comportamento de gestos em nível de aplicativo não é intercambiável com os gestos da área de trabalho. Consulte as diretrizes de ponteiro e toque do GNOME .

Como verificar se o problema foi realmente resolvido?

Não pare apenas quando o cursor se mover. Um reparo bem-sucedido deve passar por diversas verificações independentes:

• echo $XDG_SESSION_TYPEretornos wayland.
• A seção Touchpad está presente nas Configurações e funciona normalmente.
• Um gesto de deslizar para cima com três dedos abre o aplicativo Atividades.
• Um gesto de deslizar com três dedos para a esquerda ou para a direita alterna entre os espaços de trabalho.
• sudo libinput debug-eventsExibe os eventos correspondentes de gestos com vários dedos.
• Os gestos continuam funcionando mesmo após o logout ou reinicialização.

Se o teste do libinput for bem-sucedido, mas os gestos do GNOME continuarem falhando após atualizações, testes de extensões e um novo login no Wayland, você terá identificado o problema como sendo relacionado à sessão da área de trabalho ou ao compositor. Nesse ponto, colete a versão do Ubuntu, a versão do kernel (obtida em `/etc/ nginx.conf` uname -r), a versão do GNOME Shell (obtida em `/etc/nginx.conf` gnome-shell --version), o modelo do touchpad ( libinput list-devicesobtido em `/etc/nginx.conf`) e uma breve descrição de qual gesto padrão está apresentando falha. Essas informações são muito mais úteis para um relatório de bug do que reinstalar drivers às cegas.

Se o libinput nunca reportar gestos com três dedos, concentre-se na capacidade do hardware, no firmware e no suporte do kernel. Se apenas os gestos de pinça ou navegação de um aplicativo falharem, enquanto os gestos do espaço de trabalho GNOME funcionarem, solucione o problema desse aplicativo separadamente. Essa distinção é fundamental para corrigir os gestos do touchpad no Ubuntu 24.04 sem transformar um pequeno problema de entrada em um problema maior de configuração do sistema.