跳过内容
Capgo - Capacitor实时更新 Capgo

一次性设置清单

您已完成 onboarding. 现在配置 Capgo 一次。 之后，日常工作仅为 上传 → 测试 → 部署.

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

标题：一次性设置清单

创建渠道

  1. : 选择最小的集合（见下文）。设置默认上传渠道

  2. 在 应用设置 Solo 应用 →:

    • 团队 → production
    • 发布渠道： development

  3. __CAPGO_KEEP_0__ 公网开启，设备自设关闭，原生开启下阻止更新，自动更新保护开启 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 值 必须 有效 语义版本控制. 在 __CAPGO_KEEP_0__ 中验证它 SemVer 测试器 在上传之前验证它

  6. 仅在测试后才部署到生产环境 仅从 __CAPGO_KEEP_0__ 或控制台 团队 & 安全性: or CLI.

  7. 2FA 为组织设置 2FA 为 CI 配置一个 __CAPGO_KEEP_0__ 密钥 仅在 CI 中使用一个 API 密钥

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

选择你的大小

标题：选择你的大小

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

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

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

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

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

包名与注释

标题为“包名与注释”

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

  • 名称 = CI 中的语义版本号，例如 1.8.0, 1.8.0-beta.1或 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将发布说明放入

，而不是 bundle 名称。 --comment查看更多

See also 版本目标 和 捆绑包版本.

Delta 上传

标题：Delta 上传

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

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

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

对于大多数应用程序来说，这是推荐的默认设置。Capgo存储了清单 并 保留完整的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存储。仅存储delta/清单文件，而不是完整的zip文件。选择此选项时，存储成本会节省下来，特别适合于大型应用程序或高上传量的场景。

权衡: 在没有服务器 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; 使用预发布标签进行额外构建（1.8.0-20260629.1)
元数据/预览功能未经理由启用默认关闭

了解更多

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