Remediați problema gesturilor touchpad care nu funcționează pe Wayland în Ubuntu 24.04

Mișcați indicatorul normal, derularea cu două degete poate funcționa în continuare, dar glisarea familiară cu trei degete nu mai deschide Activități și nu mai comută între spațiile de lucru. Pe Ubuntu 24.04, acest simptom este adesea diagnosticat confundat cu „gesturile Wayland dezactivate”. Pe desktopul GNOME standard, nu există un comutator principal separat pentru gesturile de sistem cu trei degete încorporate. Întrebarea utilă este unde se oprește gestul: la sesiune, setările touchpad-ului, libinput, GNOME Shell sau hardware-ul în sine.

Acest ghid începe cu verificări rapide și reversibile, apoi trece la diagnosticarea intrărilor. Ubuntu 24.04 LTS folosește GNOME pe Wayland în mod implicit pe sistemele compatibile, iar GNOME documentează glisările cu trei degete pentru deschiderea prezentării generale a Activităților și comutarea spațiilor de lucru. Stiva libinput subiacentă poate raporta evenimente de glisare și ciupire pe touchpad-urile compatibile. Aceste două aspecte ne oferă o cale clară de depanare: confirmați Wayland, confirmați că touchpad-ul este activ, testați gestul GNOME standard, apoi verificați dacă libinput primește evenimente cu mai multe degete.

1. Confirmă că te afli într-o sesiune Wayland

Deschideți Terminalul și executați:

echo $XDG_SESSION_TYPE

Rezultatul așteptat este wayland. Dacă comanda afișează x11, depanați o cale de intrare diferită. Ubuntu poate oferi în continuare o sesiune Xorg, iar comportamentul gesturilor acolo nu este identic cu experiența nativă GNOME Wayland.

Dacă sunteți pe Xorg și doriți sesiunea Wayland implicită, deconectați-vă. Pe ecranul de conectare, selectați-vă contul, deschideți selectorul de sesiuni și alegeți Ubuntu în loc de Ubuntu pe Xorg atunci când aceste opțiuni sunt disponibile. Hardware-ul, driverele grafice, sesiunile desktop la distanță sau politica administratorului pot afecta sesiunile oferite, așa că nu forțați o opțiune lipsă fără a verifica de ce nu este disponibilă.

Comportamentul oficial al gesturilor din GNOME este documentat în Ajutorul GNOME: Utilizarea gesturilor pe touchpad-uri și ecrane tactile .

2. Asigurați-vă că touchpad-ul în sine este activat

Deschideți Setări > Mouse și touchpad . Confirmați că touchpad-ul este activat. Testați și derularea cu două degete și atingerea simplă. Panoul de setări GNOME expune comenzile touchpad-ului numai atunci când desktopul recunoaște un touchpad, așadar o secțiune Touchpad lipsă este un indiciu semnificativ, mai degrabă decât o problemă cosmetică.

Nu pierdeți timpul căutând un comutator pentru „gesturi cu trei degete” în panoul Setări Ubuntu 24.04 standard. Gesturile încorporate în sistemul GNOME Shell nu sunt în mod normal controlate de un comutator dedicat de pornire/oprire acolo. Dacă mișcarea indicatorului și derularea cu două degete funcționează, dar gesturile cu trei degete nu, continuați cu următorul test.

Pentru comenzile documentate ale touchpad-ului, consultați Ajutorul GNOME: Faceți clic, trageți sau derulați cu touchpad-ul .

3. Testează un gest standard GNOME, nu un gest specific aplicației

Folosește trei degete și glisează în sus pe touchpad. GNOME ar trebui să deschidă prezentarea generală a activităților. O glisare suplimentară în sus poate deschide vizualizarea aplicațiilor. O glisare cu trei degete la stânga sau la dreapta ar trebui să schimbe spațiile de lucru. Acestea sunt cele mai bune teste de bază, deoarece sunt gesturi GNOME Shell, nu funcții furnizate de Firefox, o extensie de browser, un add-on pentru desktop sau un daemon de gesturi terț.

