企业官网建设流程全解析

Solus Linux 编译安装手柄 B 站客户端 wiliwili：依赖配置到落地的完整指南

【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili

想在 Solus 上用手柄刷 B 站，wiliwili 是最顺手的方案——它专为手柄操作设计，但软件中心里没有现成包，得自己编译。这篇带你从装依赖到跑通主界面。

项目速览

wiliwili 是一个第三方 B 站客户端，支持 PC 全平台、PSVita、PS4、Xbox 与 Nintendo Switch。它基于 nanovg 自绘界面，视频部分由 mpv + FFmpeg 驱动，同时支持触屏、鼠标、键盘和手柄四种操控方式，多语言、深浅主题都内置。目标用户就是"想躺着刷 B 站"的人——电视盒子、Steam Deck、带手柄的台式机都合适。

动手之前：环境自检

动手前把这几项过一遍，比编译报错后再排查省时间：

• 系统版本：预期 Solus 桌面版、系统能正常更新。执行eopkg up -y，有异常先看输出再往下走。
• 编译器版本：项目要求 C++17（见 CMakeLists.txt 中CXX_STANDARD 17）。执行g++ --version确认在 7.0 以上；低于 7.0 就先eopkg install -y gcc-c++更新工具链，这一步卡住的人挺多的。
• 网络：预期能直连 B 站。执行curl -I https://www.bilibili.com，超时多半是 DNS 或代理问题，先解决网络再谈编译。
• 磁盘空间：代码加构建产物约 1.5 GB 起步，执行df -h ~确认主目录有 3 GB 以上余量。

部署实操

克隆 wiliwili 源码（含 borealis 子模块）

下面两条命令克隆源码并初始化子模块——UI 框架 borealis 挂在 library/borealis/，漏掉--recursive后续 cmake 会直接失败：

git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili cd wiliwili

如果已经 clone 过忘了加参数，补一句即可：

git submodule update --init --recursive

用 eopkg 安装编译工具链

Solus 的软件中心背后是 eopkg，命令行直接装依赖最可控。这条命令装编译器、make 和版本工具：

sudo eopkg install -y gcc-c++ make git

如果软件中心里看不到这些包，到 Software Center 的 Additional Repositories 里把 Solus 官方仓库打开，再回命令行重试。

安装 libmpv 与 libwebp 开发包

wiliwili 的视频播放依赖系统 libmpv，图片加载用到 libwebp（查找逻辑在 CMakeLists.txt 的find_package(MPV REQUIRED)和find_package(WebP)）：

sudo eopkg search -q 'libmpv' sudo eopkg search -q 'libwebp' sudo eopkg install -y <上面搜到的开发包名>

注意先用 search 确认实际包名，不同仓库版本里 dev 包命名可能带-dev后缀，别照抄。

配置 CMake 并生成构建目录

这条命令把构建目录定在build/，开启桌面平台模式，并通过-DINSTALL=ON让安装阶段生成桌面图标和资源（安装路径与图标清单在 scripts/linux/ 下）：

cmake -B build -DPLATFORM_DESKTOP=ON -DINSTALL=ON \ -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr

配置阶段报错时，90% 的情况是 libmpv 没装上——回上一节补依赖再重跑。

编译并安装到系统路径

先全核并行编译主程序，再安装二进制、图标和资源到/usr：

make -C build wiliwili -j$(nproc) sudo make -C build install

装完后应用菜单里会出现 wiliwili 入口，桌面文件在build/install_manifest.txt有清单，卸载时对照它删即可。

跑起来之后：验证与体验

执行启动命令做最小验证：

wiliwili

成功标志：窗口出现 B 站首页，底部状态条显示时间和 FPS，说明渲染管线已跑通。接下来插上 USB 手柄：方向键或左摇杆移动焦点，A 键确认进入视频，B 键返回；播放页长按 A / B 可快进快退，摇杆回中即可暂停。首次进入设置页确认"按键图标"样式（xbox / ps）和你的手柄对得上，避免图标误导。

踩坑速查

cmake 报Could NOT find MPV原因：libmpv 开发包没装或没找到。 解法：sudo eopkg search -q 'libmpv'找到包名后安装，再重新执行 cmake 配置。

配置阶段报 C++17 特性不可用原因：工具链过旧，CXX_STANDARD 17不被支持。 解法：sudo eopkg install -y gcc-c++更新编译器后删掉build/目录重新配置。

启动后黑屏或窗口渲染失败原因：OpenGL 版本低或显卡驱动异常，mpv 无法创建帧缓冲。 解法：重新配置时加-DMPV_NO_FB=ON（让 mpv 全屏绘制、UI 覆盖其上），老机器可再加-DMPV_SW_RENDER=ON走软渲染。

手柄接上没反应原因：SDL 手柄数据库缺你的设备条目。 解法：把gamecontrollerdb.txt放进配置目录~/.config/wiliwili/，重启应用；同时在设置里切换按键图标样式确认映射。

登录状态和设置全丢了原因：配置目录被清理。 解法：所有状态存在~/.config/wiliwili/wiliwili_config.json，删除整个~/.config/wiliwili/即可强制重置。

延伸

更多使用技巧（Anime4K 滤镜、自定义主题字体、按键重绑）看项目 Wiki；各发行版的编译差异汇总在项目 Discussions，遇到本文没覆盖的问题优先去那边搜一下。构建脚本与打包细节可参考 scripts/ 目录。

【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili