做了一个 Homebrew 外部命令:从 GitHub Release 或直接下载地址安装任意 Mac 应用

查看 7|回复 0
作者:oxsean   
大家好,最近做了一个小工具:ghcask。
项目地址:
https://github.com/oxsean/homebrew-ghcask
网站:
https://oxsean.github.io/homebrew-ghcask-site/
它是一个 Homebrew external command ,目标是解决一个我自己经常遇到的问题:
很多 Mac 应用其实已经提供了可用的 .dmg、.zip、.tar.gz、.tgz 安装包,尤其是一些开源项目会直接放在 GitHub Releases 里,但这些应用不一定已经进入了官方 Homebrew Cask 索引。
于是平时就会变成:
[ol]
  • 打开 GitHub 或官网
  • 找最新 release
  • 判断 arm64 / x64 / universal
  • 下载 dmg 或 zip
  • 拖到 Applications
  • 后续更新继续手动重复
    [/ol]
    我希望把这类应用也尽量放回 Homebrew 工作流里,所以做了 ghcask。
    基本用法
    brew tap oxsean/ghcask
    brew ghcask install owner/repo
    比如某个 GitHub 仓库有 macOS release asset ,ghcask 会尝试:
  • 找到合适的 release
  • 选择适合当前机器架构的 macOS 安装包
  • 下载并计算 sha256
  • 推导 .app 名称
  • 生成一个本地 Homebrew cask
  • 把下载好的包移动到 Homebrew 的 cask cache
  • 最后交给 Homebrew 安装

    也支持直接 URL:
    brew ghcask install cask-name --url https://example.com/download/App.dmg
    这个主要是给那些不在 GitHub 上发布,但能拿到稳定下载地址的软件用。
    它不做什么
    这个项目不是想替代 Homebrew Cask 。
    它也不会把生成的 cask 发布到官方索引,所有生成的 cask 都只保存在本地。实际安装、重装、升级、卸载还是交给 Homebrew 处理。
    我的理解是:
  • 官方 Homebrew Cask 适合稳定、公开、可维护的应用索引
  • ghcask 更适合个人临时或长期使用的本地补充工作流

    也就是说,它解决的不是“让所有软件进入官方 cask”,而是“我自己这台机器上想用 Homebrew 管更多软件”。
    目前支持的能力
  • 从 GitHub Releases 安装
  • 从直接 package URL 安装
  • 支持 .dmg、.zip、.tar.gz、.tgz
  • 自动计算 sha256
  • 尽量自动推导 app 名称、版本和架构
  • 支持指定版本安装
  • 支持 prerelease
  • 支持 pin / unpin
  • 支持 update / outdated / upgrade
  • 支持 reinstall ,并且 direct URL 可以通过 reinstall 换 URL
  • 支持 dump / restore ,把生成的本地 cask 状态带到新机器
  • 优先使用本地已经登录的 gh,没有的话再回退到 curl

    举几个场景
    1. 某个开源 Mac App 只有 GitHub Release
    以前可能要自己去网页里找 dmg 。
    现在可以:
    brew ghcask install owner/repo
    2. 想安装某个指定版本
    brew ghcask install owner/repo --version v1.2.3
    指定版本默认会被 pin 住,后续 update 不会自动跳到最新版。
    如果以后想回到正常更新轨道:
    brew ghcask unpin cask-name
    3. 想用 prerelease
    brew ghcask install owner/repo --prerelease
    或者之后切换:
    brew ghcask reinstall cask-name --prerelease
    brew ghcask reinstall cask-name --stable
    4. 直接从 URL 安装
    brew ghcask install app-name --url https://example.com/download/App.dmg
    如果 URL 方式的软件之后要升级,可以换 URL 重新安装:
    brew ghcask reinstall app-name --url https://example.com/download/App-2.0.dmg
    5. 新机器恢复
    旧机器:
    brew ghcask dump --global --force
    新机器:
    brew tap oxsean/ghcask
    brew trust --tap oxsean/ghcask
    brew ghcask restore --global
    brew bundle
    Brewghcask.json 只保存生成的 cask 定义和 metadata ,不包含安装包和 app 本体。
    为什么不用自己写 cask ?
    当然可以自己写。
    但我自己的痛点是:很多时候只是想快速安装一个 GitHub Release 里的 dmg ,并不想为了一个私人使用的软件维护一份完整 cask 。
    ghcask 做的是把这件事自动化一点:
  • release 选择
  • asset 选择
  • sha256
  • cask 生成
  • Homebrew cache
  • 后续 update / reinstall

    最终仍然可以检查生成的 cask ,不是黑盒安装。
    欢迎大家提建议,尤其是经常用 Homebrew Cask 管 Mac 应用的朋友。
  • 您需要登录后才可以回帖 登录 | 立即注册

    返回顶部