一次性设置清单

复制一个包含安装步骤和本插件完整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
```
该 --bundle 值必须有效语义版本. 在 __CAPGO_KEEP_0__ 中验证它（ SemVer 测试器在上传之前
仅在测试后才部署到生产环境 从 __CAPGO_KEEP_0__ 或控制台团队 & 安全性：或CLI。
2FA 为组织设置 2FA 为组织，CI中需要一个API密钥。

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

选择大小

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

团队: development + production上线到 dev，部署到 prod。

原生版本: 只在需要时添加频道，例如 production-9.0 + test-9.0团队计划

许多应用: 每个应用都使用相同的简单模型（通常是每个应用一个） production 每个应用都有一个模型。不要因为组织很大就创建多个频道。

发布列车 (可选): staging → rc → production同样的模板在每个需要它的应用上。

Bundle 名称与注释

Bundle 名称是必填需要遵循语义版本 . Capgo 使用语义版本号进行兼容性检查、自动更新规则和回滚。验证每个名称在语义版本测试器上传前

名称 =语义版本号 1.8.0, 1.8.0-beta.1例如 1.8.0-20260629.42
,或备注 commit abc1234 run 28059070270

=自由文本 预发布 标签（发布后） -当您在同一个时期发布多个版本时，使用此部分 MAJOR.MINOR.PATCH例如，保留 1.8.0 并在预发布中添加日期或版本计数 1.8.0-20260629.1, 1.8.0-beta.2不要创造自定义格式，如 fix-login-bug 或 2.5.2026062306预发布

将发布说明放入 --comment而不是在捆绑包名称中

参见版本目标和捆绑版本.

Delta 上传

--delta delta 文件 delta 文件 默认：

Default: `--delta` 终端窗口

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` 在生产环境中，设备自设 `--delta-only` 在生产环境中关闭，测试频道开启
跳过	添加上传时使用仅在需要节省存储空间时使用非semver包名列表项
版本控制方案的变化	保持 SemVer; 使用预发布标签进行额外的构建（`1.8.0-20260629.1`)
元数据/预览功能没有合理的原因	默认不开启

了解更多

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

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

CI/CD 自动上传和部署

套件校验和、依赖项和元数据。

一次性设置清单