Linux软件打包零基础教程：Debian制作与开源项目实践指南

本文将手把手教你如何为开源项目wiliwili制作Debian软件包（.deb格式安装文件），让这款专为手柄控制设计的B站客户端能够在Linux系统上轻松安装使用。通过跨平台应用打包技术，即使是零基础用户也能快速掌握软件封装的核心流程，告别繁琐命令行操作，5分钟上手开源项目打包。

一、需求分析：为什么需要制作Debian软件包？

💡 实用技巧：Debian软件包是Linux系统中最常用的安装格式之一，能够自动处理依赖关系和文件部署，大幅降低用户的安装门槛。

1.1 项目背景与目标

wiliwili是一款专为手柄控制设计的第三方跨平台B站客户端，支持PC全平台、PSVita、PS4和Nintendo Switch等设备。为Linux系统制作Debian软件包，可实现：

• 简化用户安装流程
• 标准化文件部署路径
• 自动处理系统依赖
• 支持系统级别的卸载与更新

1.2 核心需求清单

需求类型	具体要求	重要性
功能完整性	包含所有可执行文件和资源	★★★★★
系统兼容性	支持主流Debian衍生系统	★★★★☆
安装便捷性	一键安装，自动配置	★★★★☆
图标显示	支持桌面环境图标显示	★★★☆☆
架构适配	支持amd64/arm64主流架构	★★★☆☆

图1：wiliwili客户端主界面展示，支持手柄控制的B站内容浏览

知识点卡片

核心概念：Debian软件包（.deb）是一种归档格式，包含应用程序文件、配置文件和安装脚本，通过dpkg工具管理，能自动处理文件权限、依赖关系和系统集成。

二、环境配置：零基础搭建打包工作站

2.1 必备工具安装

🔧 操作步骤：在终端执行以下命令安装打包工具链

sudo apt update && sudo apt install -y \
    build-essential \
    dpkg-dev \
    dh-make \
    cmake \
    git

2.2 项目文件准备

🔧 操作步骤：获取wiliwili源代码

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

2.3 官方资源速查表

资源类型	文件路径	作用
桌面文件	scripts/linux/cn.xfangfang.wiliwili.desktop	定义桌面环境启动项
图标脚本	scripts/linux/gen_icons.sh	生成多尺寸应用图标
控制文件	scripts/deb/switchroot-bionic/control	定义软件包元数据
构建脚本	scripts/build_mac.sh	提供编译流程参考

⚠️ 注意事项：确保系统已安装所有编译依赖，包括libmpv-dev、libsdl2-dev等多媒体相关库。

知识点卡片

核心概念：dpkg-dev工具集包含构建Debian软件包所需的所有组件，其中dpkg-deb负责打包，dh-make用于生成debian目录结构，build-essential提供基础编译环境。

三、核心流程：手把手教学Debian打包实战

3.1 应用程序构建

🔧 操作步骤：编译wiliwili可执行文件

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

# 生成Makefile
cmake .. -DPLATFORM_DESKTOP=ON -DCMAKE_BUILD_TYPE=Release

# 并行编译（nproc获取CPU核心数）
make -j$(nproc)

💡 实用技巧：添加-DCMAKE_INSTALL_PREFIX=/usr参数可指定安装路径，便于后续打包。

3.2 打包目录结构搭建

🔧 操作步骤：创建标准Debian打包目录

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

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

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

文件树结构可视化：

wiliwili-deb/
├── DEBIAN/              # 包元数据目录
│   ├── control          # 包信息与依赖
│   ├── postinst         # 安装后脚本
│   └── prerm            # 卸载前脚本
└── usr/
    ├── bin/             # 可执行文件
    │   └── wiliwili
    ├── share/
    │   ├── applications/ # 桌面入口
    │   │   └── cn.xfangfang.wiliwili.desktop
    │   └── icons/       # 应用图标
    │       └── hicolor/
    │           ├── 16x16/apps/
    │           ├── 24x24/apps/
    │           └── ...(其他尺寸)

3.3 图标资源处理

🔧 操作步骤：生成并安装应用图标

# 生成多尺寸图标
cd scripts/linux
chmod +x gen_icons.sh
./gen_icons.sh

# 安装图标到打包目录
for size in 16 24 32 48 64 128 256; do
    mkdir -p ../../wiliwili-deb/usr/share/icons/hicolor/${size}x${size}/apps/
    cp icons/${size}x${size}/cn.xfangfang.wiliwili.png \
       ../../wiliwili-deb/usr/share/icons/hicolor/${size}x${size}/apps/
done
cd -

3.4 控制文件配置

🔧 操作步骤：创建Debian控制文件

cat > wiliwili-deb/DEBIAN/control << EOF
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
EOF

⚠️ 注意事项：根据目标架构修改Architecture字段（amd64/arm64），并确保Depends列表与系统版本匹配。

3.5 软件包生成

🔧 操作步骤：构建.deb文件

# 设置文件权限
chmod -R 755 wiliwili-deb/usr
chmod 644 wiliwili-deb/DEBIAN/control

# 生成deb包
dpkg-deb --build wiliwili-deb

