跳过内容
Capgo - Capacitor 应用程序的实时更新 Capgo

Delta更新

Capgo的Live Update系统可以通过仅发送更改的文件而不是整个JS包来更快、更高效地交付更新。

这尤其适用于使用较慢或带宽受限网络连接的用户，因为它最小化了需要下载的数据量。

当应用程序具有大量变化较少的资产，如图像或视频时，相比于压缩的JS文件，它将仅下载一次。

Delta（清单）更新

如何Delta（清单）更新工作

Capgo中的Delta（清单）更新由安装在应用程序中的Capgo插件处理。 --delta 当您使用标志上传应用程序的新版本时，Capgo会执行以下操作：

  1. 每个构建文件都单独上传
  2. 为每个文件生成校验和
  3. 创建一个新的 JSON 清单，列出所有文件及其校验和
  4. 将此清单上传到 Capgo 数据库

当设备运行您的应用程序时，检查更新时，Capgo 插件从服务器接收新的清单。它将此清单与当前的清单进行比较，根据校验和和文件路径来确定哪些文件已更改。

然后，插件只下载更改的文件，而不是整个 JS 包。它通过将下载的文件与已有的未更改文件结合起来，重建应用程序的新版本。

启用 Delta (清单) 更新

标题：启用 Delta (清单) 更新

要为您的 Capgo 应用程序启用 Delta (清单) 更新，请简单地使用 --delta 在上传新版本时显示标志：

终端窗口
npx @capgo/cli@latest bundle upload --delta

如果 autoUpdate 设置为即时应用模式（"atInstall", "onLaunch"，或 "always"）在您的 capacitor.config，CLI检测到它。 在非交互式环境中，它自动发送Delta（清单）更新，而在交互式环境中，它会在上传之前提示您确认。 directUpdate 遗留 --no-delta 配置仍然被检测到。 使用

强制全量打包上传。

强制Delta（清单）更新

If you want to ensure that all uploads are Delta (manifest) updates and prevent any accidental full bundle uploads, you can use the --delta-only flag:

Terminal window
npx @capgo/cli@latest bundle upload --delta-only

When --delta-only is used, Capgo will only upload individual files and generate a manifest. Any device that does not support Delta (manifest) updates will not be able to download the update.

You might want to use --delta-only if:

  • You always want to use Delta (manifest) updates and never want to allow full bundle uploads
  • You’re setting up a CI/CD pipeline and want to ensure all automated uploads are Delta (manifest)
  • Your app is large and bandwidth is constrained, so you need to minimize upload/download sizes

If you need to do a full bundle upload while --delta-only 如果已设置，请只需运行上传命令而不 --delta-only这将覆盖该单个上传的设置，使您能够在需要时推送完整的捆绑包。

Troubleshooting

标题：Troubleshooting

如果Delta（清单）更新似乎不起作用（即，即使是小的更改，设备也始终下载完整的JS捆绑包），请检查：

  • 您正在使用 --delta 标志每次上传新版本时
  • 如果使用 --delta-only,请确保您没有意外遗漏 --delta 标志
  • Your device is running the latest version of the Capgo plugin
  • Your device has a stable network connection and can reach the Capgo servers

您也可以使用 Capgo webapp 来检查您的上次上传的详细信息：

  1. 前往 webapp
  2. 点击您的应用
  3. 点击统计条中的包数量
  4. 选择最后一个包
  5. 检查 Partial 字段 包类型

如果您继续遇到问题，请联系 Capgo 支持团队，进一步协助。他们可以检查服务器日志来确认您的Delta（清单）上传是否正确处理，并且设备是否接收到了更新的清单。

完成！该 --delta 标志告诉 Capgo 执行单独文件上传和清单生成所需的Delta（清单）更新

请注意，每次上传新的版本时，如果您希望它作为Delta（manifest）更新被分发，那么就需要使用。 --delta 每次上传新的版本时，如果您希望它作为Delta（manifest）更新被分发，那么就需要使用标志。如果您忽略标志，Capgo 将上传整个JS包作为单个文件，设备将下载整个包，即使只有小部分发生了变化。

继续使用Delta更新

标题：继续使用Delta更新

如果您正在使用 Delta更新 来规划实时更新的分发，连接它与 Capgo Live Updates for the product workflow in Capgo Live Updates, __CAPGO_KEEP_0__ Live Updates 概述 用于实现细节的概述， Features 实现细节 更新行为 更新行为的实现细节，以及 更新类型 更新类型的实现细节。