跳过内容
Capgo - Live Updates for Capacitor 应用 Capgo

Delta更新

Capgo的实时更新系统可以更快、更高效地将更新发送给用户，只发送更改的文件，而不是整个JS包。

特别适用于在较慢或计量网络连接的用户，因为它最小化了需要下载的数据量。

第二个好处是，当应用程序有大量变化较少的资产，如图像或视频时，相比于压缩的JS文件，它只会下载一次。

Delta（清单）更新的工作原理

标题：Delta（清单）更新的工作原理

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

  1. 为每个文件生成校验和
  2. 创建一个新的JSON清单，列出所有文件及其校验和
  3. 将此清单上传到__CAPGO_KEEP_0__数据库
  4. 当设备运行您的应用程序时，Capgo插件从服务器接收新的清单。它将此清单与当前的清单进行比较，根据校验和和文件路径确定哪些文件已更改。

When a device running your app checks for an update, the Capgo plugin receives the new manifest from the server. It compares this manifest to the one it currently has, identifying which files have changed based on the checksums and file paths.

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

启用Delta（清单）更新

标题：启用Delta（清单）更新

要为您的Capgo应用程序启用Delta（清单）更新，只需在上传新版本时使用以下标志： --delta 终端窗口

复制到剪贴板
npx @capgo/cli@latest bundle upload --delta

设置为即时应用模式（ autoUpdate instant apply mode"atInstall", "onLaunch", 或者 "always") 在你的 capacitor.config, CLI 会检测到它。 在非交互式环境中，它会自动发送 Delta (清单) 更新，而在交互式环境中，它会在上传之前提示你确认。 Legacy directUpdate 配置仍然被检测到。 使用 --no-delta 来强制进行全量包上传。

强制 Delta (清单) 更新

标题：强制 Delta (清单) 更新

如果你想确保所有上传都是 Delta (清单) 更新，并防止任何意外的全量包上传，你可以使用的标志： --delta-only 终端窗口

复制到剪贴板
npx @capgo/cli@latest bundle upload --delta-only

flag: --delta-only 使用了该选项，Capgo 将仅上传单个文件并生成一个清单。任何不支持Delta（清单）更新的设备都无法下载更新。

您可能想使用 --delta-only 如果：

  • 您总是想使用Delta（清单）更新并且不想允许全包上传
  • 您正在设置一个CI/CD管道，并且希望确保所有自动上传都是Delta（清单）更新
  • 您的应用程序很大，带宽受限，因此您需要最小化上传/下载大小

如果您需要在 --delta-only 设置时进行全包上传，而 --delta-only设置为True，仅需运行上传命令而不使用

。这将覆盖该单次上传的设置，允许您在需要时推送一个完整的包。

故障排除

标题为“故障排除”部分的内容

  • 您正在使用 --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

You can also use the Capgo webapp to check the details of your last upload:

  1. 服务器 您还可以使用
  2. webapp
  3. 查看您上次上传的详细信息：
  4. Select the last bundle
  5. 检查 Partial field bundle type

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

That’s it！The --delta flag 告诉 Capgo 执行单独文件上传和清单生成所需的Delta（清单）更新。

注意，您需要在每次上传新版本时使用 --delta ，以便该版本被作为Delta（清单）更新传递。如果您省略该标志，Capgo 将上传整个JS包作为单个文件，设备将下载整个包，即使只有小部分发生了变化。

从Delta更新中继续

Section titled “从Delta更新中继续”

如果您正在使用 Delta更新 为了计划实时更新的交付,连接它与 Capgo 实时更新 在Capgo 实时更新中,为产品工作流程 概览 概览中的实现细节 功能 功能中的实现细节 更新行为 更新行为中的实现细节 更新类型 更新类型中的实现细节