一次性设置清单

复制一个包含安装步骤和本插件的完整Markdown指南的设置提示。

您完成入门. 现在配置 Capgo 一次. 之后，日常工作只需 上传 → 测试 → 部署.

规则： 通道是发布分支（development, production不含门票、功能或开发者姓名。

一次性设置清单

创建频道选择最小的集合（见下文）。
设置默认上传频道 在应用设置:
- Solo app → production
- 团队 → development
生产频道： 公共开启，设备自设关闭，原生更新阻断开启，自动更新保护开启 major.
测试频道 (development / staging): 公开模式, 设备自设开启测试模式.

从 CI 上传 与 --delta (校验和原生依赖是自动的):

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta

这个 --bundle 值必须是有效的语义版本. 在上传之前, SemVer 测试器请在测试后再上传.

仅在测试后才 从控制台或 CLI.
团队 & 安全: 邀请一次,最少权限, 2FA 为组织,CI 中一个 API 密钥.

离开加密, min_update_version、元数据和预览关闭除非你有明确的理由。

选择尺寸

简单: 1 个应用，1 个频道： production

团队: development + production. 将开发环境上传，生产环境发布。

原生版本: 只在需要时添加频道，例如。 production-9.0 + test-9.0. 保持商店用户在主生产频道。

许多应用每个应用通常都有一个简单的模型（： production 大组织不应仅因为组织大而创建额外的频道。

发布频道 （可选）： staging → rc → production每个需要它的应用都使用相同的模板。

包名 vs 评论

包名是 required 遵循语义化版本. Capgo 使用 semver 进行兼容性检查、频道自动更新规则和回滚。验证每个名称在 SemVer 测试器上传前

名称 = CI 中的 semver，例如 1.8.0, 1.8.0-beta.1, or 1.8.0-20260629.42
备注 = 人类可读的自由文本 → commit abc1234 run 28059070270

使用 semver 预发布 标签（在 -）当您在同一个时期发布多个构建时使用。例如，保留 MAJOR.MINOR.PATCH并在预发布中添加日期或构建计数： 1.8.0 不要 invent 自定义格式，如 1.8.0-20260629.1, 1.8.0-beta.2或 fix-login-bug 它们不是有效的 semver 并且上传将失败或不可预测地行为。 2.5.2026062306将发布说明放在

,而不是在捆绑包名称中。 --comment参见

版本目标 __CAPGO_KEEP_0__ and bundle版本控制.

Delta上传

--delta 上传清单所以设备每次下载只下载变化的文件，而不是整个bundle。校验和始终自动计算。您不需要传递校验和标志。

默认： `--delta` (清单 + zip备份)

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

This is the recommended default for most apps. Capgo stores the manifest __CAPGO_KEEP_0__存储清单 和

保留完整的zip文件作为备份。当存储成本不是主要关注点时，很好。 `--delta-only`

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta-only

复制到剪贴板 --delta-only 使用 reduce Capgo storage减少__CAPGO_KEEP_0__存储

。只存储delta/清单文件，而不是完整的zip文件。选择此选项以节省存储空间或高上传量的应用程序，存储成本会迅速增加。 --delta-only 除非您实际上需要存储节省.

不需要在设备上额外配置插件。设备更新程序读取清单并只下载更改的文件.

日常工作流

Upload to development (--delta)
  → test
  → deploy to production
  → don't touch channel settings again

常见错误

错误	解决方案
在新商店发布之前不考虑OTA	在添加插件后重建并发布原生应用
上传一个捆绑包但没有部署到一个频道	分配一个捆绑包到一个频道（例如 `production`)
按特性、工单或开发者分配频道	只使用永久发布通道
动态CI频道名称	固定名称： `development`, `production`
一个简单应用的频道太多	从1-2个频道开始
设备自行设置为生产环境	生产环境关闭，测试频道开启
跳过 `--delta`	添加 `--delta` 用于上传时，仅在需要节省存储时使用 `--delta-only` 非semver包名
遵循	语义版本并在语义版本测试器中验证 __CAPGO_KEEP_0__
随时间而改变的版本控制方案	__CAPGO_KEEP_0__`1.8.0-20260629.1`)
元数据/预览功能未提供任何理由	默认不开启

了解更多

频道默认值、优先级和路由

差分更新使用 --delta 的原因和方法

CI/CD 自动上传和部署

模块校验和、依赖项和元数据。

一次性设置清单