桌面图标会优先尝试打开 switch/wiliwili.nro，如果其不存在，则尝试打开 switch/wiliwili/wiliwili.nro，如果这两个路径都不存在，则打开 hbmenu 自行选择路径。

1. 显卡驱动需要支持 OpenGL 3.2 以运行此程序
2. Linux: 对于 Linux 系统只提供 Flatpak 安装包供 Steam Deck 安装，如有其他打包需求欢迎提交完善的打包脚本
3. macOS: 欢迎 macOS 用户提交 Homebrew 安装方式到官方仓库
4. Windows: 不提供 x86 安装包，如有需求可以自行编译

补充信息：

1. 可以从 Github-Actions 下载自动构建的测试版客户端
2. 如果不知道如何从 Github-Actions 下载软件，这里是 教程
3. 你也可以从 nightly.link 免登录下载测试版 （可能不稳定）
4. Windows用户可以通过下载 debug版 来查看log
5. 自定义字体或按键图标：#38
6. 目前支持的键盘映射见：#47
7. Steam Deck 安装教程：#41
8. 从包管理安装 wiliwili: #92

• 初步完成底层基础组件、首页各类推荐视频、用户视频播放页
• 微调页面、解决播放器启动速度慢、解决播放页面退出卡顿
• 临时解决异步加载导致的空指针问题（图片异步加载某些情况还会出现问题，待修复）
• 添加番剧/影视播放、添加扫码登录、播放历史、用户收藏夹（收藏夹相关部分工作不稳定）
• 初步添加搜索
• 播放页新增分集与UP主最新投稿
• 完善视频播放页用户评论内容
• 重构图片异步加载逻辑
• 解决收藏夹、搜索页某些情况导致闪退的问题
• 完善搜索页：番剧、影视 转为竖图
• 完善播放页投稿列表：调整结构、自动加载下一页
• 播放页展示合集与推荐
• 添加动态页
• 添加视频检索页
• 完善设置页
• 弹幕相关设置
• 点赞、投币、收藏
• 拖拽调节进度
• 增加单手模式使用一个手柄来控制播放器
• NSP forwarder自动检查多个位置的nro文件，避免无法打开
• 增加设置使首页无法通过返回退出，避免误触
• 使用教程添加未指明的快捷键说明
• 重压摇杆临时快进
• 支持切换按键图标
• 应用内多语言切换
• 重构搜索页面
• 评论@显示不同颜色
• 完善评论图片
• 评论大表情包所在行增加行高
• 支持webp图片
• 搜索支持搜索用户
• 长按一键三连
• 支持个人主页
• 评论跳转进度
• 评论跳转搜索
• 评论下方的更多信息 (up主点赞等内容)
• 投票评论
• 互动视频

macOS

# macOS: install dependencies
brew install mpv webp

cmake -B build -DPLATFORM_DESKTOP=ON
make -C build wiliwili -j$(sysctl -n hw.ncpu)

Linux

不同 Linux 的编译过程或依赖可能不同，这里是一份总结：#89

欢迎在上面的链接中写出你所使用系统的编译过程供大家参考。

# Ubuntu: install dependencies
sudo apt install libcurl4-openssl-dev libmpv-dev libwebp-dev

cmake -B build -DPLATFORM_DESKTOP=ON
make -C build wiliwili -j$(nproc)

# 如果你想安装在系统路径，并生成一个桌面图标，请使用如下内容编译
cmake -B build -DPLATFORM_DESKTOP=ON -DINSTALL=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr
make -C build wiliwili -j$(nproc)
sudo make -C build install

# uninstall (run after install)
sudo xargs -a build/install_manifest.txt rm

Windows

# Windows: install dependencies (MSYS2 MinGW64)
pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake mingw-w64-x86_64-make \
  git mingw-w64-x86_64-mpv mingw-w64-x86_64-libwebp

cmake -B build -G "MinGW Makefiles" -DPLATFORM_DESKTOP=ON
mingw32-make -C build wiliwili -j$(nproc)

SDL2 （测试支持）

由于 SDL2 支持的平台更多，考虑到未来向其他平台移植，所以 wiliwili 也支持切换到 SDL2 环境构建。

⚠️：PC 平台非测试所需请不要使用此方式构建，没有经过太多的测试，且不支持 PC 系统输入法。

cmake -B build -DPLATFORM_DESKTOP=ON -DUSE_SDL2=ON
cmake --build build

Docker

docker run --rm -v $(pwd):/data devkitpro/devkita64:20230622 \
  bash -c "/data/scripts/build_switch.sh"

本地编译

# 1. 安装devkitpro环境: https://github.com/devkitPro/pacman/releases

# 2. 安装依赖
sudo dkp-pacman -S switch-glfw switch-libwebp switch-cmake switch-curl devkitA64

# 3. 安装自定义依赖
# devkitpro提供的部分依赖版本过低, 提供的 ffmpeg 无法播放网络视频
# 手动编译方法请参考：scripts/README.md
base_url="https://github.com/xfangfang/wiliwili/releases/download/v0.1.0"
sudo dkp-pacman -U \
    $base_url/switch-libass-0.17.1-1-any.pkg.tar.zst \
    $base_url/switch-ffmpeg-4.4.4-1-any.pkg.tar.zst \
    $base_url/switch-libmpv-0.35.1-1-any.pkg.tar.zst

# 4. 可选：安装依赖库 nspmini：https://github.com/StarDustCFW/nspmini
# (1). 在resources 目录下放置：nsp_forwarder.nsp (如何生成nsp见: scripts/switch-forwarder)
# (2). cmake 构建参数添加 -DBUILTIN_NSP=ON
# 按上述配置后，从相册打开wiliwili时会增加一个安装NSP Forwarder的按钮

# 5. build
cmake -B cmake-build-switch -DPLATFORM_SWITCH=ON
make -C cmake-build-switch wiliwili.nro -j$(nproc)