3步完成wiliwili Debian包制作：从源码到可安装文件

本文是一份零基础开源手柄客户端Debian打包教程，将详细介绍如何将专为手柄控制设计的跨平台B站客户端wiliwili（支持PC、PSVita、PS4和Nintendo Switch等设备）制作为Debian软件包，以便在Debian及其衍生系统上轻松安装和使用。

一、核心目标：Debian打包的价值与应用场景

1.1 为什么选择Debian打包

将wiliwili制作成Debian软件包，能够为用户提供便捷的安装体验，简化依赖管理，同时便于软件的分发、更新和卸载。对于开发者而言，Debian打包可以确保软件在不同Debian衍生系统上的一致性和兼容性。

1.2 应用场景

• 为Linux用户提供便捷的wiliwili安装方式
• 在企业或组织内部进行软件分发
• 贡献开源社区，让更多人使用wiliwili

二、环境配置：系统要求与依赖准备

2.1 系统要求

• 操作系统：Debian或其衍生系统（如Ubuntu）
• 架构：amd64或arm64

2.2 工具链安装

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

作用说明：安装构建工具和Debian打包相关工具 参数解析：-y 自动回答yes

2.3 源码准备

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

三、操作矩阵：构建、打包与验证

3.1 构建应用程序

3.1.1 创建构建目录并生成Makefile

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

作用说明：创建构建目录并使用cmake生成Makefile 参数解析：-DPLATFORM_DESKTOP=ON 指定构建桌面平台版本，-DCMAKE_BUILD_TYPE=Release 指定发布版本构建

3.1.2 编译项目

make -j$(nproc)

作用说明：编译项目 参数解析：-j$(nproc) 使用所有可用CPU核心进行编译

3.1.3 成功验证

检查build目录下是否生成wiliwili可执行文件：

ls -l wiliwili

如果输出类似"-rwxr-xr-x 1 user user ... wiliwili"的信息，则构建成功。

3.2 打包 Debian 软件包

3.2.1 生成多尺寸图标集

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

作用说明：生成不同尺寸的应用图标 参数解析：无

3.2.2 成功验证

检查icons目录下是否生成多种尺寸的图标文件：

ls -l icons/*/

如果输出包含16x16、24x24、32x32等多个目录及其中的.png图标文件，则图标生成成功。

3.2.3 构建符合FHS标准的文件树

创建如下目录结构：

wiliwili-deb/
├── DEBIAN/
│   ├── control
│   ├── postinst
│   └── prerm
└── usr/
    ├── bin/
    │   └── wiliwili
    ├── share/
    │   ├── applications/
    │   │   └── cn.xfangfang.wiliwili.desktop
    │   └── icons/
    │       ├── hicolor/
    │       │   ├── 16x16/
    │       │   │   └── apps/
    │       │   │       └── cn.xfangfang.wiliwili.png
    │       │   ├── 24x24/
    │       │   │   └── apps/
    │       │   │       └── cn.xfangfang.wiliwili.png
    │       │   └── ... (其他尺寸)

使用以下命令创建目录：

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

3.2.4 复制文件到相应位置

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

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

# 复制图标
for size in 16x16 24x24 32x32 48x48 64x64 128x128 256x256; do
    mkdir -p wiliwili-deb/usr/share/icons/hicolor/$size/apps/
    cp icons/$size/cn.xfangfang.wiliwili.png wiliwili-deb/usr/share/icons/hicolor/$size/apps/
done

3.2.5 编写Debian控制文件

创建并编辑wiliwili-deb/DEBIAN/control文件：

Section: video
Priority: optional
Maintainer: xfangfang <[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

3.2.6 生成Debian软件包

dpkg-deb --build wiliwili-deb

作用说明：构建Debian软件包 参数解析：--build 指定构建软件包，后面跟软件包目录

3.2.7 成功验证

检查当前目录下是否生成.deb文件：

ls -l *.deb

如果输出类似"-rw-r--r-- 1 user user ... wiliwili-deb.deb"的信息，则打包成功。

3.3 验证软件包

3.3.1 安装软件包

sudo dpkg -i wiliwili-deb.deb

作用说明：安装Debian软件包 参数解析：-i 安装指定的软件包

3.3.2 成功验证

检查应用是否安装成功：

which wiliwili

如果输出"/usr/bin/wiliwili"，则安装成功。

3.3.3 运行应用程序

wiliwili

如果应用程序成功启动并显示主界面，则验证通过。

图：wiliwili应用主界面展示

四、跨架构适配

4.1 amd64与arm64构建对比

架构	编译参数	控制文件修改	注意事项
amd64	无需额外参数	Architecture: amd64	标准PC架构
arm64	cmake .. -DPLATFORM_DESKTOP=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER=aarch64-linux-gnu-gcc -DCMAKE_CXX_COMPILER=aarch64-linux-gnu-g++	Architecture: arm64	需要安装交叉编译工具链

4.2 交叉编译工具链安装（arm64）

sudo apt install -y gcc-aarch64-linux-gnu g++-aarch64-linux-gnu

五、问题速查：常见错误解决方案与最佳实践

5.1 常见错误解决方案

5.1.1 编译错误：缺少依赖

错误信息：类似"fatal error: xxx.h: No such file or directory" 解决方案：使用apt-file search xxx.h查找包含该头文件的包，然后安装对应的开发包。

5.1.2 打包错误：控制文件格式错误

错误信息：类似"dpkg-deb: error: control file 'wiliwili-deb/DEBIAN/control' is missing" 解决方案：检查控制文件是否存在且格式正确，确保每个字段都有正确的格式。

5.1.3 安装错误：依赖缺失

错误信息：类似"dpkg: dependency problems prevent configuration of wiliwili:" 解决方案：运行sudo apt -f install修复依赖问题。

5.2 最佳实践

[!TIP]

• 保持软件包版本号与项目版本一致，便于用户识别和更新。
• 在控制文件中准确指定依赖关系，避免用户安装后无法运行。
• 测试不同Debian版本上的兼容性，确保软件包广泛适用。
• 遵循FHS（文件系统层次结构）标准，使文件布局清晰规范。

六、打包流程

graph TD
    A[准备工作] --> B[安装依赖工具]
    A --> C[获取源码]
    B --> D[构建应用程序]
    C --> D
    D --> E[生成Makefile]
    E --> F[编译项目]
    F --> G[生成图标]
    G --> H[构建文件树]
    H --> I[复制文件]
    I --> J[编写控制文件]
    J --> K[生成Debian包]
    K --> L[安装验证]
    L --> M[完成]

通过以上步骤，您可以高效地完成wiliwili的Debian软件包制作，为Linux用户提供便捷的安装体验。希望本指南能够帮助您顺利制作和分发wiliwili Debian包，让更多用户体验这款优秀的开源手柄客户端。