一次性设置清单

复制安装步骤和完整的 Markdown 指南。

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

规则： 渠道是发布分支（development, production），而不是票据、功能或开发人员名称。

一次性设置清单

创建渠道: 选择最小的集合（见下文）。
设置默认上传渠道 在应用设置:
- Solo 应用 → 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

The --bundle value must 有效语义版本控制验证它 SemVer 测试器在上传之前

发布到生产环境 在测试后, 从 dashboard CLI
团队 & 安全性: 邀请一次，权限最少 2FA 为组织设置一个 CI 中的 API 密钥

关闭加密 min_update_version, 元数据和预览关闭除非你有明确的原因

选择你的大小

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

团队: development + production. 上传到开发环境，部署到生产环境。

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

许多应用: 每个应用通常有一个简单的模型（通常是每个）。不要仅因为组织大就创建额外的频道。 production 发布列车

(可选): . 每个需要它的应用都使用相同的模板。 staging → rc → production注意

包名与注释

包名必须遵循语义版本 . __CAPGO_KEEP_0__ 使用语义版本进行兼容性检查、频道自动更新规则和回滚。请在上传前验证.Capgo 使用 semver 进行兼容性检查、频道自动更新规则和回滚。验证每个名称在 Note: I kept the placeholder Capgo as it is, as per the instructions. 名称名称

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

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

将发布说明放入 --comment, 不要在捆绑包名称中。

查看更多版本目标和捆绑包版本.

Delta 上传

--delta 上传 差异文件 这样设备只下载更改的文件，而不是每次下载整个捆绑包。校验和始终自动计算。您不需要传递校验和标志。

Default: `--delta` (delta 文件 + zip 备份)

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

对于大多数应用程序来说，这是推荐的默认设置。Capgo存储delta文件并且保留完整的zip文件作为备份。使用旧插件版本的设备（不支持Delta）将使用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 当您想 减少Capgo存储. 只存储delta文件，不存储完整的zip文件。选择此选项对于大型应用程序或高上传量的应用程序，存储空间会累积。

权衡利弊：没有在服务器上备份zip文件，您完全依赖于delta文件，且设备上旧版插件没有Delta支持的设备无法更新。跳过 --delta-only 除非您实际需要存储空间节省。

不需要在设备上额外配置插件。更新器读取delta文件列表并只下载更改的文件。

日常工作流程

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

常见错误

错误	修复
在新商店发布前期望OTA	在添加插件后重建并发布原生应用
上传一个捆绑包但没有部署到一个频道	将捆绑包分配到一个频道（例如 `production`)
按特性、票据或开发者进行频道分组	仅使用永久发布通道
动态CI频道名称	固定名称： `development`, `production`
一个简单应用程序的频道太多了	开始时使用1-2个频道
设备自定义为生产	生产环境关闭，测试频道开启
跳过 `--delta`	添加 `--delta` context `--delta-only` 上传时使用；仅在需要节省存储时使用
非semver包名	遵循语义版本并在 SemVer测试器
随时间改变版本方案	保持semver; 使用预发布标签为额外构建`1.8.0-20260629.1`)
元数据/预览启用无理由	默认不启用

了解更多

频道默认设置、优先级和路由。

delta更新为什么和如何使用--delta。

CI/CD 自动上传和部署。

捆绑包校验和、依赖项和元数据。

一次性设置清单