Wayland Kompatibilitätsprobleme

Wayland Übersicht

Ubuntu 26.04 verwendet standardmäßig das Anzeigeprotokoll Wayland. Wayland ist sicherer und effizienter als X11, bei einigen älteren Anwendungen können jedoch Kompatibilitätsprobleme auftreten.

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

Häufige Kompatibilitätsprobleme

Anwendungsfenster sind verschwommen oder die Skalierung ist abnormal

Einige X11-Anwendungen können unter XWayland verschwommen erscheinen (insbesondere auf Bildschirmen mit hoher DPI).

# 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

Bildschirmfreigabe/-aufzeichnung nicht verfügbar

Wayland verhindert, dass Anwendungen direkt auf Bildschirminhalte zugreifen. Die Bildschirmfreigabe muss über das xdg-desktop-portal erfolgen.

# 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

Stellen Sie bei der Bildschirmfreigabe in einem Browser sicher, dass Sie einen Browser verwenden, der PipeWire unterstützt (sowohl Firefox als auch Chrome unterstützen dies).

Remotedesktop-Tools funktionieren nicht

Bei einigen Remote-Desktop-Tools (z. B. TeamViewer, AnyDesk) können unter Wayland Probleme auftreten:

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

Globale Hotkeys funktionieren nicht

Wayland erlaubt Anwendungen nicht, globale Tastaturereignisse abzuhören (Sicherheitseinschränkung).

Lösungen:

• Verwenden Sie die Konfiguration der Tastaturkürzel in den GNOME-Einstellungen
• Einige Anwendungen (z. B. Flameshot) müssen Hotkeys über D-Bus-/Portalschnittstellen registrieren

Probleme mit der Zwischenablage

Die Zwischenablage funktioniert unter Wayland möglicherweise nicht in verschiedenen Anwendungen:

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

Probleme mit der Eingabemethode

# 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

Elektronenanwendungen

Viele Electron-Anwendungen (VS Code, Slack usw.) müssen die Unterstützung für Wayland aktivieren:

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

Wenn Sie eine X.org-Sitzung benötigen

Ab Ubuntu 26.04 ist die standardmäßige Ubuntu Desktop-Sitzung (GNOME) nur Wayland: Der Anmeldebildschirm bietet nicht mehr die Option „GNOME auf Xorg“ und WaylandEnable=false in /etc/gdm3/custom.conf wird nicht mehr wirksam. Wenn eine Anwendung wirklich auf einem nativen X.org-Server ausgeführt werden muss, haben Sie zwei Möglichkeiten:

Option 1: Installieren Sie einen anderen Desktop, der eine X.org-Sitzung bereitstellt

KDE Plasma, Xfce, MATE, i3 und ähnliche Desktops bieten weiterhin X.org-Sitzungen. Wählen Sie nach der Installation eine X.org-Sitzung aus dem Zahnradmenü in der unteren rechten Ecke des Anmeldebildschirms aus:

# 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: Verwenden Sie X11 innerhalb dieser Desktop-Sitzung

Sobald Sie sich bei einer der oben genannten X.org-Sitzungen angemeldet haben, funktionieren X11-Tools wie xrandr, xdotool und xclip normal. Unter der Sitzung GNOME sollten Sie stattdessen native Wayland-Tools verwenden (Einstellungen wl-clipboard, ydotool, GNOME usw.).

XWayland

XWayland ist die Kompatibilitätsschicht X11 unter Wayland. Die meisten X11-Anwendungen werden automatisch über XWayland ausgeführt.

# 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

Drücken Sie in GNOME Alt+F2 und geben Sie lg (Looking Glass) ein. Auf der Registerkarte „Windows“ können Sie sehen, ob jedes Fenster XWayland verwendet.

NVIDIA und Wayland

NVIDIA GPU-Benutzer müssen Folgendes sicherstellen:

# 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

Kurzreferenz zur Anwendungskompatibilität