使用brew安装历史版本的几种方式

背景

在 mac osx 下, 大部分的软件都是使用 homebrew 进行管理的, 可以方便的进行软件的安装,更新,删除等等, 大部分情况下 homebrew 的仓库只会存在一份最新的软件版本, 有时可能也会同时存在多个版本, 比如 python 就会有多个.

在有些情况下我们可能需要安装某些软件的历史版本, 接下来提供几种方式实现.

Homebrew 术语说明

在安装历史版本介绍之前, 先简单介绍一下 Homebrew 的一些名词术语及结构, 以便大家能更好的理解, Homebrew 中文可以翻译成 "家酿", 所以这个软件是对酒相关的一个抽象. 主要的结构包括:

Formula ( 配方 )

: 主要使用 ruby 文件描述的软件信息, 包含软件基本信息, 依赖, 编译等等. 如 /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core/Formula/foo.rb

Tap ( 酒吧 )

: 所有 Formula 或命令的 Git 仓库, 比如: /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core 对应 https://github.com/Homebrew/homebrew-core 仓库.
我们平时使用 brew update 就是使用同步 Tap 对应分支的更新. 使用 brew install formula 也是从所有的 tap 中查找formula 安装.

Bottle ( 酒瓶 )

: 基于对应操作系统已编译好的二进制包, 可以直接使用, 在 rb 文件中会描述各个版本的二进制. 使用二进制包可以省去自己编译. 如: qt-4.8.4.catalina.bottle.tar.gz

Cask ( 木酒桶 )

: 用于描述和安装 macOs 原生 app 软件, 使用 brew cask 安装就和使用 dmg 安装到 Applications 一样的效果.

Keg ( 小桶 )

: 描述的是一个已安装的软件版本路径, 如: /usr/local/Cellar/foo/0.1

Cellar ( 酒窖 )

: 所有已安装软件的存储仓库路径, 如: /usr/local/Cellar

理解上面的一些概念后, 其实要安装历史版本的话, 我们只需要拿到历史版本的 formula 就可以安装了.

历史版本安装

存在多版本软件

前面说过, 有的软件在 homebrew 的仓库会存在多个版本, 我们可以直接指定相应的版本进行安装, 我们可以使用 brew search 查询下要安装的软件的版本.

➜  brew search python

# output
==> Formulae
ipython                           python-markdown                   python@3.11 ✔                     cython
micropython                       python-tabulate                   python@3.7
pr0d1r2/python2/python@2.7.17 ✔   python-tk@3.10                    python@3.8 ✔
ptpython                          python-tk@3.11                    python@3.9 ✔

如上有很多 python 的其它版本, 如: python@3.7, python@3.8 等. 我们使用 brew install 指定版本安装.

➜ brew install python@3.7

# output
Running `brew update --auto-update`...

无多版本软件

对于 tap 中无多版本的软件, 我们可以通过在 tap 对应的 git 仓库中查看历史 formula 版本, 通过下载到本地进行安装.

先通过 https://formulae.brew.sh/ 找到软件信息, 如我需要找到 folly 的历史版本, 可按照下面的步骤.

历史版本的 .rb 文件保存到本地之后, 可以使用 brew install 安装. 如:

# 在 .rb 文件保存的目录执行
# 需要先删除原始版本的链接再进行安装
brew unlink folly
brew install folly.rb

这种方式安装有些情况下会出现安装失败, 比如我下载了一个 13.0.1_1 llvm.rb 文件安装:

➜  brew install -s llvm.rb
Running `brew update --auto-update`...
==> Auto-updated Homebrew!
Updated 1 tap (homebrew/core).
==> Fetching llvm
==> Downloading https://github.com/llvm/llvm-project/releases/download/llvmorg-13.0.1/llvm-project-13.0.1.src.tar.xz
==> Downloading from https://objects.githubusercontent.com/github-production-release-asset-2e65be/75821432/e556705d-3a90-49f1-909f-c1c5e
######################################################################## 100.0%
...

Warning: llvm 15.0.6 is available and more recent than version 13.0.1_1.

Error: An exception occurred within a child process:
  NoMethodError: undefined method `user' for nil:NilClass

上面会出现 ruby 的执行错误, NoMethodError: undefined method 'user' for nil:NilClass, 问题的原因是 llvm.rb 中使用了 tap.user 等变量, 而这些变量来自于当前 formula 对应 tap 的 git 仓库信息, 而你下载的 rb 文件是没有放在仓库中.

# llvm.rb 信息

-DPACKAGE_VENDOR=#{tap.user}
-DBUG_REPORT_URL=#{tap.issues_url}
-DCLANG_VENDOR_UTI=org.#{tap.user.downcase}.clang

解决办法就是修改 llvm.rb 信息, 把变量的值直接写成固定值. 如: tap.user 为 "Homebrew", tap.issues_url 为 "https://github.com/Homebrew/homebrew-core/issues", tap.user.downcase 为 "homebrew".

另外一个解决方案就是把下载的 llvm.rb 文件覆盖到 tap 对应的仓库中原文件. 如:

# 进入到本地默认 tap 仓库
cd $(brew --repository homebrew/homebrew-core)/Formula

# 把 llvm.rb 文件覆盖到此仓库原文件
mv ~/Downloads/llvm.rb llvm.rb

# 安装
brew install llvm

安装完成后, 记得在仓库中还原这个文件.

References

• https://docs.brew.sh/Formula-Cookbook
• https://rubydoc.brew.sh/Tap.html#user-instance_method