# @capawesome/capver 中文文档

规范地址：https://npmcn.com/package/%40capawesome/capver/

版本：0\.1\.5
npm 元数据更新时间：2026-07-14T13:04:13.531Z
中文译文更新时间：2026-11-09T05:21:19.100Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40capawesome/capver
原文对照：https://npmcn.com/package/%40capawesome/capver/?lang=original
项目主页：https://capawesome.io/
源码仓库：https://github.com/capawesome-team/capver

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：88.6 kB，32 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：6 个
- 首次发布：2025-09-01T20:47:35.607Z
- 最新版本发布：2026-07-14T13:04:13.252Z
- 近 30 天下载量：7792（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 5 个）

## 中文简介

在跨多平台的Capacitor项目中管理版本的CLI.

## 安装

```sh
npm install @capawesome/capver
```

也可以使用：`pnpm add @capawesome/capver`、`yarn add @capawesome/capver`、`bun add @capawesome/capver`

## README

# 顶点

[![npm version](https://img.shields.io/npm/v/@capawesome/capver)](https://www.npmjs.com/package/@capawesome/capver) [![npm downloads](https://img.shields.io/npm/dm/@capawesome/capver)](https://www.npmjs.com/package/@capawesome/capver) [![license](https://img.shields.io/npm/l/@capawesome/capver)](https://github.com/capawesome-team/capver/blob/main/LICENSE)

在跨多平台的Capacitor项目中管理版本的CLI.

[![Deliver Live Updates to your Capacitor app with Capawesome Cloud](https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1)](https://cloud.capawesome.io/)

## 特征

-   📱 **电容本地化**:专门为Capacitor项目和工作流程所设计.
-   🤖 **机器人**:全Android平台支持与build.gradle集成.
-   🍎 **iOS系统**:通过Xcode项目集成完成iOS平台支持.
-   🌐 **网页**: 以 package.json 集成完成网络平台支持.
-   🖥️ **电子**齐全 [电子平台](https://capawesome.io/docs/sdks/capacitor/electron/) 支持电子/包装.json集成.
-   ⬆️ **自动增加**:容易增量的主要,次要,补丁,和热补丁版本.
-   🔧 **热补**:支持在移动平台上进行热修版本.
-   ⚙️ **可配置图案**: 自定义构建数字模式以适应您的项目需要.
-   🩺 **健康检查**: 验证跨平台版本与内置诊断的一致性.
-   🎯 **简单使用**: 有直观 CLI 接口的简单命令.
-   ✅ **完全测试**: 可靠运行的全面测试覆盖.

## 安装

可以通过 npm 在全球安装 CLI :

```bash
npm install -g @capawesome/capver
```

## 配置

您可以自定义 CLI 的行为, 添加一个 `capver` 区域 `package.json`。 。 。 .

### 图案

这个 `pattern` 字段允许您定义构建数字的格式。 以下是示例配置:

```json
{
  "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` 命令.

```bash
npx @capawesome/capver <command> [options]
```

```bash
# 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
```

## 图标

### 起来

从所有相关文件中获取应用程序的版本 .

```bash
npx @capawesome/capver get
```

此命令在所有平台上显示当前版本并验证它们同步.

### 设定

在所有相关文件中设置应用程序的版本 .

```bash
npx @capawesome/capver set <version>
```

**参数 :**

-   `version` - 格式版本 `major.minor.patch` (例如, `1.2.3`(中文(简体) )

### 主要

在所有相关文件中增加应用程序的主要版本.

```bash
npx @capawesome/capver major
```

增加主要版本编号(例如:, `1.2.3` → `2.0.0`) (中文(简体) ).

### 小声

在所有相关文件中增加小版本的应用程序 .

```bash
npx @capawesome/capver minor
```

增加小版本编号(例如, `1.2.3` → `1.3.0`。最大值取决于您配置的模式.

### 补丁

在所有相关文件中增加该应用程序的补丁版本.

```bash
npx @capawesome/capver patch
```

增加补丁版本编号(例如, `1.2.3` → `1.2.4`。最大值取决于您配置的模式.

### 热补丁

在所有相关文件中增加该应用的热fix版本.

```bash
npx @capawesome/capver hotfix
```

增加移动平台(iOS/Android只限)的热补版. 最大值取决于您配置的模式 .

### 同步

在所有相关文件的所有平台中设置最高版本号.

```bash
npx @capawesome/capver sync
```

同步所有平台使用在任何平台上发现的最高版本.

### 医生

打印调试所需的信息.

```bash
npx @capawesome/capver doctor
```

显示系统信息,包括Node.js、国家预防机制、CLI版本和OS细节.

## 帮助

具有指挥文件的CLI 舰只,可与 `--help` 旗帜.

```bash
npx @capawesome/capver --help
```

## 一体化

### 提交和标签版本

这个 [承诺和对抗版本](https://www.npmjs.com/package/commit-and-tag-version) 软件包提供自动版本、更改日志生成和使用常规承诺的 Git 标记。 你可以把它与 `@capawesome/capver` CLI用于无缝版本体验. 只要在您的配置中添加以下配置 `package.json`数字 :

```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` 以自动折叠版本,更新所有相关文件,并实现修改.

## 发展

运行以下命令开始开发 :

1.  清除仓库 :
    
    ```bash
    git clone https://github.com/capawesome-team/capver.git
    ```
    
2.  安装依赖性 :
    
    ```bash
    npm install
    ```
    
3.  运行您的第一个命令 :
    
    ```bash
    npm start -- --help
    ```
    
    **说明:** 这个 `--` 需要将参数传递给脚本.
    

## 更改日志

见 [变化](https://npmcn.com/package/%40capawesome/capver/CHANGELOG.md)。 。 。 .

## 许可证

见 [自由主义](https://npmcn.com/package/%40capawesome/capver/LICENSE.md)。 。 。 .

## 常见问题

### @capawesome/capver 是什么？

在跨多平台的Capacitor项目中管理版本的CLI\.

### 如何安装 @capawesome/capver？

在项目目录运行 npm install @capawesome/capver，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 capver，可以用 npx capver 直接运行。

### @capawesome/capver 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/capawesome\_\_capver 是否存在。

### @capawesome/capver 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @capawesome/capver 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @capawesome/capver 可以商用吗？

@capawesome/capver 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @capawesome/capver 的下载量有多少？

根据 npm 官方下载统计，@capawesome/capver 在 2026/10/09 – 2026/11/07 这 30 天内被下载 7,792 次，日均约 260 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @capawesome/capver 还在维护吗？

最新版本 0\.1\.5 发布于 2026/07/14（3 个月前）；至今共发布 11 个版本，其中过去 12 个月发布了 5 个；首次发布于 2025/09/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。