Risolvere il problema dei gesti del touchpad non funzionanti su Wayland in Ubuntu 24.04

Muovendo il puntatore normalmente, lo scorrimento a due dita potrebbe ancora funzionare, ma il familiare gesto a tre dita non apre più le Attività né cambia area di lavoro. Su Ubuntu 24.04, questo sintomo viene spesso erroneamente diagnosticato come "disabilitazione delle gesture di Wayland". Nell'ambiente desktop GNOME standard, non esiste un interruttore principale separato per le gesture di sistema a tre dita integrate. La domanda utile è dove finisce la gesture: nella sessione, nelle impostazioni del touchpad, in libinput, in GNOME Shell o nell'hardware stesso.

Questa guida inizia con controlli rapidi e reversibili, per poi passare alla diagnostica dell'input. Ubuntu 24.04 LTS utilizza GNOME su Wayland per impostazione predefinita sui sistemi supportati, e GNOME documenta gli swipe a tre dita per aprire la panoramica delle attività e cambiare area di lavoro. Lo stack libinput sottostante è in grado di segnalare eventi di swipe e pinch sui touchpad supportati. Questi due elementi ci forniscono un percorso di risoluzione dei problemi chiaro: verificare Wayland, verificare che il touchpad sia attivo, testare la gesture GNOME predefinita, quindi verificare se libinput riceve eventi multi-dito.

1. Conferma di essere effettivamente in una sessione Wayland

Apri il Terminale ed esegui:

echo $XDG_SESSION_TYPE

Il risultato atteso è wayland. Se il comando stampa x11, stai eseguendo la risoluzione dei problemi su un percorso di input diverso. Ubuntu può ancora offrire una sessione Xorg e il comportamento dei gesti lì non è identico all'esperienza nativa di GNOME Wayland.

Se utilizzi Xorg e desideri la sessione Wayland predefinita, disconnettiti. Nella schermata di accesso, seleziona il tuo account, apri la finestra di selezione della sessione e scegli Ubuntu anziché Ubuntu su Xorg, se disponibile. Hardware, driver grafici, sessioni desktop remoto o criteri di amministrazione possono influire sulle sessioni offerte, quindi non forzare un'opzione mancante senza prima verificarne il motivo.

Il comportamento ufficiale dei gesti in GNOME è documentato in GNOME Help: Utilizzare i gesti su touchpad e touchscreen .

2. Assicurarsi che il touchpad sia abilitato

Apri Impostazioni > Mouse e touchpad . Verifica che il touchpad sia abilitato. Prova anche lo scorrimento a due dita e il tocco di base. Il pannello delle impostazioni di GNOME mostra i controlli del touchpad solo quando il desktop lo riconosce, quindi l'assenza della sezione Touchpad è un indizio importante piuttosto che un problema estetico.

Non perdete tempo a cercare un'opzione per attivare/disattivare le "gesture a tre dita" nel pannello delle impostazioni di Ubuntu 24.04. Le gesture di sistema integrate in GNOME Shell non sono normalmente controllate da un interruttore dedicato. Se il movimento del puntatore e lo scorrimento a due dita funzionano ma le gesture a tre dita no, passate al test successivo.

Per i comandi del touchpad documentati, consultare la Guida di GNOME: Fare clic, trascinare o scorrere con il touchpad .

3. Prova una gesture standard di GNOME, non una gesture specifica dell'app.

Usa tre dita e scorri verso l'alto sul touchpad. GNOME dovrebbe aprire la panoramica delle attività. Un ulteriore scorrimento verso l'alto può aprire la visualizzazione delle applicazioni. Uno scorrimento con tre dita verso sinistra o verso destra dovrebbe cambiare area di lavoro. Questi sono i migliori test di base perché si tratta di gesti di GNOME Shell, non di funzionalità fornite da Firefox, da un'estensione del browser, da un componente aggiuntivo per il desktop o da un demone di gesti di terze parti.

La funzione di zoom tramite pizzico è diversa. libinput è in grado di riconoscere i gesti di pizzico, ma la possibilità che un pizzico ingrandisca il contenuto dipende dall'applicazione e dal toolkit. Uno scorrimento con tre dita funzionante nell'area di lavoro, a fronte di un pizzico non funzionante in una determinata applicazione, di solito indica un problema con l'applicazione stessa, non con Wayland nel suo complesso.

