Problèmes de compatibilité Wayland

Wayland Vue d’ensemble

Ubuntu 26.04 utilise le protocole d’affichage Wayland par défaut. Wayland est plus sécurisé et efficace que X11, mais certaines applications plus anciennes peuvent avoir des problèmes de compatibilité.

# Confirm the current session type
echo $XDG_SESSION_TYPE
# wayland or x11

Problèmes de compatibilité courants

Les fenêtres d’application sont floues ou la mise à l’échelle est anormale

Certaines applications X11 peuvent apparaître floues sous XWayland (en particulier sur les écrans à haute résolution).

# Force an application to use native Wayland (if supported)
GDK_BACKEND=wayland APP_NAME
 
# Force X11 (through XWayland)
GDK_BACKEND=x11 APP_NAME
 
# Qt applications
QT_QPA_PLATFORM=wayland APP_NAME
QT_QPA_PLATFORM=xcb APP_NAME  # Force X11

Partage/enregistrement d’écran non disponible

Wayland empêche les applications d’accéder directement au contenu de l’écran. Le partage d’écran doit passer par xdg-desktop-portal.

# Confirm the portal service is running
systemctl --user status xdg-desktop-portal
systemctl --user status xdg-desktop-portal-gnome
 
# Restart the portal service
systemctl --user restart xdg-desktop-portal

Lors du partage d’écran dans un navigateur, assurez-vous d’utiliser un navigateur prenant en charge PipeWire (Firefox et Chrome le prennent en charge).

Les outils de bureau à distance ne fonctionnent pas

Certains outils de bureau à distance (tels que TeamViewer, AnyDesk) peuvent rencontrer des problèmes sous Wayland :

# Use GNOME built-in remote desktop
# Settings > System > Remote Desktop
 
# Or install Wayland-compatible VNC
sudo apt install gnome-remote-desktop

Les raccourcis clavier globaux ne fonctionnent pas

Wayland ne permet pas aux applications d’écouter les événements globaux du clavier (restriction de sécurité).

Solutions :

• Utilisez la configuration des raccourcis clavier dans les paramètres GNOME
• Certaines applications (telles que Flameshot) doivent enregistrer des raccourcis clavier via les interfaces D-Bus/portail

Problèmes de presse-papiers

Le Presse-papiers peut ne pas fonctionner dans différentes applications sous Wayland :

# Install wl-clipboard tools
sudo apt install wl-clipboard
 
# Copy
echo "content" | wl-copy
 
# Paste
wl-paste

Problèmes de méthode de saisie

# Confirm the input method framework
# Fcitx5 (recommended)
sudo apt install fcitx5 fcitx5-chinese-addons
 
# Set environment variables
# Add to /etc/environment:
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitx

Applications électroniques

De nombreuses applications Electron (VS Code, Slack, etc.) doivent activer la prise en charge d’Wayland :

# Add launch parameters
code --enable-features=UseOzonePlatform --ozone-platform=wayland
 
# Or modify the Exec line in the .desktop file
# Add --ozone-platform=wayland

Lorsque vous avez besoin d’une session X.org

À partir de Ubuntu 26.04, la session de bureau Ubuntu par défaut (GNOME) est Wayland uniquement : l’écran de connexion n’offre plus d’option “GNOME sur Xorg” et WaylandEnable=false dans /etc/gdm3/custom.conf ne prend plus effet. Si une application doit réellement s’exécuter sur un serveur natif X.org, vous avez deux options :

Option 1 : installer un autre bureau fournissant une session X.org

KDE Plasma, Xfce, MATE, i3 et les ordinateurs de bureau similaires proposent toujours des sessions X.org. Après en avoir installé un, choisissez sa session X.org dans le menu d’engrenage dans le coin inférieur droit de l’écran de connexion :

# Choose one
sudo apt install kubuntu-desktop   # KDE Plasma (includes Plasma on X11)
sudo apt install xubuntu-desktop   # Xfce (X.org session)
sudo apt install ubuntu-mate-desktop

Option 2 : utilisez X11 dans cette session de bureau

Une fois connecté à l’une des sessions X.org ci-dessus, les outils X11 tels que xrandr, xdotool et xclip fonctionnent normalement. Dans le cadre de la session GNOME, vous devez plutôt utiliser les outils natifs Wayland (paramètres wl-clipboard, ydotool, GNOME, etc.).

XWayland

XWayland est la couche de compatibilité X11 sous Wayland. La plupart des applications X11 s’exécuteront automatiquement via XWayland.

# Check if a window is running through XWayland
# Install xprop
sudo apt install x11-utils
xprop | grep -i xwayland
# If you can select the window, it is running on XWayland

Dans GNOME, appuyez sur Alt+F2 et tapez lg (Looking Glass). Sous l’onglet Windows, vous pouvez voir si chaque fenêtre utilise XWayland.

NVIDIA et Wayland

Les utilisateurs de GPU NVIDIA doivent s’assurer :

# Driver version 535 or higher
nvidia-smi | grep "Driver Version"
 
# Confirm GBM backend is enabled
ls /usr/lib/x86_64-linux-gnu/libnvidia-egl-gbm.so*
 
# Add to /etc/environment (if needed)
# GBM_BACKEND=nvidia-drm
# __GLX_VENDOR_LIBRARY_NAME=nvidia

Référence rapide sur la compatibilité des applications