Problemas de compatibilidade Wayland

Wayland Visão Geral

Ubuntu 26.04 usa o protocolo de exibição Wayland por padrão. Wayland é mais seguro e eficiente que X11, mas alguns aplicativos mais antigos podem ter problemas de compatibilidade.

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

Problemas comuns de compatibilidade

As janelas do aplicativo estão desfocadas ou o dimensionamento está anormal

Alguns aplicativos X11 podem parecer borrados em XWayland (especialmente em telas de alto 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

Compartilhamento/gravação de tela não disponível

Wayland restringe o acesso direto dos aplicativos ao conteúdo da tela. O compartilhamento de tela precisa passar pelo 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

Ao compartilhar a tela em um navegador, certifique-se de usar um navegador compatível com PipeWire (tanto Firefox quanto Chrome são compatíveis).

Ferramentas de área de trabalho remota não funcionam

Algumas ferramentas de área de trabalho remota (como TeamViewer, AnyDesk) podem ter problemas em Wayland:

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

As teclas de atalho globais não funcionam

Wayland não permite que aplicativos escutem eventos globais de teclado (restrição de segurança).

Soluções:

• Use a configuração de atalhos de teclado nas configurações GNOME
• Algumas aplicações (como Flameshot) precisam registrar teclas de atalho através de interfaces D-Bus/portal

Problemas na área de transferência

A área de transferência pode não funcionar em diferentes aplicativos em Wayland:

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

Problemas no método de entrada

# 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

Aplicações de elétrons

Muitos aplicativos Electron (VS Code, Slack, etc.) precisam ativar o suporte Wayland:

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

Quando você precisa de uma sessão X.org

A partir do Ubuntu 26.04, a sessão padrão do Ubuntu Desktop (GNOME) é Wayland apenas: a tela de login não oferece mais a opção “GNOME no Xorg” e WaylandEnable=false em /etc/gdm3/custom.conf não entra mais em vigor. Se um aplicativo realmente precisar ser executado em um servidor nativo X.org, você terá duas opções:

Opção 1: Instale outro desktop que forneça uma sessão X.org

KDE Plasma, Xfce, MATE, i3 e desktops semelhantes ainda fornecem sessões X.org. Depois de instalar um, escolha sua sessão X.org no menu de engrenagem no canto inferior direito da tela de login:

# 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

Opção 2: use X11 nessa sessão de desktop

Uma vez logado em uma das sessões X.org acima, ferramentas X11 como xrandr, xdotool e xclip funcionam normalmente. Na sessão GNOME, você deve usar ferramentas nativas Wayland (wl-clipboard, ydotool, configurações GNOME, etc.).

XWayland

XWayland é a camada de compatibilidade X11 em Wayland. A maioria dos aplicativos X11 serão executados automaticamente por meio de 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

Em GNOME, pressione Alt+F2 e digite lg (Espelho). Na guia Windows, você pode ver se cada janela está usando XWayland.

NVIDIA e Wayland

Os usuários da GPU NVIDIA precisam garantir:

# 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

Referência rápida de compatibilidade de aplicativos