流水账-在Ubuntu 18.04中制作libfuse3 deb包

问题描述

Ubuntu 20.04在官方源中已经提供了libfuse3的deb包，然而在Ubuntu 18.04的官方源中仅有libfuse2 (2.9.7)。为了让部署起来更加方便，需要自己制作libfuse3的deb包。

制作流程

deb包的制作本身需要经历几个过程，可以参考教程 https://www.debian.org/doc/manuals/packaging-tutorial/packaging-tutorial.en.pdf。其中大致包括创建源码包(dh_make)->编译与测试(debuild)。其中最复杂的过程是dh_make->debuild之间对debian/下打包描述文件的编写过程，例如包括

debian/control：deb包的元数据，例如依赖包、版本等
debian/rules：制作本deb包的一些特殊的规则，例如描述对install, test等默认过程的附加命令

1. 源码下载

虽然libfuse社区没在开源项目中给出deb的打包规则，幸运的是deb社区给出了其打包libfuse3-3时所写的deb规则以及libfuse-3.9.0-2相应origin源码。debian社区libfuse3-3的软件包页面在： https://packages.debian.org/sid/libfuse3-3

fuse3制作deb包源码.png

debhelper提供了方便的一键下载脚本工具，只需要

dget http://deb.debian.org/debian/pool/main/f/fuse3/fuse3_3.9.0-2.dsc

就会将fuse3_3.9.0.origin.tar.xz以及fuse3_3.9.0-2.debian.tar.xz等下载到当前路径。因为只是自己用，没有签名等需求，因此在本次自制deb包过程中有用的包有fuse3_3.9.0.origin.tar.xz以及fuse3_3.9.0-2.debian.tar.xz。其中前者是源码包，后者描述打包过程。
解压完成后，目录结构如下，其中debian/解压自于fuse3_3.9.0-2.debian.tar.xz

- fuse-3.9.0/
  `- debian/
  `- doc/
  `- example/
  `- meson.build
  `- ...

2. debuild一条龙

mk-build-deps是安装编译依赖所用到的工具，他会自动生成一个二进制包，该二进制包的依赖关系与最终目标deb包编译时依赖的其他包，因此通过安装该二进制包即可一次性解决编译时的依赖问题。相关命令为

mk-build-deps --install --remove

debuild是dpkg-buildpackage, lintian, fakeroot, debsign的一条龙命令工具，如果一切顺利的话一句debuild就可以完成打包过程。然而问题是比较多的。

a. Compatibility levels

debhelper打包的过程中报错：dh: Compatibility levels before 5 are no longer supported (level 1 requested) ，造成该错误的主要原因是编译平台尚未安装用于向后移植的包，所以兼容性不符合要求。结果方式是在ubuntu 18.04上安装apt install bionic-backports。
他们的向后移植设计很巧妙，后续有时间了我一定仔细学习一下他们是如何做到向后可移植的原理。

b. pytest测试报错，包括pytest的版本问题以及libfuse test用例外部参数错误导致无法通过等问题

解决方案有两个，最简单暴力的方案就是通过设置临时环境变量跳过测试过程：

DEB_BUILD_OPTIONS=nocheck debuild -us -uc

更加正确的解决办法为，逐个定位问题解决问题。

首先是pytest版本问题，因为使用apt install python3-pytest安装的pytest版本较老导致的问题，可以通过使用pip重新安装pytest来解决，pip3 install pytest。
其次是libfuse测试用户无法通过的问题，可以看到debian的官方libfuse3-3给我们的debian/rule中使用了命令python3 -m pytest test/来执行测试，而test/test_examples.py中有使用了相对路径test/../examples/hello来调用可执行文件，但是debuild在ninja build的过程中使用的builddir为obj-x86_64-linux-gnu/，这就导致了pytest测试用例中实际用到的可执行文件并不在他期望的位置。因此在debian/rules中的override_dh_auto_test项进行如下修改：

override_dh_auto_test:
ifeq (,$(findstring nocheck,$(DEB_BUILD_OPTIONS)))
#       python3 -m pytest test/
        python3 -m pytest obj-x86_64-linux-gnu/test/
endif

c. install usr/lib//.a， File not found

在meson configure中，default_library的默认项为shared，因此libfuse并没有编译出libfuse3.a等静态链接库，这导致debhelper在根据debian/libfuse3-dev.install的过程中出错。这应该是ubuntu特有的问题，需要手动注释debian/libfuse3-dev.install中的usr/lib/*/*.a。其实正常来说如果*.a不存在，应该忽略这个错误而不应该停止。

d. fusermount3.1, File Not Found

这个问题与上一个大同小异，查看debian/tmp/usr/share/man/man1可以发现实际存在的是fusermount3.1.gz，因此手动将debian/fuse3.manpages中的manpage路径添加拓展名.gz即可。

3. 最终收尾

解决完上述问题以后，再次运行debuild -us -uc，最终能在fuse-3.9.0的平级目录得到一条龙制作完成的deb包，包括fuse3_3.9.0-2_amd64.deb，libfuse3-3_3.9.0-2_amd64.deb等。