Funcția „pinch-to-zoom” este diferită. libinput poate recunoaște gesturile de „pinch”, dar mărirea conținutului depinde de aplicație și de setul de instrumente. O glisare funcțională cu trei degete în spațiul de lucru, alături de o „pinch-to-zoom” nefuncțională, într-o aplicație indică de obicei către aplicație, nu către Wayland în ansamblu.

4. Verificați dacă libinput recunoaște touchpad-ul

Ubuntu oferă libinput-toolspachetul pentru diagnosticarea intrărilor. Dacă libinputcomanda nu este instalată, adăugați-o cu:

sudo apt update
sudo apt install libinput-tools

Apoi enumerați dispozitivele:

sudo libinput list-devices

Găsiți blocul pentru touchpad-ul dvs. Numele exact al modelului, nodul de eveniment, dimensiunile și configurația diferă în funcție de laptop. Important este că libinput listează dispozitivul ca touchpad și expune capabilitățile așteptate. Pachetul Ubuntu 24.04 este documentat în catalogul de pachete Ubuntu Noble , iar comanda în sine este acoperită de pagina de manual Ubuntu libinput .

Dacă touchpad-ul lipsește din libinput list-devices, aceasta nu mai este în principal o problemă legată de gesturi GNOME. Verificați dacă dispozitivul apare în setările firmware/BIOS, dacă este activă o comutare hardware pentru touchpad-ul respectiv și dacă kernelul vede dispozitivul după o repornire. Problemele specifice laptopului legate de kernel, I2C-HID sau firmware trebuie rezolvate înainte ca GNOME să poată primi gesturi.

5. Urmăriți evenimentele gestuale brute

Cel mai informativ test este să vezi dacă libinput emite evenimente gestuale în timp ce miști trei degete. Execută:

sudo libinput debug-events

Apoi efectuați o glisare cu trei degete. Pe hardware-ul compatibil ar trebui să vedeți linii de evenimente gestuale, cum ar fi începutul glisării, actualizările și sfârșitul. Nodul exact al evenimentului, sincronizarea, deltele și formatarea pot varia. Comanda necesită de obicei acces root, deoarece citește /dev/input/event*direct dispozitivele.

Pagina oficială de manual libinput-debug-events din Ubuntu descrie acest instrument ca un instrument de depanare și avertizează că formatul său de ieșire se poate modifica. Documentația proprie a gesturilor libinput explică modul în care sunt generate gesturile de glisare și de prindere a degetelor.

Dacă apar evenimente gestuale: hardware-ul și calea libinput funcționează. Concentrați-vă în continuare pe GNOME Shell, extensii, starea sesiunii și actualizări. Dacă nu apar evenimente gestuale cu mai multe degete: testați din nou cu degetele clar separate. Dacă apar evenimente de bază ale indicatorului, dar gesturile cu trei degete nu apar niciodată, este posibil ca touchpad-ul să nu aibă capacitatea multitouch necesară sau o problemă a kernelului/firmware-ului să îl împiedice să raporteze suficiente contacte.

6. Instalați actualizările Ubuntu 24.04

Înainte de a înlocui driverele sau de a edita fișierele de configurare de nivel scăzut, actualizați pachetele 24.04 instalate:

sudo apt update
sudo apt upgrade

Reporniți sistemul dacă actualizarea instalează un kernel nou, o stivă grafică nouă sau alte componente care necesită o repornire. Gestionarea gesturilor traversează mai multe niveluri - drivere de intrare pentru kernel, libinput, Mutter/GNOME Shell și aplicații - astfel încât o eroare deja remediată poate rămâne vizibilă pe o mașină care nu a fost actualizată.

Evitați descărcarea unor pachete Synaptics aleatorii sau copierea unor fragmente vechi de configurare Xorg din tutoriale scrise pentru versiuni anterioare de Ubuntu. În sesiunea standard Wayland GNOME, libinput este biblioteca de intrare relevantă, iar fișierele de configurare exclusive pentru Xorg nu reprezintă o modalitate fiabilă de a repara gesturile GNOME Shell.

7. Dezactivați temporar extensiile GNOME Shell

Dacă libinput debug-eventsse afișează clar glisări cu trei degete, dar GNOME nu face nimic, dezactivați temporar extensiile GNOME Shell terțe și testați din nou. Extensiile pot modifica comportamentul spațiului de lucru, gestionarea ferestrelor, comportamentul prezentării generale sau gestionarea gesturilor. Folosiți aplicația Extensii dacă o aveți instalată sau listați extensiile activate cu:

