# @capgo/cordova-updater 中文文档

规范地址：https://npmcn.com/package/%40capgo/cordova-updater/

版本：8\.2\.12
npm 元数据更新时间：2026-11-02T13:19:04.797Z
中文译文更新时间：2026-11-09T18:45:36.438Z
软件包许可：MPL-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40capgo/cordova-updater
原文对照：https://npmcn.com/package/%40capgo/cordova-updater/?lang=original
项目主页：https://capgo.app/docs/plugins/updater/
源码仓库：https://github.com/Cap-go/cordova-updater

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

- 包体积（解压后）：1.7 MB，85 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-09-23T15:56:49.576Z
- 最新版本发布：2026-11-02T13:19:04.478Z
- 近 30 天下载量：1869（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

Capgo 的 Live 更新 Cordova 插件

## 安装

```sh
npm install @capgo/cordova-updater
```

也可以使用：`pnpm add @capgo/cordova-updater`、`yarn add @capgo/cordova-updater`、`bun add @capgo/cordova-updater`

## README

# @capgo/cordova-updater (英语)

[![Capgo - Cordova Updater - Instant updates for Cordova](https://capgo.app/readme-banner.svg?repo=Cap-go/cordova-updater)](https://capgo.app/)

[![Discord](https://badgen.net/badge/icon/discord?icon=discord&label)](https://discord.com/invite/VnYRvBfgA6)

[![npm](https://img.shields.io/npm/dm/@capgo/cordova-updater)](https://www.npmjs.com/package/@capgo/cordova-updater) [![GitHub latest commit](https://badgen.net/github/last-commit/Cap-go/cordova-updater/main)](https://github.com/Cap-go/cordova-updater/commit/) [![https://good-labs.github.io/greater-good-affirmation/assets/images/badge.svg](https://good-labs.github.io/greater-good-affirmation/assets/images/badge.svg)](https://good-labs.github.io/greater-good-affirmation) [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=Cap-go_cordova-updater&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=Cap-go_cordova-updater) [![Bugs](https://sonarcloud.io/api/project_badges/measure?project=Cap-go_cordova-updater&metric=bugs)](https://sonarcloud.io/summary/new_code?id=Cap-go_cordova-updater) [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=Cap-go_cordova-updater&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=Cap-go_cordova-updater) [![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=Cap-go_cordova-updater&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=Cap-go_cordova-updater) [![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=Cap-go_cordova-updater&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=Cap-go_cordova-updater) [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=Cap-go_cordova-updater&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=Cap-go_cordova-updater) [![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=Cap-go_cordova-updater&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=Cap-go_cordova-updater) [![Open Bounties](https://img.shields.io/endpoint?url=https%3A%2F%2Fconsole.algora.io%2Fapi%2Fshields%2FCapgo%2Fbounties%3Fstatus%3Dopen)](https://console.algora.io/org/Capgo/bounties?status=open) [![Rewarded Bounties](https://img.shields.io/endpoint?url=https%3A%2F%2Fconsole.algora.io%2Fapi%2Fshields%2FCapgo%2Fbounties%3Fstatus%3Dcompleted)](https://console.algora.io/org/Capgo/bounties?status=completed)

## [QQ 与 Capgo 为您的 App 即时更新](https://capgo.app/?ref=plugin_cordova_updater)

用于 Cordova 插件 [队长](https://capgo.app/) 实时更新(OTA). Ship JavaScript,HTML,以及CSS更新到Cordova Android和iOS应用,无需等待应用商店审查.

已经使用 `@capgo/capacitor-updater`? 吗? 这个插件映射出相同的JavaScript API,并使用相同的Capgo Cloud后端,通道,和捆绑签名模型——为Cordova所改编.

## 为什么是Cordova更新器?

Cordova apps在商店发行之间仍然需要快速网络资产交付. `@capgo/cordova-updater` 把Capgo的回滚安全OTA模型带到了Cordova,而不首先迁移到Capacitor.

-   **相同的 API** - 打电话 `notifyAppReady()`, (中文(简体) ), `download()`, (中文(简体) ), `next()`,通道 API,和与表层相同的统计钩 `@capgo/capacitor-updater`
-   **本地计划支持** – Hooks Cordova的路径和计划处理器,因此下载了捆绑来取代现代Cordova Android和iOS上的WebView内容
-   **Capgo 云准备好了** 上传捆绑 `@capgo/cli`,按频道推出,并从您用于 Capacitor apps 的同一仪表板上监测领养情况
-   **后退保护** ——自动还原已破损的更新以保持应用程序的稳定
-   **三角洲更新** — 只下载更改后的文件以更快更新
-   **开源** ——自宿或自用 [笼罩云](https://capgo.app/),可以完全控制您的更新基础设施

适合立即修复bugs,A/B测试功能,并维持对遗留的 Cordova 堆栈的释放时间表的控制.

## 文档

这里有最完整的医生: [https://capgo.app/docs/plugins/cordova-updater/ (中文(简体) )](https://capgo.app/docs/plugins/cordova-updater/)

## 兼容性

| 平台 | 最小版本 |
| --- | --- |
| 科多瓦语Name | 12岁以上 |
| 科多娃·安卓尔 | 13岁以上 |
| 科尔多瓦iOS | 7个+ |

> **说明:** JavaScript API 镜像 [`@capgo/capacitor-updater`](https://github.com/Cap-go/capacitor-updater)。Web不支持——桌面/电子应用程序应当使用 [`@capgo/electron-updater`](https://github.com/Cap-go/electron-updater)。 。 。 .

## 安装

```bash
cordova plugin add @capgo/cordova-updater --variable APP_ID=<your-capgo-app-id>
```

### 插件变量

| 变量 | 默认 | 说明 |
| --- | --- | --- |
| `APP_ID` | (空虚) | Capgo 应用程序标识 |
| `DEFAULT_CHANNEL` | (空虚) | 默认更新通道 |
| `UPDATE_URL` | `https://plugin.capgo.app/updates` | 更新检查终点 |
| `CHANNEL_URL` | `https://plugin.capgo.app/channel_self` | 频道 API 端点 |
| `STATS_URL` | `https://plugin.capgo.app/stats` | 状态终点 |
| `AUTO_UPDATE` | `atBackground` | 自动更新模式 |
| `PUBLIC_KEY` | (空虚) | 签名捆绑的 RSA 公钥 |
| `APP_READY_TIMEOUT` | `10000` | 回滚超时( 毫秒) |

见 `plugin.xml` 用于完整首选项列表(与 Capacitor 更新器相匹配).

## 使用量

插件会曝光 `cordova.plugins.Updater` 之后 `deviceready`数字 :

```javascript
document.addEventListener('deviceready', async () => {
  const { Updater } = cordova.plugins;

  await Updater.notifyAppReady();

  const { bundles } = await Updater.list();
  console.log('Downloaded bundles', bundles);

  const { bundle } = await Updater.current();
  console.log('Current bundle', bundle);
});
```

有 npm 包件的 Script 类型船 :

```typescript
import type { UpdaterPlugin } from '@capgo/cordova-updater';

declare const cordova: { plugins: { Updater: UpdaterPlugin } };
```

## 网络视频要求

Cordova Android 13和iOS 7通过自定义计划为WebView服务(`https://localhost/` 财务报告和审定财务报表 `app://localhost/`) (中文(简体) ). 插件钩子 `CordovaPluginPathHandler` (机器人)和 `CDVPluginSchemeHandler` (iOS)服务下载的捆绑.

执行 **没有** 使用情况 `cordova-plugin-ionic-webview` ——绕过克多瓦的计策处理器和OTA捆绑将不适用.

## 发展

```bash
bun install
bun run build
bun run verify          # Android tests + iOS compile + TypeScript build
bun run native:contract # Native contract tests (shared with capacitor-updater)
```

### 示例应用程序

```bash
bun run build
cd example-app
npm install
npx cordova build android   # or cordova build ios
```

示例将插件与 repo 根连接(`spec=".."` 内 `config.xml`. Cordova 注射剂 `cordova.plugins.Updater` 通过 `plugin.xml` —— 不需要手动脚本标记 `www/index.html`。 。 。 .

大师E2E流生活在 `.maestro/` (从 `capacitor-updater`; 调整 `scripts/maestro/*` 一旦在设备/模拟器上运行示例.

## 许可证

MPL - 2.0 导弹

## 常见问题

### @capgo/cordova-updater 是什么？

Capgo 的 Live 更新 Cordova 插件

### 如何安装 @capgo/cordova-updater？

在项目目录运行 npm install @capgo/cordova-updater，或使用 pnpm add / yarn add / bun add。

### @capgo/cordova-updater 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @capgo/cordova-updater 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @capgo/cordova-updater 可以商用吗？

@capgo/cordova-updater 使用 MPL-2\.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。

### @capgo/cordova-updater 的下载量有多少？

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

### @capgo/cordova-updater 还在维护吗？

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