统一的版本管理工具,支持UniApp、UniBest、微信小程序等多种项目类型的版本号更新
npm install @itriton/version统一的版本管理工具,支持UniApp、UniBest、微信小程序等多种项目类型的版本号更新。
- 🚀 支持多种项目类型:UniApp、UniBest、微信小程序
- 🔍 自动检测并更新所有相关文件,不存在的文件会自动跳过
- 📦 支持语义化版本和日期版本两种versionCode生成模式
- 🛠️ 统一的CLI接口,易于使用
- 📝 完整的TypeScript类型支持
- 🔧 支持自定义版本号
``bash全局安装
npm install -g @itriton/version
使用方法
$3
`bash
全局安装
npm install -g @itriton/version基本用法
itriton-version patch # 补丁版本更新
itriton-version minor # 次版本更新
itriton-version major # 主版本更新
itriton-version custom 2.0.0 # 自定义版本号指定versionCode模式
itriton-version patch date # 使用日期versionCode
itriton-version minor semantic # 使用语义化versionCode (默认)
`$3
`bash
无需安装,直接使用npx
npx @itriton/version patch
npx @itriton/version minor date
npx @itriton/version major
npx @itriton/version custom 2.0.0
`$3
`json
{
"scripts": {
"update:version": "npx @itriton/version patch",
"update:version-patch": "npx @itriton/version patch date",
"update:version-minor": "npx @itriton/version minor date",
"update:version-major": "npx @itriton/version major date",
"update:version-custom": "npx @itriton/version custom date"
}
}
`然后运行:
`bash
npm run update:version
npm run update:version-patch
npm run update:version-minor
npm run update:version-major
npm run update:version-custom
`$3
`bash
次版本更新,日期versionCode
npx @itriton/version minor date自定义版本号,语义化versionCode
npx @itriton/version custom semantic 2.0.0自定义版本号,日期versionCode
npx @itriton/version custom date 2.0.0查看帮助信息
npx @itriton/version --help
`参数说明
$3
- major - 主版本号更新 (1.0.0 -> 2.0.0)
- minor - 次版本号更新 (1.0.0 -> 1.1.0)
- patch - 补丁版本号更新 (1.0.0 -> 1.0.1)
- custom - 自定义版本号$3
- semantic - 语义化版本 (基于版本号,默认)
- date - 日期版本 (年月日时)versionCode说明
- 语义化模式: 1.2.3 -> 123
- 日期模式: 2024年12月25日14时 -> 2024122514
- 最大值限制: 2147483647
- 超过限制时会自动使用最大值
支持的项目文件
工具会自动检测并更新以下文件(如果存在):
$3
- package.json - 更新version字段
- manifest.config.ts 或 src/manifest.json - 更新versionName和versionCode
- src/config/index.js - 更新VERSION常量
- .minicirc - 更新version字段$3
- package.json - 更新version字段
- manifest.config.ts - 更新versionName和versionCode
- .minicirc - 更新version字段$3
- package.json - 更新version字段
- project.miniapp.json - 更新version和versionCode字段
- miniprogram/config/index.js - 更新VERSION常量工作原理
1. 自动检测: 工具会自动扫描项目目录,查找所有可能的配置文件
2. 智能更新: 只更新存在的文件,不存在的文件会被静默跳过
3. 版本同步: 确保所有相关文件中的版本号保持一致
4. 错误处理: 提供友好的错误提示和帮助信息
开发
`bash
克隆项目
git clone
cd itriton-version安装依赖
pnpm install开发模式 (监听文件变化)
pnpm dev构建项目
pnpm build发布
pnpm build:publish
``ISC