成功后将生成wiliwili-deb.deb文件，可通过dpkg -i wiliwili-deb.deb安装。

知识点卡片

核心概念：Debian软件包采用特定的目录结构，其中DEBIAN目录包含控制信息，而其他目录对应系统安装路径，打包时会将这些文件映射到目标系统的相应位置。

四、问题解决：避坑指南与常见错误排查矩阵

4.1 编译错误排查

错误类型	典型症状	解决方案
依赖缺失	编译时提示"xxx.h: No such file or directory"	安装对应的-dev包，如libmpv-dev
架构不匹配	"wrong ELF class: ELFCLASS32"	确保所有依赖库与目标架构一致
CMake配置错误	"Could NOT find SDL2"	使用-DSDL2_DIR指定库路径
编译中断	"error: ‘xxx’ was not declared in this scope"	检查编译器版本，更新到支持C++17的版本

💡 实用技巧：使用dpkg-checkbuilddeps命令可检查编译依赖是否完整。

4.2 打包错误排查

错误类型	典型症状	解决方案
控制文件错误	"parse error in control file"	检查control文件格式，确保字段正确
权限问题	"permission denied"	使用chmod设置正确权限，目录755，文件644
架构不匹配	"package architecture (amd64) does not match system (arm64)"	修改control文件中的Architecture字段
依赖冲突	"unmet dependencies"	调整Depends列表，确保依赖版本兼容

⚠️ 注意事项：打包前务必使用lintian wiliwili-deb.deb检查软件包是否符合Debian规范。

知识点卡片

核心概念：Lintian是Debian软件包检查工具，能发现潜在问题如权限错误、依赖问题和元数据不一致，是提高软件包质量的重要工具。

五、扩展应用：跨架构适配与自动化打包

5.1 跨架构适配指南

架构	编译参数	依赖差异	注意事项
amd64	-DARCH=x86_64	标准x86库	大多数PC系统
arm64	-DARCH=arm64	armhf/arm64库	树莓派、ARM开发板

🔧 操作步骤：交叉编译arm64版本

# 添加arm64架构支持
sudo dpkg --add-architecture arm64
sudo apt update

# 安装arm64依赖
sudo apt install -y libmpv-dev:arm64 libsdl2-dev:arm64

# 交叉编译
mkdir -p build-arm64 && cd build-arm64
cmake .. -DPLATFORM_DESKTOP=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER=aarch64-linux-gnu-gcc
make -j$(nproc)

5.2 自动化打包脚本

💡 实用技巧：创建打包脚本package_deb.sh实现一键打包

#!/bin/bash
set -e

# 编译应用
mkdir -p build && cd build
cmake .. -DPLATFORM_DESKTOP=ON -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)
cd ..

# 准备打包目录
PKG_DIR=wiliwili-deb
rm -rf $PKG_DIR
mkdir -p $PKG_DIR/DEBIAN
mkdir -p $PKG_DIR/usr/{bin,share/applications,share/icons/hicolor}

# 复制文件
cp build/wiliwili $PKG_DIR/usr/bin/
cp scripts/linux/cn.xfangfang.wiliwili.desktop $PKG_DIR/usr/share/applications/

# 处理图标
scripts/linux/gen_icons.sh
for size in 16 24 32 48 64 128 256; do
    mkdir -p $PKG_DIR/usr/share/icons/hicolor/${size}x${size}/apps/
    cp scripts/linux/icons/${size}x${size}/cn.xfangfang.wiliwili.png \
       $PKG_DIR/usr/share/icons/hicolor/${size}x${size}/apps/
done

# 创建控制文件
cat > $PKG_DIR/DEBIAN/control << EOF
Section: video
Priority: optional
Maintainer: Your Name <[e-mail]>
Version: 1.5.2-1
Homepage: https://xfangfang.github.io/wiliwili/
Package: wiliwili
Architecture: $(dpkg --print-architecture)
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
EOF

# 构建deb包
dpkg-deb --build $PKG_DIR
echo "Package created: $(realpath $PKG_DIR.deb)"

5.3 软件包测试与分发

🔧 操作步骤：测试软件包

# 本地安装测试
sudo dpkg -i wiliwili-deb.deb

# 检查安装完整性
dpkg -L wiliwili

# 运行应用
wiliwili

# 卸载测试
sudo dpkg -r wiliwili

知识点卡片

核心概念：交叉编译是在一种架构上生成另一种架构可执行文件的技术，通过指定交叉编译器和架构参数，可实现为不同平台构建软件包，是跨平台开发的关键技术。

总结

通过本文的零基础实战指南，你已掌握Linux系统下Debian软件包的制作流程，包括环境配置、应用编译、打包构建和问题排查等核心技能。无论是为手柄控制B站客户端wiliwili还是其他开源项目制作软件包，这些知识都能帮助你简化用户安装流程，提高项目可用性。

记住，优秀的软件包不仅要包含正确的可执行文件，还需要考虑系统兼容性、依赖管理和用户体验。通过自动化脚本和持续集成，你可以进一步提高打包效率和质量，让开源项目更易于被广大用户接受和使用。

祝你在开源项目打包的道路上越走越远！