如何在单仓库中创建Homebrew Tap并适配brew-test-bot？

1. 明确指定Formula路径与Tap根地址 #

brew-test-bot默认扫描仓库根目录的Formula目录，但monorepo场景下需显式指定目标公式文件和Tap仓库地址，避免bot找不到测试对象。修改GitHub Actions中的调用命令：

• 单公式场景：

  brew-test-bot --root-url=https://github.com/你的用户名/你的仓库 Formula/你的公式文件名.rb
  

• 多公式场景：

  brew-test-bot --root-url=https://github.com/你的用户名/你的仓库 Formula/*.rb
  

--root-url参数用于告知bot当前Tap的仓库位置，配合具体Formula文件路径，可精准定位测试包。

2. 修正Formula文件的关键配置 #

确保Formula.rb符合Homebrew规范，避免因配置错误导致识别失败：

• 源码地址url需指向monorepo的正式归档（如GitHub Release生成的tarball），禁止使用相对路径
• head字段需指向仓库Git地址：

  head "https://github.com/你的用户名/你的仓库.git", branch: "main"
  

• 公式类名必须与文件名一致，例如文件名为hello-world.rb，类名需为class HelloWorld < Formula

3. 调整GitHub Actions Workflow配置 #

完善Workflow步骤，确保Homebrew环境正确识别你的Tap：

jobs:
  build-and-test:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - uses: Homebrew/actions/setup-homebrew@master
      - name: Tap target repo
        run: brew tap 你的用户名/你的仓库 https://github.com/你的用户名/你的仓库.git
      - name: Update Homebrew
        run: brew update
      - name: Execute brew-test-bot
        run: brew-test-bot --root-url=https://github.com/你的用户名/你的仓库 Formula/hello-world.rb
        env:
          HOMEBREW_GITHUB_API_TOKEN: ${{ secrets.GITHUB_TOKEN }}

• HOMEBREW_GITHUB_API_TOKEN用于授权bot将构建好的bottles上传至仓库Releases，需确保GitHub Token拥有repo权限
• 提前执行brew tap操作，让环境关联你的仓库作为合法Tap源

4. 本地预验证流程 #

推送Workflow前，先在本地验证流程可行性：

• 本地关联Tap：brew tap 你的用户名/你的仓库 ./
• 安装测试：brew install hello-world，确认软件可正常编译安装
• 模拟bot测试：brew-test-bot --dry-run Formula/hello-world.rb，提前排查配置问题

5. 自动更新Bottle信息 #

brew-test-bot构建bottles后会生成对应的bottle配置块，将该内容手动更新到Formula文件中，后续用户安装时即可直接下载预编译bottles，无需本地编译。

内容的提问来源于stack exchange，提问作者brendan