Устранение проблем с Wayland

В GNOME на экране входа есть кнопка с шестерёнкой, которую можно использовать для входа либо в сеанс Wayland (называется просто GNOME, это вариант по умолчанию), либо в устаревший сеанс X11 (называется GNOME on Xorg). Если у вас учётная запись без пароля, вы не увидите значок шестерёнки; он отображается только при появлении приглашения ввести пароль. Используйте кнопку с шестерёнкой, чтобы определить тип сеанса, в который вы входите. Если вы хотите запустить сеанс другим способом, прочитайте продвинутые методики работы с Wayland.

В KDE есть поддержка запуска вложенного сеанса Wayland внутри сеанса X11. Вам нужно установить пакет kwin-wayland, а затем следовать этому руководству. Похоже, что в настоящий момент нет поддержки запуска полного сеанса Wayland из коробки.

Другие среды рабочего стола в настоящее время не способны запускать сеанс Wayland.

Важно знать, является ли проблемное приложение нативным приложением Wayland или работает через XWayland, который позволяет устаревшим приложениям по-прежнему работать поверх Xorg-сервера, но отображаться в сеансе Wayland.

Существует несколько способов определить, использует ли приложение Wayland или XWayland:

Если вы определили, что проблема в приложении XWayland, попробуйте воспроизвести её в стандартном сеансе X11. Если она возникает и там, это не связано с Wayland, это ошибка либо в конкретном приложении, либо в Xorg-сервере, см. How to debug Xorg problems. Если проблема возникает только под XWayland, но не в сеансе X11, о ней всё равно следует сообщать против Xorg-сервера ( пакета), потому что XWayland включён в него (как подпакет xorg-x11-server-Xwayland).

Если вы столкнулись с проблемой в приложении Wayland, очень полезно знать, присутствует ли проблема только под одним композитором (в этом случае это, вероятно, ошибка композитора) или под несколькими композиторами (в этом случае это, вероятно, ошибка приложения/инструментария).

Пожалуйста, запустите сеанс с эталонным композитором Weston и попробуйте воспроизвести проблему. Вы можете запустить Weston либо как вложенное окно, либо как полный сеанс. Сначала установите пакет (много полезной информации можно прочитать на его странице руководства):

Затем создайте файл конфигурации, который укажет, что вы хотите включить поддержку XWayland в своих сеансах weston. Создайте ~/.config/weston.ini со следующим содержимым:

[core] + xwayland=true

Теперь вы можете запустить weston либо как вложенное окно, либо как полный сеанс.

Если вы можете воспроизвести проблему с Weston, заведите задачу против приложения или его инструментария (gtk+, qt и т. д.). В противном случае заведите задачу против композитора, который использует ваша среда (mutter, kwin и т. д.). Если проблема возникает только с приложениями XWayland, но не с нативными приложениями Wayland, сообщите об ошибке против Xorg-сервера.

Прежде чем сообщать об ошибке, пожалуйста, убедитесь, что вы используете последнее доступное программное обеспечение. Убедитесь, что нет ожидающих системных обновлений:

Если они есть (и доступные обновления выглядят правдоподобно связанными с компонентами, с которыми у вас проблемы), пожалуйста, обновите систему и проверьте, сохраняется ли проблема или была исправлена.

Чтобы избежать дублирующихся отчётов, а также не тратить своё время на отладку того, что, возможно, уже кто-то отладил, пожалуйста, сначала поищите среди существующих отчётов. Наиболее заметные проблемы или опасения перечислены в Известные проблемы, частые жалобы, фундаментальные изменения. Если вы не видите её там, вам нужно искать глубже. Связанные с Wayland проблемы вы, скорее всего, найдёте здесь:

После того как вы определили, против какого компонента (скорее всего) сообщать о проблеме, и не нашли существующего отчёта о ней, есть несколько мест, где можно о ней сообщить:

При сообщении о проблеме, пожалуйста, сделайте так, чтобы ваш отчёт блокировал наш трекер, чтобы у нас была хорошая общая картина того, что сломано в разных компонентах. В вашем отчёте об ошибке установите Blocks: WaylandRelated или Blocks: KDEWaylandRelated (возможно, вам потребуется включить отображение расширенных полей, чтобы увидеть поле Blocks:). Это заставит его блокировать один из этих трекеров в зависимости от того, где вы сообщили об ошибке:

Если gnome-shell зависает и перестаёт отвечать, очень полезно получить трассировку стека его процесса и приложить её к отчёту. Если это происходит, переключитесь на другой VT, если возможно (Ctrl+Alt+F3–F7), или войдите по ssh. Сначала установите отладочные символы:

Затем присоедините отладчик gdb к вашему процессу gnome-shell:

Трассировка должна быть сохранена в файле gdb.txt.

Вы можете отлаживать mutter (используемый в gnome-shell), установив его переменные окружения. Их нужно установить до запуска gnome-shell, поэтому, если вы хотите войти в GNOME из GDM, вам нужно создать скрипт-обёртку, вызываемый из desktop-файла в /usr/share/wayland-sessions.

FIXME: Было бы полезно разместить здесь скрипт-обёртку и desktop-файл.

Невозможно запустить графические приложения под учётной записью root из терминала при использовании su или sudo. Приложения, использующие polkit для запроса прав администратора только для определённых операций и только при необходимости, не затронуты (они не запускаются как root сразу). Обсуждение лучшего подхода продолжается, см. bug 1274451 и "On running gui applications as root" thread in fedora-devel mailing list.

Опытные пользователи знакомы с широким спектром утилит, связанных с X11, таких как xkill, xrandr, xdotool, xsel. Эти инструменты не будут работать в сеансе Wayland или будут работать только с приложениями XWayland, но не с приложениями Wayland. Некоторые инструменты могут иметь замену, позволяющую выполнять аналогичные задачи.

FIXME: добавить несколько готовых к Wayland замен для популярных инструментов X11

Приложение больше не может изменить разрешение монитора. Обычно это делалось играми для повышения производительности. Игры на основе Wayland будут использовать другой подход — масштабирование своего вывода. Но для игр X11 (работающих через XWayland) это решение недоступно. Это приводит к различным типам поведения в зависимости от того, как написана игра — игра может быть зафиксирована в разрешении рабочего стола, или отображаться как маленькое центрированное изображение с чёрными полосами вокруг него, или падать при запуске, или что-то другое. См. bug 1289714.

Для некоторых игр возможным обходным решением является ручная установка пользовательского разрешения монитора перед запуском игры, если это действительно необходимо. Однако это поможет не всегда.

Одной из особенностей Wayland является его дизайн безопасности, который помогает защитить пользователя от вредоносных приложений. Приложения больше не могут видеть всё на экране и шпионить за вами. Но это также означает, что вы не можете запустить обычное приложение (например, shutter или gtk-recordmydesktop) и использовать его для создания скриншота или скринкаста рабочего стола — оно увидит только своё собственное окно, но ничего другого (или может сразу упасть). Для выполнения этих действий необходимо использовать системные (доверенные) приложения.

В GNOME вы можете использовать инструмент Screenshot (доступен в обзоре, по горячей клавише Printscreen или как команда gnome-screenshot) для создания скриншота всего рабочего стола или конкретного окна. Вы можете нажать сочетание клавиш Ctrl+Alt+Shift+R, чтобы начать видеозапись всего рабочего стола (остановите её, нажав то же сочетание клавиш снова; есть индикатор в правом верхнем углу, или она автоматически останавливается через 30 секунд по умолчанию) и найти скринкаст в ~/Videos. Для скринкаста вы также можете использовать расширение gnome-shell EasyScreenCast.

Если ваш компьютер находится под нагрузкой, движение указателя мыши может перестать быть плавным и начать тормозить (застревать на месте на короткое время, затем мгновенно перескакивать в другое место). Это, вероятно, более заметно на медленных системах/системах с меньшим числом ядер ЦП. См. bug 745032.

Существует редкая проблема, когда вы нажимаете клавишу, чтобы ввести букву, и видите несколько копий введённой буквы. См. bug 757942 и bug 777693.

Некоторые приложения перенаправляют весь ввод, включая системные клавиши/сочетания клавиш, такие как или , на удалённую систему. Это в основном просмотрщики удалённого рабочего стола, такие как vncviewer, или менеджеры виртуальных машин, такие как virt-manager или boxes. В Wayland некоторые из этих сочетаний клавиш не могут быть перехвачены и поэтому используются в хост-системе, а не в удалённой/гостевой системе. См. bug 1285770.