跳过主要内容
Capgo logo
开发 移动 更新

如何在 Capgo 中实现实时更新

深入了解 Capgo 中实时更新的技术实现，了解 iOS 和 Android 下的工作原理。

马丁·多纳迪厄

马丁·多纳迪厄

内容营销
如何在 Capgo 中实现实时更新

了解 Capgo 中的实时更新

实时更新是 Capacitor 应用中的一个强大功能，允许在不提交应用商店更新的情况下进行实时更新。让我们深入了解 Capgo 如何实现此功能。

核心概念

一个 Capacitor 应用程序由两个主要层次组成：

  1. Web层:包含在WebView中加载的HTML、CSS和JavaScript文件
  2. 原生层:包含平台特定的 code (Android为Java/Kotlin，iOS为Swift)

Capgo 的实时更新系统通过在运行时替换Web层来工作，因为这些文件并未编译到应用程序二进制文件中。

技术实施

服务器路径在 Capacitor 中

Capgo 管理两个关键路径：

  • 当前服务器路径:指向WebView中当前加载的文件
  • 下一个服务器路径: 指向将在下一个应用程序重启时加载的文件

Android 实现

在 Android 上,Capgo 通过以下方式管理路径:

// Store next server path
private void setNextCapacitorServerPath(String path) {
    SharedPreferences prefs = context.getSharedPreferences("CapWebViewSettings", Activity.MODE_PRIVATE);
    SharedPreferences.Editor editor = prefs.edit();
    editor.putString("serverBasePath", path);
    editor.apply();
}

// Update current path and reload
private void setCurrentCapacitorServerPath(String path) {
    bridge.setServerBasePath(path);
    bridge.reload();
}

iOS 实现

在 iOS 上，路径通过以下方式管理:

// Store next server path
private func setNextCapacitorServerPath(path: String) {
    KeyValueStore.standard["serverBasePath"] = path
}

// Update current path
private func setCurrentCapacitorServerPath(path: String) {
    bridge.viewController.setServerBasePath(path: path)
}

安全措施

Capgo 实现了端到端加密，确保从开发到部署，应用程序更新始终保持完全安全。我们的加密系统超越了传统的code 签名，提供了真正的零知识安全。

端到端加密架构

  1. 端到端加密 (E2EE): 每个更新包在离开开发环境之前都使用 AES-256-GCM 加密。这种军用级加密确保了应用程序更新在整个交付过程中始终保持完全私密和安全。

  2. 零知识架构: 与其他 OTA 更新解决方案相比，Capgo 采用了真正的零知识加密。 这意味着：

    • 更新内容在上传前进行加密
    • Capgo 服务器仅存储加密数据
    • 仅在终端设备上进行解密
    • 中间者无法访问您的更新内容

  3. 安全密钥管理:

    • 加密密钥在您的 CI/CD 环境中生成并存储
    • 私钥永远不会触及Capgo 服务器
    • 每个应用程序版本都可以使用独特的加密密钥
    • 密钥轮换支持以增强安全性

有关我们的加密系统的详细指南，请参阅： Capgo Live Updates 中的端到端加密

安全更新流程

  1. 预上传加密:

    • 在您的CI/CD管道中，更新将被加密
    • 每个文件都将单独加密
    • 元数据也将加密，确保完全的隐私

  2. 安全存储:

    • 加密的包将在Capgo的全球CDN上存储
    • 我们的服务器上永远不会有明文数据
    • 即使发生服务器被入侵的情况下，数据也仍然是安全的

  3. 安全交付:

    • 更新将通过加密通道交付
    • 每个应用实例都将验证加密完整性
    • 自动重试机制用于失败的解密

  4. 客户端安全:

    • 更新在安装之前被验证
    • 解密失败触发自动回滚
    • 在应用的保护存储中安全存储密钥

这种全面安全的方法确保您的应用更新始终受到保护：

  • 中间人攻击
  • 服务器端违规
  • 未经授权的修改
  • 重放攻击
  • 内容篡改

更新生命周期

Capgo的自动更新过程默认开启。以下是自动更新过程的工作原理：

1. 自动更新检查

在以下情况下，插件会自动检查更新：

  • 应用启动时

此行为由以下设置控制： autoUpdate 您也可以手动检查更新

// capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true // Enable automatic updates
    }
  }
}

2. 自动下载 getLatest()

当检测到新版本时，如果

自动下载开启： autoUpdate 下载开始自动

  1. 进度在内部跟踪
  2. __CAPGO_KEEP_0__的自动更新过程默认开启。以下是自动更新过程的工作原理：
  3. 下载失败会在每次应用打开时自动重试
  4. 成功下载的文件会存储在应用存储中

您可以通过事件监控此过程：

CapacitorUpdater.addListener('download', (info: DownloadEvent) => {
  console.log('Auto-download progress:', info.percent);
});

CapacitorUpdater.addListener('downloadComplete', (info: DownloadCompleteEvent) => {
  console.log('Auto-download complete:', info.bundle);
});

