使用AUR(Helper)安装软件时究竟发生了什么?对于常见的构建错误如何解决?

本文最后更新于:2022年1月22日 凌晨

虽然对于没有能力手动修改/编写PKGBUILD的Arch用户其实是不应该使用AUR中的包的,这些软件的PKGBUILD可以由个人随意发布,并不能保证安全性,但是作为Archlinux的特色,但随着AUR Helper的趋于便利,还是吸引了不少小白使用AUR。本文将主要讲一讲 AUR Helper 帮助我们安装软件时到底做了些什么事情,并提供一些使用AUR Helper构建时常见错误的解决方案。

PartⅠ基本原理

makepkg是如何工作的?

以钉钉举例,我们可以从AUR上使用 git clone https://aur.archlinux.org/dingtalk-bin.git 获取到由这个包的维护者为我们提前写好的构建脚本。他的目录大概是长成下面这个样子:

1
2
3
4
5
6
7
8
dingtalk-bin
├── com.alibabainc.dingtalk.desktop
├── dingtalk.sh
├── .git
├── .gitignore
├── PKGBUILD
├── service-terms-zh
└── .SRCINFO
  • 其中,.git是git的工作目录,可以忽视。
  • .gitignore属于git的配置文件之一,我们也不用管。
  • PKGBUILD是这个目录下最重要的东西,是一个用于提供参数的脚本。makepkg通过执行PKGBUILD脚本来获取到参数,自动进行下载和构建过程。
  • service-terms-zh, com.alibabainc.dingtalk.desktop, dingtalk.sh是包里所需要用到的东西。

当我们cd到这个目录下执行makepkg时,

makepkg会调用curl / git下载PKGBUILD中source=()部分中以http(s)协议头或者git+开头的链接,这些东西将会被下载到这个目录的src文件夹下。

对于curl下载的东西,makepkg会使用校验码核对下载到的文件是否完整、是否是当初这个包的维护者下载到的这一个。

校验通过后,makepkg会依次执行prepare(){}build(){}package(){}函数中的命令陆续完成准备、编译过程,并将最终要打进包里的文件放置到pkg文件夹下。

最后,makepkg将会将pkg文件夹的内容压缩成包。

AUR Helper 干了些什么

我们还是以钉钉为例,看看我们执行yay dingtalk-bin时到底发生了什么。

当你使用yay安装软件到底发生了什么

PartⅡ常见错误解决方案

如果有其他情况觉得可以完善的,欢迎在评论区留言。

1. base-devel 没有安装

正如上面所说的,没有安装base-devel组,赶紧补上!

由于base-devel并不是一个具体的包,而是由多个包构成的包组,其实并没有很好的方法来检测你是否已经安装。

所以如果你不确定,你也可以执行下面的命令来确保自己已经安装。

1
sudo pacman -S base-devel --noconfirm --needed

常见表现:

1
ERROR: Cannot find the strip binary required for object file stripping.
1
PKGBUILD: line XXX XXX: command not found

2. source源文件下载失败

  1. 网络问题

    国内的网络问题不用多说了,大多数情况下都是Github连接不上。

    yay下载失败

    最简单的解决方案就是把source里下载失败的东西通过特殊手段(比如你浏览器设置下代理,或者找找fastgit这种反代)下载下来以后直接扔到PKGBUILD所在的路径,然后手动执行makepkg -si

    -s代表自动下载makedepend,-i表示构建成功以后自动安装

    yay存放PKGBUILD的默认路径是在$HOME/.cache/yay/$pkgname下面,具体可以参考我的另一篇关于yay的用法详解的博客。

    我在这里再讲一种使用 fastgit 作为反代加速github下载的方法。如果觉得fastgit帮助到了你,你可以考虑给fastgit项目打钱

    当你的yay出现这个询问菜单时,(也就是出现Diffs to show/显示哪些差异?字样时)

    我们再开一个终端,输入

    1
    sed -i "s|github.com|hub.fastgit.org|g" $HOME/.cache/yay/*/PKGBUILD

    接着就下一步安装即可。

  2. 链接失效

    这种情况多见于维护者维护不到位,上游放出了新版本包并删除老版本包以后维护者没有及时跟进的。你可以去逛一逛AUR的评论区查看解决方案,或者去查找上游的最新版本是多少,尝试更改PKGBUILD中的pkgver参数和checksum以后尝试makepkg。

  3. 需要手动下载

    一般情况下是上游没有提供直链,makepkg无法自行下载,需要人工介入。解决方法同上面的网络问题

3. checksum 错误

上文已经提到过,checksum用于判断你所下载到的软件和维护者当初下载到的是否一致。但是有些情况下,确实是维护者忘了更新checksum值了,因此我们需要做一个判断。

打开.SCRINFO,找到checksum报错的那个文件的链接。

使用wget/curl等工具将他下载下来,可以通过md5sum+文件名的方式获取他们的md5值。连续下载两次,核对两次的检验值是否一致。

如果结果一致,那么说明并不是网络波动导致的检验值不符,而是维护者没有及时跟进导致的,你可以使用yay -S $pkgname --skipchecksums的方式跳过验证校验值的过程,或者你可以修改PKGBUILD中的校验值为"SKIP"来跳过某一文件的校验后手动makepkg

4. tuna反代受限

tuna的服务器只有一个ip,但当使用他提供的AUR的反代服务时,全国的使用者都会被AUR认为是tuna这一个ip,过大的请求数量可能导致tuna的服务器超出AUR每天给每个ip限制的请求次数。


具体表现:

1
Rate limit reached

解决方案,改回AUR的服务器,使用自己的ip进行请求

1
yay --aururl "https://aur.archlinux.org" --save

写在最后

关于AUR使用的更多细节可以阅读 《yay进阶》


使用AUR(Helper)安装软件时究竟发生了什么?对于常见的构建错误如何解决?
https://zhul.in/2021/09/11/detailed-explanation-for-aur/
作者
竹林里有冰
发布于
2021年9月11日
更新于
2022年1月22日
许可协议