MaaAssistantArknights Homebrew Tap

这是一个用于安装 MaaAssistantArknights (MAA) 相关软件的 Homebrew Tap。

This is a Homebrew Tap for installing MaaAssistantArknights (MAA) related software.

如何安装包 (How do I install these formulae and casks?)

推荐使用完整包名安装，这会仅信任所安装的包。例如安装 maa-cli 或 maa@beta：

Install and trust a specific package using its fully qualified name:

brew install maaassistantarknights/tap/maa-cli
brew install --cask maaassistantarknights/tap/maa@beta

如果希望使用短名称，先添加 tap 并信任对应的包：

To use a short name, tap the repository and trust the specific package first:

brew tap maaassistantarknights/tap
brew trust --formula maaassistantarknights/tap/maa-cli
brew install maa-cli

Cask 使用 brew trust --cask。详见 Homebrew Tap Trust。

For casks, use brew trust --cask. See Homebrew Tap Trust.

可用软件 (Available software)

Formulae

• maa-cli: MAA 命令行工具 (MAA CLI tool)。
• maa-cli-beta: MAA 命令行工具的测试版本 (Beta version for MAA CLI tool)。

预编译 bottle (Prebuilt bottle)

由于 Homebrew 不支持交叉编译，且由于 GitHub Action runner 支持有限，目前只提供部份平台的预编译 bottle。

Due to the limitation of Homebrew and GitHub Action runner, we only provide prebuilt bottle for some platforms.

操作系统 (OS)	处理器架构 (Architecture)
macOS 26 (Tahoe)	aarch64 (Apple Silicon)
macOS 15 (Sequoia)	aarch64 (Apple Silicon)
macOS 14 (Sonoma)	aarch64 (Apple Silicon)
Linux	x86_64

Casks (only for macOS)

• maa@beta: MAA macOS 图形界面的测试版本 (Beta version of MAA macOS GUI)，稳定版本请直接安装 maa (install maa for stable version)。
• playcover-maa: 用于 MAA 的 PlayCover 分支（MAA Fork of PlayCover）。

开发者指引 (Developer guide)

CI 提供了自动化的构建和发布功能，当你添加或者更新了一个 Formula 并提交 PR 后 CI 会自动测试并构建对应的 bottle。 当构建成功后，你可以向 PR 添加 Automerge 标签，CI 会自动将 PR 合并到 main 分支，发布 bottle 到 GitHub Release 并更新 Formula 内 bottle 的内容。 注意，请不要直接通过 Github 的 Merge 按钮合并 PR，否则 CI 无法自动发布 bottle。

对于 Cask，由于不需要构建，请直接通过 Merge 按钮合并 PR。对于 Cask 推荐使用 Squash and Merge 功能以减少历史记录。