项目简介
MaaPracticeBoilerplate 是基于 Python 开发的通用实践模板项目,为开发者提供快速搭建项目框架的基础模板。该项目集成 MaaFramework,提供常用工具和模块,可帮助开发者高效进行项目开发,支持快速配置资源文件、集成 OCR 功能以及自定义开发。
项目的主要特性和功能
- 基于 MaaFramework,提供丰富工具和模块支持。
- 易于配置,通过简单脚本配置资源文件,支持自定义开发。
- 集成 OCR 功能,内置 OCR 模型配置脚本。
- 简化部署,提供安装脚本,简化依赖管理和项目部署过程。
- 支持自动化发版,通过 Git tag 自动触发 CI/CD 流程。
安装使用步骤
假设用户已下载本项目的源码文件,以下是安装和使用步骤:
步骤一:复制本项目及子项目
使用以下命令复制主项目和子项目到本地(请将地址替换为您创建的新项目地址),并使用递归方式复制子项目(添加 --recursive
参数)。
bash
注意:要完整复制子项目,确保获取所有必要的文件和文件夹。
步骤二:下载并配置 MaaFramework 依赖包
解压 Release 包到项目的 deps
文件夹中。
步骤三:配置资源文件
运行 configure.py
脚本进行资源文件的配置。
bash
python ./configure.py
可参考 MaaFramework 相关文档进行自定义配置。
步骤四:运行安装脚本
运行 install.py
脚本进行项目依赖的安装和资源的配置。
bash
python ./install.py
步骤五:完成开发工作后,提交代码并发布版本
- 配置 Git 信息(仅第一次需要):
bash
- 提交修改:
bash git add . git commit -m "XX 新功能" git push origin HEAD -u
- 发布版本:
在发布版本时,可通过给 Git 添加 tag 来实现,例如:
bash git tag v1.0.0 git push origin v1.0.0
注意:在发布版本前,请确保仓库设置中Settings
-Actions
-General
-Read and write permissions
已开启。
至此,您已成功安装并配置好 MaaPracticeBoilerplate 项目,可根据需要进行开发和部署。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】