4. Verifica se libinput riconosce il touchpad

Ubuntu fornisce il libinput-toolspacchetto per la diagnostica degli input. Se il libinputcomando non è installato, aggiungilo con:

sudo apt update
sudo apt install libinput-tools

Quindi elenca i dispositivi:

sudo libinput list-devices

Individua il blocco corrispondente al tuo touchpad. Il nome esatto del modello, il nodo evento, le dimensioni e la configurazione variano a seconda del portatile. L'importante è che libinput elenchi il dispositivo come touchpad e ne mostri le funzionalità previste. Il pacchetto per Ubuntu 24.04 è documentato nel catalogo dei pacchetti di Ubuntu Noble , e il comando stesso è descritto nella pagina man di libinput per Ubuntu .

Se il touchpad non è presente libinput list-devices, il problema non riguarda più principalmente le gesture di GNOME. Verifica se il dispositivo compare nelle impostazioni del firmware/BIOS, se è attivo un interruttore per il touchpad hardware e se il kernel rileva il dispositivo dopo un riavvio. Eventuali problemi specifici del kernel, dell'I2C-HID o del firmware del portatile devono essere risolti prima che GNOME possa ricevere le gesture.

5. Osserva gli eventi gestuali non elaborati

Il test più informativo consiste nel verificare se libinput emette eventi di gesto mentre muovi tre dita. Esegui:

sudo libinput debug-events

Quindi esegui uno scorrimento con tre dita. Su hardware supportato dovresti visualizzare le righe degli eventi del gesto, come l'inizio dello scorrimento, gli aggiornamenti e la fine. Il nodo dell'evento esatto, la tempistica, le differenze e la formattazione possono variare. Il comando di solito richiede i permessi di root perché legge /dev/input/event*direttamente i dispositivi.

La pagina man ufficiale di Ubuntu per libinput-debug-events descrive questo strumento come un ausilio per il debug e avverte che il suo formato di output può cambiare. La documentazione di libinput sui gesti spiega come vengono generati i gesti di scorrimento e di pizzicamento.

Se vengono visualizzati gli eventi gestuali: l'hardware e il percorso libinput funzionano correttamente. Concentrati ora su GNOME Shell, estensioni, stato della sessione e aggiornamenti. Se non vengono visualizzati eventi gestuali multi-dito: riprova con le dita ben separate. Se vengono visualizzati eventi di puntatore di base ma non vengono mai visualizzati gesti a tre dita, il touchpad potrebbe non disporre della funzionalità multitouch necessaria oppure un problema del kernel/firmware potrebbe impedirgli di segnalare un numero sufficiente di contatti.

6. Installa gli aggiornamenti correnti di Ubuntu 24.04

Prima di sostituire i driver o modificare i file di configurazione di basso livello, aggiorna i pacchetti 24.04 installati:

sudo apt update
sudo apt upgrade

Riavvia il sistema se l'aggiornamento installa un nuovo kernel, uno stack grafico o altri componenti che richiedono un riavvio. La gestione dei gesti coinvolge diversi livelli: driver di input del kernel, libinput, Mutter/GNOME Shell e applicazioni; pertanto, un bug già risolto può rimanere visibile su una macchina non aggiornata.

Evitate di scaricare pacchetti Synaptics a caso o di copiare vecchi frammenti di configurazione di Xorg da tutorial scritti per versioni precedenti di Ubuntu. Nella sessione standard di Wayland GNOME, la libreria di input rilevante è libinput, e i file di configurazione specifici per Xorg non sono un metodo affidabile per ripristinare i gesti di GNOME Shell.

7. Disabilitare temporaneamente le estensioni di GNOME Shell

Se libinput debug-eventsvengono visualizzati chiaramente gli scorrimenti con tre dita ma GNOME non fa nulla, disabilita temporaneamente le estensioni di terze parti di GNOME Shell e riprova. Le estensioni possono modificare il comportamento dell'area di lavoro, la gestione delle finestre, il comportamento della panoramica o la gestione dei gesti. Usa l'app Estensioni se l'hai installata oppure elenca le estensioni abilitate con:

