Universal Wayland Session Manager 使用教程

1. 项目介绍

Universal Wayland Session Manager (UWSM) 是一个通用的 Wayland 会话管理器，旨在将独立的 Wayland 合成器包装成一组 Systemd 单元，从而提供强大的会话管理功能。UWSM 支持环境变量管理、XDG 自动启动支持、与登录会话的双向绑定以及干净的会话关闭。对于合成器来说，这是一个将 Systemd 集成和会话/XDG 自动启动管理卸载到 Systemd 管理环境中的机会。

主要功能

• Systemd 单元管理：将 Wayland 合成器包装成 Systemd 单元，实现启动、操作和关闭的自动化管理。
• 环境变量管理：在启动时准备环境变量，并在关闭时清理环境变量。
• XDG 自动启动支持：支持 XDG 自动启动应用程序，并将其放置在特定的 Systemd 切片中，以便在合成器关闭前停止。
• 双向绑定：实现登录会话与图形会话的双向绑定，确保会话的同步启动和关闭。
• 插件支持：允许通过插件调整合成器的特定行为。

2. 项目快速启动

安装依赖

在开始之前，确保系统中已安装以下依赖：

• Python 模块：xdg、dbus
• 可选依赖：waitpid（推荐）、whiptail（用于选择功能）、dmenu 类似的菜单工具（用于 uuctl 脚本）

构建和安装

1. 克隆项目：

   git clone https://github.com/Vladimir-csp/uwsm.git
   cd uwsm
   

2. 构建和安装：

   meson setup --prefix=/usr/local -Duuctl=enabled -Dfumon=enabled -Duwsm-app=enabled build
   meson install -C build
   

启动 Wayland 会话

使用以下命令启动 Wayland 会话：

uwsm start -- <compositor> [arguments]

例如，启动 Sway 合成器：

uwsm start -- sway

关闭 Wayland 会话

使用以下命令关闭 Wayland 会话：

uwsm stop

3. 应用案例和最佳实践

案例1：自动启动 Wayland 会话

在登录到虚拟控制台 1 时自动启动 Wayland 会话，可以在 shell 配置文件中添加以下内容：

if uwsm check may-start && uwsm select; then
    exec systemd-cat -t uwsm_start uwsm start default
fi

案例2：从显示管理器启动

从显示管理器（如 GDM 或 SDDM）启动 UWSM，可以在 Wayland 会话的桌面文件中配置：

[Desktop Entry]
Name=My compositor (with UWSM)
Comment=My cool compositor
Exec=uwsm start -N "My compositor" -D mycompositor -C "My cool compositor" mywm
DesktopNames=mycompositor
Type=Application

4. 典型生态项目

Sway

Sway 是一个基于 Wayland 的平铺窗口管理器，UWSM 可以与 Sway 无缝集成，提供强大的会话管理和环境变量支持。

Hyprland

Hyprland 是一个现代的 Wayland 合成器，UWSM 可以帮助 Hyprland 实现更高效的 Systemd 集成和会话管理。

Wayfire

Wayfire 是一个高度可定制的 Wayland 合成器，UWSM 可以增强其会话管理和环境变量处理能力。

通过 UWSM，这些 Wayland 合成器可以更好地集成到 Systemd 管理的环境中，提供更稳定和高效的会话管理体验。