River

River 是一个动态平铺 Wayland 合成器。

注意： 在安装任何桌面环境之前，

• 确保您已连接互联网 网络。 如果测试失败，请先设置您的 互联网连接，然后再继续。
• 出于安全原因，如果您在 安装 过程中跳过了此步骤，请创建一个非特权 用户账户。
• 启用 community 仓库。
• 为您的视频硬件安装 显卡驱动。

setup-wayland-base 脚本安装并启用 elogind 作为 seat 管理器，启用 community 仓库，并自动启用 eudev，因为这些是 Wayland 工作所必需的。

安装

安装 River 和文档

# apk add river river-doc

如果您想使用示例配置，则需要 river-doc。

安装您选择的其他软件包

此列表包括图标、字体和一个名为 foot 的终端模拟器，它是 River 示例 init 文件中的默认终端，我们稍后将使用它。

# apk add adwaita-icon-theme foot font-dejavu

设置 eudev

在 Alpine Linux 桌面系统上建议设置 eudev。 如果没有功能齐全的 设备管理器，用户将无法连接到输入设备。alpine-conf 软件包提供了 setup-devd 脚本，可以轻松安装和设置设备管理器。

设置 eudev。

# setup-devd udev

有关更多详细信息和其他选项，请参阅 eudev。

安装显卡驱动

为您的视频硬件安装 显卡驱动。 如果没有正确的驱动程序，River 将无法启动。

设置 seat 管理器

Wayland 合成器需要对输入和输出设备的原始访问权限。 这由 seat 管理器 调解。

配置 seatd 或 elogind 都可以，因为两者都受支持。 但是，同时使用两者可能会导致冲突。 安装并配置 seatd 以自动启动。

运行 River

在首次运行 River 之前，将示例 init 文件复制到 ~/.config

install -Dm0755 /usr/share/doc/river/examples/init -t ~/.config/river

设置 XDG_RUNTIME_DIR，然后启动 River

river

故障排除

以下是一些注意事项，它们肯定与 River 无关，而是在运行 River 时发现的，因此我将它们添加到此 wiki 的末尾。

Firefox 89.0.1 在启动时抱怨 “glxtest: libpci missing”，通过以下方式解决

apk add pciutils-libs

Firefox 89.0.1 持续抱怨 “Unable to load hand2 from the cursor theme”，通过以下方式解决

mkdir -p ~/.icons/default ln -s /usr/share/icons/Adwaita/cursors ~/.icons/default/cursors

参见

River 简介