本仓库为 MaaFramework 所提供的项目模板,开发者可基于此模板直接创建自己的 MaaXXX 项目。
MaaFramework 是基于图像识别技术、运用 MAA 开发经验去芜存菁、完全重写的新一代自动化黑盒测试框架。 低代码的同时仍拥有高扩展性,旨在打造一款丰富、领先、且实用的开源库,助力开发者轻松编写出更好的黑盒测试程序,并推广普及。
-
使用右上角
Use this template
-Create a new repository
来基于本模板创建您自己的项目。 -
克隆本项目及子项目(地址请修改为您基于本模板创建的新项目地址)。
git clone https://github.com/MaaXYZ/MaaPracticeBoilerplate.git
-
下载 MaaFramework 的 Release 包,解压到
deps
文件夹中。 -
下载通用资源子模块(MaaCommonAssets)
git submodule update --init --recursive
请注意,子模块仓库体积较大,请确认您已经成功下载,否则后续 OCR(文字识别)将报错并无识别结果。
若 git 命令始终无法成功下载,也可尝试前往 Mirror酱 手动下载后解压到assets/MaaCommonAssets
文件夹中,目录结构为assets/MaaCommonAssets/OCR
。 -
配置资源文件。
python ./configure.py
若报错
File Not Found: XXXXXX
,则说明上一步 MaaCommonAssets 未正常下载,请再次检查! -
进行开发工作,按您的业务需求修改
assets
中的资源文件,请参考 MaaFramework 相关文档。 -
完成开发后,上传您的代码并发布版本。
# 配置 git 信息(仅第一次需要,后续不用再配置) git config user.name "您的 GitHub 昵称" git config user.email "您的 GitHub 邮箱" # 提交修改 git add . git commit -m "XX 新功能" git push origin HEAD -u
-
发布您的版本
需要先修改仓库设置
Settings
-Actions
-General
-Read and write permissions
-Save
# CI 检测到 tag 会自动进行发版 git tag v1.0.0 git push origin v1.0.0
-
更多操作,请参考个性化配置(可选)
MAA 正计划建设为一类项目,而非舟的单一软件。
若您的项目依赖于 MaaFramework,我们欢迎您将它命名为 MaaXXX, MXA, MAX 等等。当然,这是许可而不是限制,您也可以自由选择其他与 MAA 无关的名字,完全取决于您自己的想法!
同时,我们也非常欢迎您提出 PR,在 社区项目列表 中添加上您的项目!
黑框框是 git bash,几乎任何现代软件的开发都离不开 git,建议先参考 菜鸟教程 或搜索一些视频,学习完 git 后再来进行后续开发工作。
1. 我是第一次使用 Python,在命令行输入 python ./configure.py
或 python -m pip install MaaFW
之后没有反应?没有报错,也没有提示成功,什么都没有
Win10 或者 Win11 系统自带了一份 "Python",但它其实只是一个安装器,是没法用的。
你需要做的是关闭它或者删除它的环境变量,然后自己去 Python 官网下载并安装一份 Python。
参考方法
一般是电脑缺少某些运行库,请安装一下 vc_redist 。
这里是《项目模板》仓库,它仅仅是一个模板,一般很少会修改,开发者也较少关注。
在此仓库请仅提问模板相关问题,其他问题最好前往对应的仓库提出,如果有 log,最好也带上它(debug/maa.log
文件)
- MaaFW 本身及 MaaPiCli 的问题:MaaFramework/issues
- MaaDebugger 的问题:MaaDebugger/issues
- 不知道算是哪里的、其他疑问等:讨论区
请仔细阅读文档,你无视了前面步骤的报错。我不想解释了,请再把本文档仔细阅读一遍!
本项目由 MaaFramework 强力驱动!
感谢以下开发者对本项目作出的贡献(下面链接改成你自己的项目地址):