自动化部署
GitHub Actions 工作流
项目包含以下自动化工作流:
发布工作流 (release.yml)
触发条件:创建Git标签
- 支持完整发布:
v1.0.0 - 支持单版本发布:
v1.0.0+1.21.6 - 自动构建资源包
- 发布到GitHub Releases
代码质量检查 (lint.yml)
触发条件:推送到main/develop分支
- ESLint代码检查
- TypeScript类型检查
- 自动化测试
依赖安全检查 (dependency-check.yml)
触发条件:每周定时执行
- 检查依赖漏洞
- 生成安全报告
发布流程
1. 准备发布
确保所有翻译文件已完成并验证:
bash
pnpm run cli validate
pnpm run cli progress2. 创建标签
bash
# 完整发布(构建所有版本)
git tag v1.0.0
# 单版本发布
git tag v1.0.0+1.21.63. 推送标签
bash
git push origin v1.0.04. 自动构建
GitHub Actions将自动:
- 安装依赖
- 运行测试
- 构建资源包
- 创建Release
- 上传构建产物
部署平台
GitHub Releases
自动发布到项目的Releases页面
Modrinth(可选)
配置Modrinth API Token后可自动发布
配置环境变量
在GitHub仓库设置中添加:
MODRINTH_TOKEN- Modrinth发布令牌(可选)- 其他平台的API密钥
本地构建测试
部署前可本地测试构建:
bash
pnpm run build
pnpm run pack:all验证生成的资源包文件无误后再进行发布。