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

Delta更新

Capgo 的实时更新系统可以通过仅发送更改的文件来更快、更高效地传递更新，而不是整个 JS 包。

对于较慢或计量网络连接的用户来说，这尤其有利，因为它最小化了需要下载的数据量。

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

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

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

在Capgo中，Delta（清单）更新由安装在应用程序中的Capgo插件处理。当您使用标志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.

__CAPGO_KEEP_0__

启用Delta（清单）更新

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

要为您的Capgo应用启用Delta（清单）更新，请简单地使用以下标志上传新版本： --delta 终端窗口

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

设置为即时应用模式（ autoUpdate ，或"atInstall", "onLaunch", or "always"在非交互环境中，它会自动发送Delta（清单）更新，而在交互环境中，它会在上传前提示确认Legacy capacitor.config, the CLI detects it. In non-interactive environments it sends Delta (manifest) updates automatically, and in interactive environments it prompts you to confirm before uploading. Legacy directUpdate 来强制进行全量包上传。 --no-delta 强制Delta（清单）更新

如果您想确保所有上传都是Delta（清单）更新，并防止任何意外的全量包上传，请使用

标志：

终端窗口 --delta-only 复制到剪贴板

当
npx @capgo/cli@latest bundle upload --delta-only

在 --delta-only 中，Capgo会检测到它。在非交互环境中，它会自动发送Delta（清单）更新，而在交互环境中，它会在上传前提示确认

您可能想使用 --delta-only if:

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

如果您需要在 --delta-only 设置为 --delta-only，只需运行上传命令而不

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

故障排除

标题为“故障排除”

  • 如果Delta（清单）更新似乎没有工作（即，即使是小的变化，设备也总是下载完整的JS打包），请检查： --delta 每次上传新版本时都要标记
  • 如果使用 --delta-only，确保你没有意外遗漏了 --delta 标记
  • 您的设备正在运行最新版本的Capgo插件
  • 您的设备有稳定的网络连接并且可以访问Capgo服务器

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

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

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

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

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

继续使用Delta更新

标题：继续使用Delta更新

如果您正在使用 Delta更新 为__CAPGO_KEEP_0__ Live Updates 配置实时更新 Capgo Live Updates 在Capgo Live Updates 中配置产品工作流 概览 在概览中查看实现细节 功能 在功能中查看实现细节 更新行为 在更新行为中查看实现细节 更新类型 在更新类型中查看实现细节