/MaaFramework

基于图像识别的跨平台软件自动化测试框架 | A cross-platform software automation testing framework based on image recognition

Primary LanguageC++GNU Lesser General Public License v3.0LGPL-3.0

LOGO

MaaFramework

✨ 基于图像识别的跨平台软件自动化测试框架 ✨

license C++ platform commit stars

简介

MaaFramework 是基于图像识别技术、运用 MAA 开发经验去芜存菁、完全重写的新一代软件自动化测试框架。

低代码的同时仍拥有高扩展性，旨在打造一款丰富、领先、且实用的开源库，助力开发者轻松编写出更好的测试程序，并推广普及。

即刻开始

最佳实践

  • MAA1999 1999 小助手
    基于全新架构的 亿韭韭韭 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

  • MAAIP 基於 MAA 框架技術的 idolypride 自動化程序
    由 Github 上最火熱的 lk99 開源套件 MaaFramework 製作

  • MAABH3 《崩坏3》小助手 | A one-click tool for the daily tasks of Honkai Impact.
    基于全新架构的 蹦蹦蹦 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

  • MAALimbusCompany 边狱公司 小助手
    基于全新架构的 边狱公司 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

  • MBA BA 小助手
    基于 MAA 全新架构的 BA 小助手。图像技术 + 模拟控制，解放双手，不再点点点！由 MaaFramework 强力驱动！

  • MAS 森空岛 小助手
    基于全新架构的 森空岛 小助手。图像技术 + 模拟控制，解放双手！由 MaaFramework 强力驱动！

生态共建

MAA 正计划建设为一类项目，而非舟的单一软件。

若您的项目依赖于 MaaFramework，我们欢迎您将它命名为 MaaXXX, MXA, MAX 等等。当然，这是许可而不是限制，您也可以自由选择其他与 MAA 无关的名字，完全取决于您自己的想法！

同时，我们也非常欢迎在上方的最佳实践列表中添加上您的项目！

许可证

MaaFramework 采用 LGPL-3.0 许可证进行开源。

开发

本地开发

  1. 下载 MaaDeps prebuilt

    python3 tools/maadeps-download.py

  2. (macOS only) 下载 fmt

    sh tools/fetch-fmt.sh

  3. 配置 cmake

    • Windows
    cmake --preset "MSVC 2022"
    • Linux / macOS
    cmake --preset "NinjaMulti"

  4. 使用 cmake 构建工程

    cmake --build build --config Release
cmake --install build --prefix install

生成的二进制及相关文件在 install 目录下

详情请参考 Build CI.

在线开发

使用 Codespaces (Dev Container) 一键配置基础开发环境 (Ninja、Cmake、g++-13)：

Open in GitHub Codespaces

随后按照 本地开发 流程进行配置

鸣谢

开发者

感谢以下开发者对 MaaFramework 作出的贡献：