3步完成wiliwili Debian包制作：从编译到部署全攻略

wiliwili是专为手柄控制设计的第三方跨平台B站客户端，支持在Linux系统上构建Debian软件包。本文将通过模块化操作流程，帮助你快速掌握wiliwili Debian打包技术，实现从源码编译到软件部署的全流程管理，让这款Linux手柄客户端在更多设备上高效运行。

功能亮点与适用场景

wiliwili作为开源项目打包教程的优秀案例，具备三大核心优势：专为手柄优化的操作界面，支持多平台运行，以及高度可定制的构建流程。其适用场景覆盖家庭娱乐中心、游戏主机模拟器环境、客厅HTPC等多种设备形态，特别适合需要沙发操作体验的媒体消费场景。

图1：wiliwili客户端主界面，展示了手柄友好的视频内容浏览界面

环境配置与依赖检查

如何避免依赖地狱？环境检查清单

在开始打包前，需要确保系统已安装以下工具和库：

工具/库	作用	安装命令
dpkg-deb	Debian包构建工具	sudo apt install dpkg-dev
dh-make	Debian打包辅助工具	sudo apt install dh-make
cmake	跨平台构建系统	sudo apt install cmake
libass-dev	字幕渲染库	sudo apt install libass-dev
libmpv-dev	媒体播放器核心	sudo apt install libmpv-dev

项目中与Linux打包相关的关键文件：

展开查看核心文件列表

- 桌面文件：scripts/linux/cn.xfangfang.wiliwili.desktop - 图标生成脚本：scripts/linux/gen_icons.sh - Debian控制文件：scripts/deb/switchroot-bionic/control

模块化操作流程

模块一：源码编译与构建

如何获得可执行文件？编译流程详解

1. 克隆项目源码：

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

2. 创建并进入构建目录：

mkdir -p build && cd build

3. 生成Makefile并编译：

cmake .. -DPLATFORM_DESKTOP=ON -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)

⚠️ 风险提示：编译过程中如遇"MPV库未找到"错误，请检查libmpv-dev是否正确安装

模块二：资源文件准备

如何组织打包所需资源？标准化处理流程

1. 生成图标集：

cd scripts/linux
chmod +x gen_icons.sh
./gen_icons.sh

2. 准备桌面文件：

cp cn.xfangfang.wiliwili.desktop ~/wiliwili-deb/usr/share/applications/

3. 复制可执行文件：

cp ../../build/wiliwili ~/wiliwili-deb/usr/bin/

模块三：Debian包构建

如何生成可安装的deb文件？打包实操指南

1. 创建Debian包目录结构：

mkdir -p ~/wiliwili-deb/DEBIAN
mkdir -p ~/wiliwili-deb/usr/{bin,share/applications,share/icons}

2. 配置控制文件：

cp scripts/deb/switchroot-bionic/control ~/wiliwili-deb/DEBIAN/

3. 构建deb包：

dpkg-deb --build ~/wiliwili-deb

图2：wiliwili视频播放界面，展示手柄控制的媒体播放体验

常见问题诊断手册

依赖问题诊断

Q: 安装时提示"依赖关系不满足"如何解决？ A: 使用aptitude工具分析依赖链：

sudo aptitude install ./wiliwili-deb.deb

该工具会提供依赖解决方案，通常选择接受"降级"或"安装推荐包"选项即可。

架构不匹配问题

Q: 如何判断软件包架构是否匹配？ A: 使用file命令检查可执行文件架构：

file ~/wiliwili-deb/usr/bin/wiliwili

输出应包含"x86-64"（amd64）或"ARM aarch64"（arm64）等架构信息。

图标不显示问题

Q: 安装后应用图标不显示怎么办？ A: 更新图标缓存：

sudo update-icon-caches /usr/share/icons/hicolor/*

新手避坑指南

1. ⚠️ 错误操作：直接在源码目录执行make install 正确做法：使用deb包管理安装，避免文件系统污染

2. ⚠️ 错误操作：忽略架构差异直接打包 正确做法：根据目标设备选择对应架构编译，参考下方架构对比表

3. ⚠️ 错误操作：手动修改已安装的桌面文件 正确做法：修改打包前的桌面文件，重新构建deb包

跨架构适配方案

架构	适用设备	编译参数	依赖差异
amd64	台式机/笔记本	-DARCH=x86_64	libc6:i386
arm64	树莓派/ARM开发板	-DARCH=arm64	libc6:arm64

进阶优化建议

自动化打包工具推荐

1. dpkg-buildpackage：Debian官方工具，支持签名和多格式输出

   dpkg-buildpackage -us -uc -b
   

2. debhelper：自动化debian/rules文件生成

   dh_make -s -f ../wiliwili_1.0.orig.tar.gz
   

3. git-buildpackage：结合Git版本控制的打包工具

   gbp buildpackage --git-export-dir=/tmp/build
   

性能优化技巧

1. 使用-O3编译优化：

cmake .. -DCMAKE_CXX_FLAGS="-O3"

2. 启用硬件加速：

cmake .. -DENABLE_VAAPI=ON -DENABLE_VDPAU=ON

社区支持与贡献指南

遇到打包问题？可通过以下渠道获取帮助：

• 项目Issue跟踪：提交详细的错误报告和复现步骤
• 社区讨论区：分享打包经验和解决方案
• 开发者邮件列表：[e-mail]

贡献指南：

1. Fork项目仓库并创建特性分支
2. 遵循现有代码风格修改打包脚本
3. 添加详细的提交说明
4. 提交Pull Request等待审核

通过本文介绍的模块化操作流程，你已经掌握了wiliwili Debian打包的核心技术。无论是新手友好的deb制作流程，还是跨架构软件包编译技巧，都能帮助你为这款优秀的Linux手柄客户端构建高质量的安装包，让更多用户享受便捷的媒体消费体验。