从零构建可分发的Deb包：wiliwili实战指南

需求分析：为什么需要为wiliwili制作Deb包

对于Linux用户而言，一个结构完整的Debian软件包就像精心包装的礼物盒，能将应用程序及其依赖、资源文件整齐地交付到系统中。wiliwili作为专为手柄控制设计的跨平台B站客户端，通过Deb包形式分发可解决三大核心问题：简化安装流程（告别复杂的依赖手动配置）、确保文件权限标准化（避免随意放置导致的运行异常）、支持系统级别的统一管理（方便更新与卸载）。

图1：wiliwili客户端主界面，展示了视频推荐与播放功能

目标用户画像

• Linux新手用户：需要傻瓜式安装体验，避免编译依赖的困扰
• 发行版维护者：希望将wiliwili纳入第三方软件源
• 开发者：需要向测试用户快速分发更新版本

环境校验三步骤

在开始前，请确认系统满足以下条件：

1. 工具链检查：执行dpkg -l | grep "dpkg-dev\|dh-make\|cmake"确认打包工具已安装
2. 依赖库准备：安装基础编译环境sudo apt install build-essential libssl-dev libmpv-dev
3. 源码获取：git clone https://gitcode.com/GitHub_Trending/wi/wiliwili

方案设计：Deb包构建的蓝图规划

文件组织黄金法则

Debian软件包遵循严格的目录结构规范，就像图书馆的分类系统，每个文件都有其固定位置：

wiliwili-deb/
├── DEBIAN/              # 包元数据区（相当于软件的身份证）
│   ├── control          # 包含版本、依赖、架构等核心信息
│   ├── postinst         # 安装后执行脚本
│   └── prerm            # 卸载前执行脚本
└── usr/                 # 应用文件区（程序实际居住的空间）
    ├── bin/             # 可执行文件存放地
    ├── share/applications/  # 桌面快捷方式
    └── share/icons/     # 应用图标集

跨架构适配策略

架构类型	编译参数调整	依赖差异	典型应用场景
amd64	-DARCH=x86_64	libssl1.1 → libssl3	桌面PC、服务器
arm64	-DARCH=arm64	需要arm版本的mpv库	树莓派、ARM开发板

分步实施：从源码到Deb包的蜕变之旅

1. 应用程序构建

编译三阶段

1. 准备构建环境
   [环境配置] mkdir -p build && cd build

2. 生成Makefile
   [构建命令] cmake .. -DPLATFORM_DESKTOP=ON -DCMAKE_BUILD_TYPE=Release

3. 并行编译
   [编译命令] make -j$(nproc)

🔍 检查点：编译完成后确认build/wiliwili可执行文件存在且大小合理（通常大于10MB）

2. 资源文件准备

图标生成与部署

项目提供的scripts/linux/gen_icons.sh脚本可自动生成多尺寸图标：

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

生成的图标需按规范放置： [部署命令] mkdir -p wiliwili-deb/usr/share/icons/hicolor/128x128/apps/
[部署命令] cp icons/128x128/cn.xfangfang.wiliwili.png wiliwili-deb/usr/share/icons/hicolor/128x128/apps/

桌面文件配置

将scripts/linux/cn.xfangfang.wiliwili.desktop复制到应用程序目录： [部署命令] mkdir -p wiliwili-deb/usr/share/applications/
[部署命令] cp scripts/linux/cn.xfangfang.wiliwili.desktop wiliwili-deb/usr/share/applications/

3. 控制文件制作

控制文件是Deb包的核心，需包含以下关键信息：

Section: video
Priority: optional
Maintainer: Your Name <[e-mail]>
Version: 1.6.0-1
Architecture: amd64
Depends: libass9, libmpv1, libssl3, libx11-6
Description: A third-party Bilibili client for controller users

🔍 检查点：使用lintian工具验证控制文件合法性：lintian wiliwili-deb/DEBIAN/control

4. 打包与测试

生成Deb包

[打包命令] dpkg-deb --build wiliwili-deb

本地测试安装

[测试命令] sudo dpkg -i wiliwili-deb.deb

图2：wiliwili视频播放界面，展示手柄控制的交互设计

问题排查：解决打包过程中的常见障碍

常见陷阱

⚠️ 陷阱一：依赖版本不匹配
症状：安装时提示"依赖关系无法满足"
解决方案：使用apt-cache depends wiliwili检查依赖链，在control文件中指定正确版本范围（如libssl3 (>= 3.0.0)）

⚠️ 陷阱二：图标不显示
症状：安装后应用图标显示为默认问号
解决方案：执行update-icon-caches /usr/share/icons/hicolor/更新图标缓存，确保图标路径权限为644

⚠️ 陷阱三：可执行文件缺失权限
症状：运行时提示"权限被拒绝"
解决方案：打包前执行chmod +x wiliwili-deb/usr/bin/wiliwili

效率提升工具推荐

1. dh-make：自动生成Debian包骨架文件，减少手动配置工作量 [安装命令] sudo apt install dh-make
[使用命令] dh_make --createorig -p wiliwili_1.6.0

2. dpkg-buildpackage：集成化打包工具，自动处理编译、打包、签名流程 [使用命令] dpkg-buildpackage -us -uc -b

总结

通过本文介绍的四阶段构建法，我们完成了从需求分析到实际打包的完整流程。Debian软件包的制作不仅是简单的文件打包，更是对Linux系统规范的深度实践。记住：一个高质量的Deb包应该像瑞士手表一样精密——结构清晰、依赖明确、运行可靠。

对于Linux新手，建议从最小化版本开始尝试，逐步添加功能模块。遇到问题时，善用dpkg-deb --info查看包信息，dpkg -L wiliwili检查文件安装位置，这些工具将成为你排查问题的得力助手。

希望本文能帮助你顺利构建属于自己的wiliwili Debian软件包，让这款优秀的手柄控制B站客户端惠及更多Linux用户。