gnome-extensions list --enabled

Disabilita le estensioni sospette una alla volta con:

gnome-extensions disable EXTENSION_UUID

Sostituisci EXTENSION_UUIDcon un identificatore restituito dal comando list. Disconnettersi e accedere nuovamente dopo aver modificato le estensioni della shell può aiutare a garantire che si stia testando una sessione pulita.

Questo passaggio è diagnostico, non un consiglio per utilizzare il sistema in modo permanente senza estensioni. Una volta identificata l'estensione in conflitto, aggiornala, regola le sue impostazioni oppure lascia disabilitata solo quella.

8. Riapri una sessione Wayland pulita e riprova.

Disconnettiti, scegli la normale sessione di Ubuntu Wayland all'accesso e ripeti i test predefiniti delle gesture prima di riaprire molte applicazioni. Questo cancella lo stato temporaneo di GNOME Shell e semplifica l'individuazione di eventuali processi coinvolti, come ad esempio un'estensione o un processo specifico della sessione.

Se il sistema torna sempre a Xorg anche quando si seleziona Ubuntu, è meglio indagare sulla causa piuttosto che presumere che il problema sia il touchpad. La compatibilità dei driver grafici, la configurazione dell'accesso remoto o le policy locali possono modificare la sessione disponibile.

Perché l'installazione di Touchegg di solito non è la prima soluzione per Wayland

Un suggerimento comune è quello di installare immediatamente un demone per i gesti. Questo può essere utile per azioni personalizzate in alcuni ambienti, ma non è la risposta giusta quando i gesti integrati di GNOME non funzionano in una sessione Wayland. GNOME Shell implementa già i propri gesti di sistema a tre dita. Aggiungere un ulteriore livello di gestione dei gesti prima di verificare cosa rileva libinput può rendere la diagnosi più difficile e creare conflitti con i gesti riservati al sistema.

Le linee guida per l'interfaccia utente di GNOME specificano che i gesti a tre e quattro dita sono riservati all'uso di sistema. Per questo motivo, il comportamento dei gesti a livello di applicazione non è intercambiabile con i gesti dell'area di lavoro del desktop. Consultare le linee guida di GNOME relative al puntatore e al tocco .

Come verificare che il problema sia stato effettivamente risolto

Non fermatevi al semplice "movimento del cursore". Una riparazione riuscita deve superare diversi controlli indipendenti:

• echo $XDG_SESSION_TYPErestituisce wayland.
• La sezione Touchpad è presente nelle Impostazioni e il touchpad funziona normalmente.
• Scorrendo verso l'alto con tre dita si apre l'app Attività.
• Scorrendo con tre dita verso sinistra o verso destra si passa da un'area di lavoro all'altra.
• sudo libinput debug-eventsmostra i corrispondenti eventi di gesti multi-dito.
• Le gesture continuano a funzionare anche dopo aver effettuato il logout o riavviato il sistema.

Se il test di libinput ha esito positivo ma le gesture di GNOME continuano a non funzionare dopo gli aggiornamenti, i test delle estensioni e un nuovo accesso a Wayland, il problema è circoscritto a una questione di sessione desktop o di compositore. A questo punto, raccogli la versione di Ubuntu, la versione del kernel uname -r, la versione di GNOME Shell gnome-shell --version, il modello del touchpad libinput list-devicese una breve descrizione della gesture predefinita che non funziona. Queste informazioni sono molto più utili per una segnalazione di bug rispetto alla reinstallazione dei driver senza un valido motivo.

Se libinput non segnala mai i gesti a tre dita, concentratevi sulle capacità hardware, sul firmware e sul supporto del kernel. Se solo i gesti di pizzicamento o di navigazione di un'applicazione non funzionano, mentre quelli dell'ambiente di lavoro GNOME funzionano, risolvete il problema di quell'applicazione separatamente. Questa distinzione è fondamentale per risolvere i problemi relativi ai gesti del touchpad su Ubuntu 24.04 senza trasformare un piccolo problema di input in un problema di configurazione di sistema più complesso.