3. 自动安装

安装的时间取决于您的配置：

// capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true,
      "directUpdate": false // install update on app backgrounding
      "resetWhenUpdate": true, // reset live updates on native update (true by default)
      "autoDeleteFailed": true, // Auto cleanup failed updates (true by default)
      "autoDeletePrevious": true // Auto cleanup old versions (true by default)
    }
  }
}

安装发生在：

  • 立即如果 directUpdate __CAPGO_KEEP_0__
  • 在下一次应用后台运行时如果 directUpdate false
  • 安装失败时自动回滚

插件还会自动管理存储：

  • 移除失败的更新如果 autoDeleteFailed __CAPGO_KEEP_0__为真
  • 清理旧版本如果 autoDeletePrevious __CAPGO_KEEP_0__为真

延迟更新

您可以控制更新何时安装使用延迟条件：

// Delay until app goes to background
await CapacitorUpdater.setDelay({
  kind: 'background'
});

// Delay until specific date
await CapacitorUpdater.setDelay({
  kind: 'date',
  value: '2024-03-20T10:00:00.000Z'
});

// Delay until next native version
await CapacitorUpdater.setDelay({
  kind: 'nativeVersion'
});

// Multiple conditions
await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    {
      kind: 'background'
    },
    {
      kind: 'date',
      value: '2024-03-20T10:00:00.000Z'
    }
  ]
});

可用延迟条件：

  • 背景: 应用程序进入背景时安装
  • 日期: 安装特定日期/时间后
  • 原生版本: 安装后下一次原生更新
  • kill: 安装后应用被杀死

This is useful for:

  • 在非高峰时间调度更新
  • 与用户活动协调更新
  • 确保平滑的更新体验
  • 防止在关键任务期间中断

更新状态

在自动过程中，捆绑包会通过这些状态转换：

  1. 下载中: 下载进行中
  2. 等待: 下载完成，等待安装
  3. 成功: 更新已安装并激活
  4. 错误: 更新失败（触发自动回滚）

商店合规

Apple App Store

Live Updates 完全符合 Apple App Store 政策。根据 Apple Developer Program License Agreement：

“Interpreted code may be downloaded to an Application but only so long as such code: (a) does not change the primary purpose of the Application by providing features or functionality that are inconsistent with the intended and advertised purpose of the Application as submitted to the App Store, (b) does not create a store or storefront for other code or applications, and (c) does not bypass signing, sandbox, or other security features of the OS.”

Capgo 可以下载到应用程序，但仅在以下条件下： (a) 不改变应用程序的主要目的，提供与应用程序提交到 App Store 的宣传目的不一致的功能或功能； (b) 不创建其他 __CAPGO_KEEP_2__ 或应用程序的商店或商店； (c) 不绕过签名、沙盒或其他安全功能。

__CAPGO_KEEP_0__ 更新仅修改 web 层，同时尊严所有平台安全边界。

实时更新遵守Google Play政策。设备和网络滥用政策特别指出：

“此限制不适用于在虚拟机或解释器中运行的code，前提是其中一个提供了对Android API的间接访问（例如在webview或浏览器中使用JavaScript）。”

由于Capgo仅更新webview内容，因此它符合这些允许的指南。

最佳实践

  1. 分阶段发布: 分段发布更新
  2. 版本控制: 跟踪所有部署的版本
  3. 回滚支持: 快速恢复问题
  4. 差分更新: 只下载更改的文件

何时使用实时更新

适用于：

  • bug修复
  • UI改进
  • 内容更新
  • 功能开关

不适用于：

  • 原生code更改
  • 重大版本更新
  • 需要原生更改的安全补丁

从如何在Capgo中使用实时更新继续

如果您正在使用 如何在Capgo中使用实时更新 为了计划原生插件工作，连接它 Capgo原生插件目录 为了产品工作流程在Capgo原生插件目录中 Capacitor插件由Capgo 为了Capacitor插件由Capgo的实现细节 添加或更新插件 为了添加或更新插件的实现细节 Ionic企业插件替代品 为了产品工作流程在Ionic企业插件替代品中 原生Capgo构建 为了产品工作流程在原生Capgo构建中

Capacitor应用的实时更新

当web层的bug实时更新时，通过Capgo将修复发送到用户，而不是等待几天的应用商店审批。用户在后台接收更新，而原生变化仍然在正常的审批路径中。

立即开始

最新博客文章

Capgo为您提供创建真正专业的移动应用所需的最佳见解。

Capacitor应用的双向通信
开发 移动 +1
2025年4月26日

2-Way Communication in Capacitor 应用

避免的 5 个 OTA 更新常见错误
开发 安全 +1
2025 年 4 月 13 日

避免的 5 个 OTA 更新常见错误

移动应用实时更新的 5 个安全最佳实践
开发 移动 +1
2025 年 1 月 14 日

5 移动应用实时更新的安全最佳实践

查看我们博客中的所有内容