3步打造专业级Debian包：wiliwili手柄客户端打包实战

副标题：新手友好的Linux打包指南，零障碍构建跨架构软件包

wiliwili作为专为手柄控制设计的跨平台B站客户端，支持多设备运行。本文将详细介绍如何在Linux系统中为wiliwili制作Debian软件包，通过"核心价值→环境配置→流程拆解→问题解决→进阶优化"的框架，帮助开发者高效完成"wiliwili Linux打包"工作。

🚀 核心价值：为什么选择Debian打包

Debian软件包（.deb）是Linux系统中广泛使用的软件分发格式，具有以下核心优势：

• 依赖管理：自动处理软件依赖关系，确保应用正常运行
• 标准化安装：遵循Linux文件系统规范，便于系统管理
• 版本控制：支持版本追踪和升级管理
• 跨发行版兼容：可在Debian、Ubuntu及其衍生系统上使用

wiliwili采用Debian打包后，用户可通过简单的dpkg -i命令完成安装，大幅降低使用门槛。

图1：wiliwili客户端主界面展示，手柄优化的UI设计

🛠️ 环境配置：打包前的准备工作

开发环境要求

• 操作系统：Debian 10+/Ubuntu 18.04+
• 基础工具：build-essential、cmake、git
• 打包工具：dpkg-deb、dh-make、fakeroot

安装依赖命令

sudo apt update && sudo apt install -y build-essential cmake git dpkg-deb dh-make fakeroot

[!TIP] 不同Linux发行版的依赖包名称可能存在差异，建议根据实际系统调整安装命令。

源码获取

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

🔨 流程拆解：Debian包构建三步法

① 准备阶段：项目结构解析

wiliwili项目中与Linux打包相关的核心文件模块如下：

功能模块	路径	作用
桌面入口	scripts/linux/cn.xfangfang.wiliwili.desktop	定义桌面快捷方式
图标资源	scripts/linux/icons/	应用图标文件
图标生成	scripts/linux/gen_icons.sh	生成多尺寸图标
打包配置	scripts/deb/switchroot-bionic/	Debian控制文件模板

② 构建环节：编译应用程序

# 创建构建目录
mkdir -p build && cd build

# 生成Makefile (桌面平台)
cmake .. -DPLATFORM_DESKTOP=ON -DCMAKE_BUILD_TYPE=Release

# 并行编译
make -j$(nproc)

[!TIP] 编译过程中如遇依赖缺失，需根据错误提示安装相应的开发库，如libmpv-dev、libsdl2-dev等。

③ 打包操作：构建Debian软件包

1. 准备打包目录结构

# 创建deb包目录结构
mkdir -p wiliwili-deb/DEBIAN
mkdir -p wiliwili-deb/usr/{bin,share/applications,share/icons/hicolor}

2. 复制文件到对应位置

# 复制可执行文件
cp build/wiliwili wiliwili-deb/usr/bin/

# 复制桌面文件
cp scripts/linux/cn.xfangfang.wiliwili.desktop wiliwili-deb/usr/share/applications/

# 生成并复制图标
cd scripts/linux && ./gen_icons.sh
cp -r icons/* wiliwili-deb/usr/share/icons/hicolor/

3. 创建控制文件 在wiliwili-deb/DEBIAN/control中添加以下内容：

Section: video
Priority: optional
Maintainer: Your Name <[e-mail]>
Version: 1.5.2-1
Homepage: https://xfangfang.github.io/wiliwili/
Package: wiliwili
Architecture: amd64
Depends: libass9, libdbus-1-3, libx11-6, libv4l-0, libpulse0, libuchardet0, libwebp6, libssl1.1
Description: A third-party Bilibili client designed specifically for controller users

4. 构建deb包

dpkg-deb --build wiliwili-deb

🔄 跨架构适配：多平台打包策略

架构差异对照表

架构	编译参数	依赖调整	注意事项
amd64	-DARCH=x86_64	标准依赖	大部分PC平台
arm64	-DARCH=arm64	添加armhf依赖	Raspberry Pi等单板机
armhf	-DARCH=armhf	调整库版本为armhf	32位ARM设备

交叉编译示例（amd64→armhf）

# 安装交叉编译工具链
sudo apt install -y gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf

# 交叉编译
mkdir -p build-arm && cd build-arm
cmake .. -DPLATFORM_DESKTOP=ON -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_C_COMPILER=arm-linux-gnueabihf-gcc \
  -DCMAKE_CXX_COMPILER=arm-linux-gnueabihf-g++
make -j$(nproc)

[!TIP] 交叉编译时需确保所有依赖库都已安装对应架构版本，可使用apt-get install <package>:armhf指定架构。

🐞 问题解决：常见打包错误及修复

依赖问题

错误表现：dpkg: dependency problems prevent configuration of wiliwili
解决方法：

1. 使用dpkg-shlibdeps自动分析依赖：

dpkg-shlibdeps -O wiliwili-deb/usr/bin/wiliwili

2. 将输出结果添加到control文件的Depends字段

权限问题

错误表现：permission denied
解决方法：确保所有文件权限正确，可使用以下命令修复：

chmod -R 755 wiliwili-deb/usr/bin
chmod 644 wiliwili-deb/usr/share/applications/*
chmod 644 wiliwili-deb/usr/share/icons/hicolor/*/*/*.png

✨ 进阶优化：提升软件包质量

deb包校验技巧

1. ** lintian检查**：

lintian wiliwili-deb.deb

2. 安装测试：

sudo dpkg -i wiliwili-deb.deb

3. 文件列表检查：

dpkg -c wiliwili-deb.deb

版本控制规范

遵循语义化版本控制（Semantic Versioning）：

• 主版本号：重大功能更新（1.0.0 → 2.0.0）
• 次版本号：新增功能（1.1.0 → 1.2.0）
• 修订号：bug修复（1.1.0 → 1.1.1）

在control文件中使用Version: 主.次.修订-发行号格式，如1.5.2-1。

不同Linux发行版依赖差异

发行版	依赖差异	适配建议
Debian 10	libssl1.1	无需额外处理
Debian 11	libssl3	更新control文件依赖
Ubuntu 20.04	同Debian 10	共享control文件
Ubuntu 22.04	libssl3	单独维护control文件

[!TIP] 可使用条件语句在打包脚本中自动适配不同发行版，或为特定发行版创建独立的control文件。

通过以上步骤，您已掌握wiliwili的Debian打包全过程。从环境配置到跨架构适配，从问题解决到进阶优化，本文提供了一套完整的打包方案。无论是新手还是有经验的开发者，都能通过这套流程构建出专业级的Debian软件包，让更多Linux用户体验到这款优秀的手柄控制B站客户端。