5分钟上手wiliwili Linux打包：手柄控制B站客户端的Debian软件包制作指南

wiliwili作为专为手柄控制设计的跨平台B站客户端，支持PC、PSVita、PS4和Nintendo Switch等设备。本文将通过"需求分析→环境配置→核心流程→问题诊断"四阶段框架，帮助开发者快速掌握Linux系统下的Debian软件包制作方法，解决跨平台软件打包过程中的关键技术问题。

一、需求分析：明确Linux打包核心目标

1.1 软件包功能验证清单

在开始打包前，需确认wiliwili的核心功能在Linux环境中可正常运行，包括：

• 手柄控制交互响应
• 视频播放与弹幕显示
• 网络请求与数据加载
• 本地资源文件访问

可通过直接运行编译后的二进制文件进行功能测试，确保基础功能正常后再进入打包流程。

1.2 目标系统兼容性评估

Debian软件包需考虑不同发行版的兼容性，重点关注：

• 最低系统版本要求（推荐Debian 10+/Ubuntu 18.04+）
• 架构支持（amd64/arm64）
• 依赖库版本差异（如libssl、libmpv等）

二、环境配置：零基础快速搭建打包环境

2.1 系统兼容性验证三步法

1. 检查系统版本：

lsb_release -a  # 确认Debian/Ubuntu版本
uname -m        # 确认系统架构

2. 验证内核版本：

uname -r        # 推荐5.4.0以上内核

3. 检查基础工具链：

dpkg --version  # 确保dpkg版本>=1.19.0

2.2 依赖自动安装脚本

创建自动化安装脚本install_deps.sh，包含所有必要工具：

#!/bin/bash
# 安装打包工具
sudo apt update && sudo apt install -y \
    build-essential cmake dpkg-dev dh-make \
    libass-dev libmpv-dev libcurl4-openssl-dev \
    libssl-dev libwebp-dev libsdl2-dev

保存后执行：chmod +x install_deps.sh && ./install_deps.sh

三、核心流程：Debian软件包制作全解析

3.1 三步完成目录结构搭建

1. 创建标准打包目录：

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

2. 生成多尺寸图标：

cd scripts/linux
chmod +x gen_icons.sh
./gen_icons.sh  # 生成16x16至256x256尺寸图标

3. 复制图标到目标目录：

cp -r icons/* wiliwili-deb/usr/share/icons/hicolor/

3.2 编译与安装二进制文件

1. 编译应用程序：

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

2. 安装可执行文件：

cp wiliwili wiliwili-deb/usr/bin/
chmod +x wiliwili-deb/usr/bin/wiliwili

3.3 构建Debian控制文件

创建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, libmpv1, libcurl4, libssl1.1, libwebp6, libsdl2-2.0-0
Description: A third-party Bilibili client designed for controller users

3.4 生成最终Debian软件包

dpkg-deb --build wiliwili-deb

验证方法：file wiliwili-deb.deb 应显示"Debian binary package (format 2.0)"

四、问题诊断：新手常见误区解析

4.1 依赖关系错误排查

常见症状：安装时提示"依赖关系未满足"
解决方法：

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

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

2. 根据输出更新control文件的Depends字段

4.2 图标不显示问题

常见原因：图标路径或权限错误
验证方法：

update-icon-caches /usr/share/icons/hicolor/
xdg-icon-resource list --size 64 wiliwili

4.3 架构不匹配问题

避免方法：编译时明确指定架构：

cmake .. -DCMAKE_CXX_FLAGS="-m64"  # 强制64位编译

五、进阶技巧：提升打包成功率的三个关键策略

5.1 使用Docker构建环境隔离

利用项目提供的Dockerfile创建一致的构建环境：

cd scripts/deb/switchroot-bionic
docker build -t wiliwili-build .
docker run -v $PWD:/work wiliwili-build

5.2 版本号自动管理

在control文件中使用变量替换版本号：

sed -i "s/Version:.*/Version: $(git describe --tags)/" DEBIAN/control

5.3 测试自动化

创建测试脚本验证软件包完整性：

dpkg -i wiliwili-deb.deb
wiliwili --version  # 检查版本输出

图：wiliwili客户端在Linux系统中的运行界面，展示了视频推荐和播放功能

通过以上步骤，您可以快速掌握wiliwili的Linux打包技术。建议定期查看项目的scripts/deb目录获取最新打包配置，确保软件包与应用程序保持同步更新。