Linux软件包制作：wiliwili Debian打包完整指南

开源项目打包是跨平台应用部署的关键环节，本文将以wiliwili手柄控制B站客户端为例，详细介绍Linux系统下Debian软件包的制作流程，帮助开发者快速实现应用的标准化分发。

需求分析：明确打包目标与环境

应用特性解析

wiliwili作为第三方B站客户端，需处理视频播放、手柄交互等核心功能，打包需确保依赖库完整、资源文件正确部署。项目中与Linux打包相关的关键文件包括：

• 桌面入口配置（scripts/linux/cn.xfangfang.wiliwili.desktop）
• 图标生成脚本（scripts/linux/gen_icons.sh）
• Debian控制模板（scripts/deb/switchroot-bionic/control）

环境依赖快速检查

建议优先安装以下工具链：

sudo apt update && sudo apt install -y dpkg-dev dh-make cmake g++

执行完成后，通过dpkg-deb --version验证工具是否就绪。

环境配置：构建前的准备工作

源码获取与目录结构

推荐采用git克隆项目源码：

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

项目中scripts/linux目录包含所有Linux平台相关配置文件，建议优先熟悉该目录结构。

编译环境配置验证

创建专用构建目录并生成Makefile：

mkdir -p build && cd build
cmake .. -DPLATFORM_DESKTOP=ON -DCMAKE_BUILD_TYPE=Release

出现"Configuring done"提示表示环境配置成功，接下来可进行编译。

核心流程：模块化打包步骤

1. 应用程序编译

执行编译命令：

make -j$(nproc)

效果：在build目录生成wiliwili可执行文件，大小约8-12MB。

2. 资源文件准备

🔧 生成多尺寸图标：

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

效果：在icons目录下生成16x16至256x256共7种尺寸的图标文件。

3. Debian包结构搭建

创建标准打包目录树：

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

将编译产物与资源文件按以下路径复制：

• 可执行文件 → usr/bin/
• 桌面文件 → usr/share/applications/
• 图标文件 → usr/share/icons/hicolor/[尺寸]/apps/

图1：wiliwili Debian软件包目录结构示意图（含应用主界面预览）

4. 控制文件配置

复制并修改控制文件：

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

关键修改项：

• Architecture: 改为实际架构（如amd64）
• Depends: 调整为当前系统依赖（如libssl3替换libssl1.1）

5. 软件包生成

执行打包命令：

dpkg-deb --build wiliwili-deb

--build参数用于指定打包根目录，完成后生成wiliwili-deb.deb文件。

图2：wiliwili Debian打包流程与应用功能展示

问题诊断：常见错误排查

依赖冲突解决

错误现象	解决方案
依赖库版本不匹配	使用aptitude search libssl查找兼容版本
架构不匹配	重新编译时指定-DCMAKE_SYSTEM_PROCESSOR=amd64
图标不显示	执行update-icon-caches /usr/share/icons/hicolor

打包验证建议

完成后建议进行安装测试：

sudo dpkg -i wiliwili-deb.deb

检查应用启动、功能完整性及桌面图标显示情况，确保打包质量。

通过以上流程，可实现wiliwili在Debian系统的标准化打包。建议定期更新控制文件中的依赖项，以适应不同Linux发行版的版本变化。