跳过内容
Capgo - 实时更新 for Capacitor 应用 Capgo

一次性设置清单

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

渠道是发布分支（ ），而不是票据、功能或开发人员名称。development, production一次性设置清单

设置

创建渠道

  1. : 选择最小的集合（见下文）故障排除

  2. 设置默认上传通道 在 应用设置:

    • Solo 应用 → production
    • 团队 → development

  3. 生产通道: 公共开启，设备自设关闭，原生更新阻断开启，自动更新保护开启 major.

  4. 测试通道： (development / staging公共关闭，设备自设开启用于QA

  5. 从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 测试器 之前上传.

  6. 仅在测试后 才能部署到生产环境 仪表盘 或 CLI。

  7. 团队 & 安全性： 邀请一次，权限最少 双因素认证 为组织，CI 中有一个 API 密钥。

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

选择你的大小

标题：选择你的大小

简化: 1 个应用, 1 个频道: production

团队: development + production. 上传到 dev, 部署到 prod.

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

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

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

Bundle 名称 vs 注释

标题为“Bundle 名称 vs 注释”的部分

Bundle 名称必须 遵循 语义版本 . __CAPGO_KEEP_0__ 使用 SemVer 进行兼容性检查、通道自动更新规则和回滚。验证每个名称在. Capgo uses semver for compatibility checks, channel auto-update rules, and rollbacks. Validate every name in the required 上传前。

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

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

将 --comment放入

，而不是 version targeting and bundle versioning.

Delta upload

Section titled “Delta upload”

--delta uploads a manifest 所以设备每次下载只下载改变的文件，而不是每次下载整个包。校验和始终会自动计算。您不需要传递校验和标志。

Default: --delta (manifest + zip备份)

标题：默认值：--delta（manifest + zip备份）
终端窗口
npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

对于大多数应用程序，这是推荐的默认值。Capgo存储manifest 并 保留完整的zip备份。存储成本不是主要问题时，效果很好。

存储节省： --delta-only

标题：存储节省：--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_KEEP_0__存储时 reduce Capgo storage存储折衷：在服务器上没有zip备份，您完全依赖于manifest路径。跳过

除非您实际上需要存储节省的收益 --delta-only 设备上不需要额外的插件配置。更新器读取manifest并仅下载更改的文件。

提示

日常工作流

标题：日常工作流
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测试器
随时间改变版本方案保持semver; 使用预发布标签为额外构建1.8.0-20260629.1)
元数据/预览功能未经理由启用默认关闭

了解更多

了解更多
频道 默认值、优先级和路由。
差分更新 为什么和如何使用 --delta。
CI/CD 自动上传和部署。
捆绑包 校验和、依赖项和元数据。