Wayland Problemas de compatibilidad

Wayland Descripción general

Ubuntu 26.04 utiliza el protocolo de visualización Wayland de forma predeterminada. Wayland es más seguro y eficiente que X11, pero algunas aplicaciones más antiguas pueden tener problemas de compatibilidad.

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

Problemas comunes de compatibilidad

Las ventanas de la aplicación están borrosas o el escalado es anormal

Algunas aplicaciones X11 pueden aparecer borrosas en XWayland (especialmente en pantallas con 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

Compartir pantalla/grabar no disponible

Wayland impide que las aplicaciones accedan directamente al contenido de la pantalla. La pantalla compartida debe pasar por 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

Cuando comparta la pantalla en un navegador, asegúrese de utilizar un navegador que admita PipeWire (tanto Firefox como Chrome lo admiten).

Las herramientas de escritorio remoto no funcionan

Algunas herramientas de escritorio remoto (como TeamViewer, AnyDesk) pueden tener problemas en Wayland:

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

Las teclas de acceso rápido globales no funcionan

Wayland no permite que las aplicaciones escuchen eventos de teclado globales (restricción de seguridad).

Soluciones:

• Utilice la configuración de atajos de teclado en GNOME Configuración
• Algunas aplicaciones (como Flameshot) necesitan registrar teclas de acceso rápido a través de interfaces D-Bus/portal

Problemas con el portapapeles

Es posible que el portapapeles no funcione en diferentes aplicaciones bajo Wayland:

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

Problemas con el 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

Aplicaciones electrónicas

Muchas aplicaciones de Electron (VS Code, Slack, etc.) necesitan habilitar la compatibilidad con Wayland:

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

Cuando necesita una sesión X.org

A partir de Ubuntu 26.04, la sesión predeterminada de escritorio Ubuntu (GNOME) es Wayland-solo: la pantalla de inicio de sesión ya no ofrece la opción “GNOME en Xorg”, y WaylandEnable=false en /etc/gdm3/custom.conf ya no tiene efecto. Si una aplicación realmente debe ejecutarse en un servidor X.org nativo, tiene dos opciones:

Opción 1: instalar otro escritorio que proporcione una sesión X.org

KDE Plasma, Xfce, MATE, i3 y escritorios similares aún proporcionan sesiones X.org. Después de instalar uno, elija su sesión X.org en el menú de ajustes en la esquina inferior derecha de la pantalla de inicio de sesión:

# 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

Opción 2: usar X11 dentro de esa sesión de escritorio

Una vez que haya iniciado sesión en una de las sesiones X.org anteriores, las herramientas X11 como xrandr, xdotool y xclip funcionan normalmente. En la sesión GNOME, debería utilizar herramientas nativas Wayland (wl-clipboard, ydotool, Configuración GNOME, etc.).

XWayland

XWayland es la capa de compatibilidad X11 bajo Wayland. La mayoría de las aplicaciones X11 se ejecutarán automáticamente a través 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

En GNOME, presione Alt+F2 y escriba lg (Espejo). En la pestaña Windows, puede ver si cada ventana usa XWayland.

NVIDIA y Wayland

Los usuarios de GPU NVIDIA deben asegurarse de:

# 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

Referencia rápida de compatibilidad de aplicaciones