顶点
在跨多平台的Capacitor项目中管理版本的CLI.
特征
- 📱 电容本地化:专门为Capacitor项目和工作流程所设计.
- 🤖 机器人:全Android平台支持与build.gradle集成.
- 🍎 iOS系统:通过Xcode项目集成完成iOS平台支持.
- 🌐 网页: 以 package.json 集成完成网络平台支持.
- 🖥️ 电子齐全 电子平台 支持电子/包装.json集成.
- ⬆️ 自动增加:容易增量的主要,次要,补丁,和热补丁版本.
- 🔧 热补:支持在移动平台上进行热修版本.
- ⚙️ 可配置图案: 自定义构建数字模式以适应您的项目需要.
- 🩺 健康检查: 验证跨平台版本与内置诊断的一致性.
- 🎯 简单使用: 有直观 CLI 接口的简单命令.
- ✅ 完全测试: 可靠运行的全面测试覆盖.
安装
可以通过 npm 在全球安装 CLI :
npm install -g @capawesome/capver
配置
您可以自定义 CLI 的行为, 添加一个 capver 区域 package.json。 。 。 .
图案
这个 pattern 字段允许您定义构建数字的格式。 以下是示例配置:
{
"name": "my-app",
"version": "1.2.3",
"capver": {
"pattern": "MMmmmpphh"
}
}
图案格式 :
M= 主要版本数字(可变长度)m= 小版本数字(固定长度)p=补丁版本数字(固定长度)h= Hotfix 版本数字(可选)
常见模式 :
MMmmmpphh(默认) - 支持最多999个小补丁,99个补丁,99个热补丁MMmmmppph- 扩展补丁支持(最多999个)MMmmpp- 没有热补丁支持
[尖叫声] 机器人的
versionCode是正整数,最大值为 2,147,483,647 (单位:千美元)默认值MMmmmpphh模式,主要版本达到此限制 215 (韩语) (例如,215.0.0将产生versionCode联 合 国2150000000) (中文(简体) ). 如果您的工程可能达到高主要版本号(例如通过自动常规承诺版本),则考虑使用一个较短的模式,如MMmmmpp提高这个上限.
使用量
CLI可以与 @capawesome/capver 命令.
npx @capawesome/capver <command> [options]
# Initialize a new Capacitor project with version 0.0.1
npx @capawesome/capver set 0.0.1
# Increment the patch version
npx @capawesome/capver patch
# Increment the minor version
npx @capawesome/capver minor
# Increment the major version
npx @capawesome/capver major
# Increment only the build number
npx @capawesome/capver hotfix
# Check version consistency across platforms
npx @capawesome/capver get
# Synchronize all platforms to use the highest version found
npx @capawesome/capver sync
图标
起来
从所有相关文件中获取应用程序的版本 .
npx @capawesome/capver get
此命令在所有平台上显示当前版本并验证它们同步.
设定
在所有相关文件中设置应用程序的版本 .
npx @capawesome/capver set <version>
参数 :
version- 格式版本major.minor.patch(例如,1.2.3(中文(简体) )
主要
在所有相关文件中增加应用程序的主要版本.
npx @capawesome/capver major
增加主要版本编号(例如:, 1.2.3 → 2.0.0) (中文(简体) ).
小声
在所有相关文件中增加小版本的应用程序 .
npx @capawesome/capver minor
增加小版本编号(例如, 1.2.3 → 1.3.0。最大值取决于您配置的模式.
补丁
在所有相关文件中增加该应用程序的补丁版本.
npx @capawesome/capver patch
增加补丁版本编号(例如, 1.2.3 → 1.2.4。最大值取决于您配置的模式.
热补丁
在所有相关文件中增加该应用的热fix版本.
npx @capawesome/capver hotfix
增加移动平台(iOS/Android只限)的热补版. 最大值取决于您配置的模式 .
同步
在所有相关文件的所有平台中设置最高版本号.
npx @capawesome/capver sync
同步所有平台使用在任何平台上发现的最高版本.
医生
打印调试所需的信息.
npx @capawesome/capver doctor
显示系统信息,包括Node.js、国家预防机制、CLI版本和OS细节.
帮助
具有指挥文件的CLI 舰只,可与 --help 旗帜.
npx @capawesome/capver --help
一体化
提交和标签版本
这个 承诺和对抗版本 软件包提供自动版本、更改日志生成和使用常规承诺的 Git 标记。 你可以把它与 @capawesome/capver CLI用于无缝版本体验. 只要在您的配置中添加以下配置 package.json数字 :
{
"version": "0.0.1",
"scripts": {
"release": "commit-and-tag-version --commit-all"
},
"commit-and-tag-version": {
"scripts": {
"postbump": "npx @capawesome/capver set $(node -p \"require('./package.json').version\") && git add android/app/build.gradle ios/App/App/Info.plist"
}
}
}
此配置确保当发布新版本时,该版本会在所有相关文件中自动更新. 走开 npm run release 以自动折叠版本,更新所有相关文件,并实现修改.
发展
运行以下命令开始开发 :
-
清除仓库 :
git clone https://github.com/capawesome-team/capver.git -
安装依赖性 :
npm install -
运行您的第一个命令 :
npm start -- --help说明: 这个
--需要将参数传递给脚本.
更改日志
见 变化。 。 。 .
许可证
见 自由主义。 。 。 .