gnome-extensions list --enabled

Dezactivați extensiile suspecte pe rând cu:

gnome-extensions disable EXTENSION_UUID

Înlocuiți EXTENSION_UUIDcu un identificator returnat de comanda list. Deconectarea și reconectarea după modificarea extensiilor Shell vă poate ajuta să vă asigurați că testați o sesiune curată.

Acest pas este de diagnosticare, nu o recomandare de a rula permanent fără extensii. După ce identificați extensia care intră în conflict, actualizați-o, ajustați-i setările sau lăsați doar extensia respectivă dezactivată.

8. Reintrați într-o sesiune Wayland curată și testați din nou

Deconectați-vă, alegeți sesiunea normală Ubuntu Wayland la conectare și repetați testele de gesturi standard înainte de a redeschide multe aplicații. Acest lucru șterge starea tranzitorie a GNOME Shell și facilitează identificarea faptului dacă a fost implicată o extensie sau un proces specific sesiunii.

Dacă sistemul revine întotdeauna la Xorg chiar și atunci când selectați Ubuntu, investigați motivul în loc să presupuneți că touchpad-ul este de vină. Compatibilitatea driverelor grafice, configurația accesului la distanță sau politica locală pot modifica sesiunea disponibilă.

De ce instalarea Touchegg nu este de obicei prima soluție pentru Wayland

O sugestie comună este instalarea imediată a unui daemon de gesturi. Acest lucru poate fi util pentru acțiuni personalizate în anumite medii, dar nu este primul răspuns corect atunci când gesturile GNOME încorporate eșuează într-o sesiune Wayland. GNOME Shell implementează deja propriile gesturi de sistem cu trei degete. Adăugarea unui alt strat de gesturi înainte de a confirma ceea ce vede libinput poate îngreuna diagnosticarea și poate crea conflicte cu gesturile rezervate sistemului.

Ghidul GNOME pentru interfața umană menționează că gesturile cu trei și patru degete sunt rezervate utilizării în sistem. De aceea, comportamentul gesturilor la nivel de aplicație nu este interschimbabil cu gesturile din spațiul de lucru al desktopului. Consultați instrucțiunile GNOME pentru indicatorul și atingere .

Cum să verifici dacă problema este într-adevăr rezolvată

Nu vă opriți la „mișcarea cursorului”. O reparație reușită ar trebui să treacă de mai multe verificări independente:

• echo $XDG_SESSION_TYPEreturnează wayland.
• Secțiunea Touchpad este prezentă în Setări și funcționează comportamentul obișnuit al touchpad-ului.
• O glisare în sus cu trei degete deschide Activități.
• O glisare cu trei degete la stânga sau la dreapta schimbă spațiile de lucru.
• sudo libinput debug-eventsafișează evenimentele corespunzătoare gesturilor cu mai multe degete.
• Gesturile funcționează în continuare după o deconectare sau o repornire.

Dacă testul libinput reușește, dar gesturile GNOME tot eșuează după actualizări, testarea extensiilor și o nouă conectare Wayland, ați redus problema la o problemă la nivel de sesiune desktop sau la nivel de compozitor. În acel moment, colectați versiunea Ubuntu, versiunea kernelului de la uname -r, versiunea GNOME Shell de la gnome-shell --version, modelul touchpad-ului de la libinput list-devicesși o scurtă descriere a gestului standard care eșuează. Aceste dovezi sunt mult mai utile pentru un raport de eroare decât reinstalarea orbește a driverelor.

Dacă libinput nu raportează niciodată gesturi cu trei degete, concentrați-vă pe capacitatea hardware, firmware și suportul kernelului. Dacă gesturile de ciupire sau de navigare ale unei singure aplicații eșuează în timp ce gesturile din spațiul de lucru GNOME funcționează, depanați separat aplicația respectivă. Această distincție este cheia pentru remedierea gesturilor touchpad pe Ubuntu 24.04 fără a transforma o mică problemă de introducere a datelor într-o problemă mai mare de configurare a sistemului.