跳转到正文

常见问题

如果这里没有解答您的疑问,欢迎提问!无论是提交 issue 还是在 Discord 上提问,都可以。

Code push,也称为“OTA(over-the-air)更新”,是一种云服务,让 Capacitor 开发者能把更新部署到生产环境的 App 中。Capgo 目前支持 Android、iOS 和 Electron。

“Code Push” 这个名称参考了 React Native 社区中由 Microsoft 以及 Expo,两者均不支持 Capacitor。

Capgo CLI 的 major 版本需要和我的插件或 Capacitor 版本匹配吗?

章节标题:“Capgo CLI 的主版本需要与我的插件或 Capacitor 版本匹配吗?”

不需要。请始终使用最新的 Capgo CLI (npx @capgo/cli@latest)。CLI 和 Capgo Console 有独立的版本管理,并兼容所有受支持的 updater plugin 主版本。Capgo 插件跟随 Capacitor 主版本;请参阅 Capgo 版本管理 了解 LTS 标签,例如 @lts-v7.

“release”一词指的是为应用商店准备二进制文件。为了后续生成 bundle,Capgo 需要知道发布到应用商店的确切二进制文件。

“bundle”一词指的是可应用到 release 的补丁,用于将其更新到新的 code。 npx @capgo/cli@latest bundle upload 该命令用于从你本地新的 code 生成 bundle,然后分发给你的用户。

是:

  • 零字节文件: CLI 会记录 Ignoring empty file... 并从 delta 文件中排除空文件。这不会让 upload 失败,因此空文件可能会改变最终生成的 bundle,而不会中断你的部署。请勿在 Delta bundle 路径中包含零字节文件。
  • 带空格的路径: 当 bundle 路径包含空格时,Delta upload 会提前失败并给出明确错误。在上传 Delta update 之前,请重命名文件或目录以移除空格。

查看 增量更新 查看设置详情。

我们的项目看板也是公开的,地址如下: https://github.com/orgs/Cap-go/projects

我们的团队也在公开环境下工作,因此你可以随时看到我们在做什么。如果你对我们的路线图或优先级有任何疑问,欢迎通过 Github issues 或 Discord.

可以!所有套餐都支持不限数量的开发者。我们只按组织限制应用指标(MAU、存储和带宽)。

查看 团队 了解更多信息。

不会。Capgo 服务器永远看不到你的 source code。当你运行 npx @capgo/cli@latest bundle upload,Capgo 会存储一个 zip 文件,里面是压缩/编译后的 code——也就是浏览器会收到的同一个 code,而不是你的 source code。

为了更安全,你有两个选择:

  • 端到端加密:上传前加密 bundle,以保护其在存储和传输中的安全,并防止第三方在没有你的私钥时生成有效的加密更新。这并不能让已发布的 Web 资源无法被逆向工程,因为公钥就在已分发的应用里。
  • 外部 URL 上传:将 bundle 存放在你自己的服务器上,只使用该选项向 Capgo 提供下载链接 --external <url>

另请参阅我们的隐私政策: https://capgo.app/privacy

不是。bundle 文件是公开的 Web 资源,供你的应用用户下载。任何知道 bundle URL 的人都能获取这些文件,Capgo 会在设置时和文档中告知用户这一点。

访问 bundle 文件不算数据泄露。不要在应用 bundle 中放入机密、凭据、个人数据或受监管数据。如果你的高安全场景需要更强的保密性,请使用端到端加密,但从安全报告的角度,仍应将已发布应用的 code 和资源视为公开内容。

我可以在 CI 系统中使用 Capgo 吗?

章节标题:“我可以在 CI 系统中使用 Capgo 吗?”

可以。Capgo 就是供 CI 系统使用的。我们已发布指南,涵盖 Android 和 Github Actions 以及 iOS,以及 GitLab。其他 CI 系统也应类似。

如果遇到任何问题,请随时通过 GitHub issues 或 Discord 联系我们。

这和 Firebase Remote Config 或 Launch Darkly 有什么关系?

章节标题:“这与 Firebase Remote Config 或 Launch Darkly 有何关系?”

Code push 允许在设备上新增 code / 替换 code。Firebase Remote Config 和 Launch Darkly 都是配置系统。它们让你无需发布新版本即可更改应用配置,并非旨在替代 code。

我最近没有测量过,但我预计 code 推送库会让 Capacitor 应用的体积增加不到 1 MB。当减小体积成为优先事项时,我们有一些办法可以做到。如果体积对你来说是个障碍,请告诉我们!

不支持。由于影响 iOS 18.4 模拟器的上游问题,Capgo 在该环境下无法稳定运行。请使用真机测试,或换用其他版本的 iOS 模拟器。

详情请见 React Native 的 issue: facebook/react-native#50510

code 的 push 功能适用于大型应用吗?

章节标题:“code 推送是否适用于大型应用?”

是的。通过 code 推送更新的应用大小没有限制。如前所述 下方,无论大小如何,Capgo 都可以更改您应用中的任何 JS code。

注意:应用体积越大,用户下载更新就越困难。建议尽量保持应用体积小巧。

我们见过各种用途,包括:

  • 生产环境应用的紧急修复。
  • 向使用旧版本应用的用户推送 bug 修复。
  • 持续发布(例如每小时一次)。

请注意,大多数应用商店禁止发布 会显著改变应用行为的 code。请参阅 下方 了解更多信息。

Capgo 的 “MAU” 是如何计算的?

章节标题:Capgo 的“MAU”如何计算?

MAU 指每月活跃设备(Monthly Active Device)。在滚动 30 天周期内与 Capgo 通信的独立设备,会计为该 native app ID 的一个 MAU。同一台物理设备使用两个不同的 native app ID 时,会分别为每个 app ID 各计一次,不会跨 app ID 去重。

如果您的 flavors 仅在 Web 层或更新路由上不同,请使用同一个 native app ID,并搭配 频道。这样可以让这些 flavors 都归在同一个 Capgo app 下,发布也更简单。当某个 flavor 需要独立的 bundle ID、签名身份、entitlement 集合或商店详情页时,请使用不同的 native app ID。

在 iOS 上, v7.25.0+ 会借助 Keychain 在常规重装后保留随机、按 app 作用域划分的设备 ID。在 Android 上,请使用 v7.50.1+ (或 v5.50.1+ 以及 v6.50.1+ 在这些发布版本上);仅当 Android Backup/Restore 保留应用偏好设置时,ID 才会恢复。禁用备份、排除这些偏好设置或清除应用数据都会生成新的设备 ID。更新应用不会创建新的设备 ID。

对于测试和开发构建,请在生产渠道中关闭 development-build 和模拟器投递。这控制的是投递,而不是 MAU:设备在联系 Capgo 时仍可能被计入。要让它不计入生产用量,请禁用 Live Updates,并且不要调用生产环境的 Capgo 端点。请参阅 无需 Live Updates 测试 Native Build 查看具体设置。

Capgo 无法更改原生 code,例如 Java、Kotlin、Objective-C、Swift、原生插件或原生配置。这些更改需要发布新的原生应用版本。有关商店审核范围,请参阅 App Store 和 Google Play 政策.

我可以通过 Capgo 更新 capacitor.config.ts 的改动吗?

标题为“我能否通过 Capgo 更新 capacitor.config.ts 的更改?”的章节

不能。简短规则:Capgo 可以发送生成的 web build 文件夹,包括 HTML、CSS、JavaScript、资源以及打包到该输出中的纯 JavaScript 包更改。对 capacitor.config.ts、原生插件配置、原生包安装或升级,以及任何必须通过 npx cap sync 或 npx cap copy 更新 iOS 或 Android 项目的内容,都需要发布原生应用版本。

Capacitor 配置文件在原生构建时读取,并编译到原生应用二进制文件中。如果需要更改 Capacitor 配置,你必须:

  1. 更新 capacitor.config.ts 在本地
  2. 重新构建原生应用(npx cap sync 随后进行原生构建)
  3. 将新的二进制文件提交到应用商店

Capgo 会帮我提交到应用商店吗?

标题为“Capgo 会替我提交到商店吗?”的章节

Capgo Build 可以编译并签名已准备好的原生 iOS 或 Android 项目,并在配置后,将签名结果提交到 App Store Connect 或 Google Play。您可以保留现有的 CI 用于私有依赖、Web 构建、Capacitor 同步和自定义原生准备;Capgo 会在原生构建步骤中接收准备好的原生项目。

查看 Capgo 构建 以及 构建配置参考 了解工作流程和商店提交选项。

Capgo 会在磁盘上存储什么,存在哪里?

章节标题:“Capgo 在磁盘上存储什么、存储在哪里?”

Capgo 更新器(构建应用时会包含在你的应用中)会在 capacitor 允许加载 code 的唯一目录中缓存最新下载的 bundle。在 Android 上,该目录位于 /data/user/0/com.example.app/code_cache/capgo_updater 不过该路径的基础部分由 Android 系统提供,并可能在运行时动态变化。在 iOS 设备上,数据存储在 Library/Application Support/capgo.

Capgo 命令行工具(例如 npx @capgo/cli@latest bundle upload)会安装在磁盘上的 npm 缓存中,你的登录信息则存储在用户主目录下的 ~/.capgo.

这与 Capacitor Hot Reload 有什么关系?

章节标题:“这与 Capacitor Hot Reload 有何关系?”

Capacitor 的 Hot reload 是仅在开发时使用的功能。Code push 用于生产环境。

Hot reload 是 Capacitor 的一项功能,允许你在开发期间更改设备上的 code。它需要构建带代理的 Capacitor 应用,以连接到你的本地机器。

Code 推送功能允许您在生产环境中的设备上更改 code。我们会根据平台采用多种技术来实现。

Capgo code push 支持哪些类型的更改?

章节标题:“Capgo code 推送支持哪些类型的更改?”

Capgo 可以更改应用中的任何 JS code。这包括应用 code 和生成的 code。您还可以更新以下位置的依赖: package.json 只要这些更新不需要原生 code 更改。

我们目前没有计划支持更改原生 code(例如 Android 上的 Java/Kotlin 或 iOS 上的 Objective-C/Swift);如果工具检测到您更改了原生 code,它会发出警告,因为这些更改不会包含在 bundle 中。

Web 端不需要 Code 推送,因为 Web 本来就是这么工作的。用户打开 Web 应用时,它会按需从服务器下载最新版本。

如果您有在 Web 端使用 code 推送的场景,欢迎告诉我们!

它能在 iOS、Android、Mac、Windows、Linux 等平台上运行吗?

章节标题:“这是否适用于 iOS、Android、Mac、Windows、Linux 等平台?”

是的。

到目前为止,我们主要支持 Android、iOS 和 Electron,code 推送在这三个平台上均已可用于生产环境。

Capgo 支持的 Android 版本与 Capacitor 相同。

Capacitor 目前支持 Android API level 22+ 和 iOS 13.0+: https://capacitorjs.com/docs/main/reference/support-policy

Capgo 目前仅支持 Capacitor 的近期稳定版本。我们也可以支持更旧版本的 Capacitor,只是还没有构建出长期维护这些版本所需的基础设施。我们计划未来支持更多 Capacitor 版本,包括为企业客户支持任意版本。 https://github.com/Cap-go/capgo/issues/1100

Capgo 会跟踪 Capacitor 的稳定版,通常在任何稳定版本发布后几小时内完成更新。我们的更新系统是自动化的,运行一次只需几分钟。之后我们还会额外做一次手动验证,再发布到服务器。

这与 App Store/Play Store 的审核流程或政策有什么关系?

标题为“这与 App Store/Play Store 的审核流程或政策有什么关系?”的章节

Capgo 只向 Capacitor 的 Web 层交付变更:即已在应用 WebView 中运行的 HTML、CSS、JavaScript 和资源文件。它不会更改原生二进制、原生插件、权限、entitlements、签名或商店元数据。

任何原生变更,以及可能影响应用审核用途或功能的重大变更,都应通过原生商店版本发布。请确保 Live Updates 的内容不超出您已提交并向用户披露的应用体验范围。

Capgo 会导致 Apple 以远程 code 执行为由拒绝吗?

标题为“Capgo 会导致 Apple 拒绝远程 code 执行吗?”的章节

不会。这不可能发生。Capgo 不会安装或执行原生 code、动态库、框架或插件,也无法调用 dlopen, dlsym, performSelector:,或 method_exchangeImplementations()。它只替换已编译进受审核二进制文件中的 WebView 或 JavaScriptCore 引擎里的 JavaScript、HTML、CSS 和静态资源。

当 App Review 引用 Guideline 2.5.2 或“远程 code 执行”时,不要将 Capgo 视为原因。请阅读审核通知,然后检查原生项目和其他 SDK 是否存在可执行文件加载或私有 API 的使用。此前有一条审核意见提到 Capgo 启动页自动隐藏路径中的动态链接问题,那是该原生插件的 bug,而不是 live updates,且该链接已被移除。

不会。Capgo 不会导致远程 code 执行被拒。请参阅 Capgo 会导致 Apple 以远程 code 执行为由拒绝吗?。Capgo 是为 Capacitor 应用中的解释型 Web 层构建的。它不会在审核后安装或执行原生 code。Apple 仍会依据每个 App 的实际情况单独审核,Capgo 无法保证结果。

Apple 的 App 审核指南 2.5.2 规定应用不得“下载、安装或执行会引入或改变应用特性或功能的 code”。审核团队会援引该规则以及 Apple Developer Program License Agreement 第 3.3.1(B) 节 中关于可执行 code 的规定,审核团队会据此拒绝在审核通过后使用远程资源改变行为的应用。典型案例包括 dlopen, dlsym, performSelector:,或访问私有 API 的远程脚本。

同一份许可协议允许 解释型 code 在满足以下条件时下载:

  • 不会改变 App 的核心用途,
  • 不会绕过签名、沙盒或其他 OS 安全特性,且
  • 不会为其他应用创建商店或店面。

章节 3.3.1(C) 另行限制通过 App Store、Custom App Distribution 或 TestFlight 以外的分发机制提供、解锁或启用额外功能或特性,除非 Apple 事先书面批准,或该活动属于该条款允许的范围 3.3.9(A) (App 内购买 API)。该条款如何适用于某个解释型 code OTA bundle,是你的团队和法律顾问需要判断的法律问题。

Capgo 替换的是已经在你 App 的 WebView 或 JavaScriptCore 引擎中运行的 JavaScript、HTML、CSS 和静态资源。它不会随包发布原生二进制文件、机器 code、动态库或插件。 指南 4.7 (澄清于 2025 年 11 月) 适用于你的 App 提供 HTML5 和 JavaScript 小程序、小游戏、聊天机器人、插件或类似未嵌入二进制文件的软件。如果用户能在你的 App 内浏览或启动多个不同的软件体验,请与法律顾问一起评估额外的 4.7 要求。单一产品通过渠道更新自己已审核的 web bundle,是另一种用户体验,但只有 Apple 能决定你的元数据是否符合该描述。

通过常规 App Store 二进制包发布原生能力、权限、entitlements 和重大功能变更。对于已提交 App 范围内的 Web 层修复和改进,请使用 Capgo。参见 Apple 远程 code 执行与 Capgo 如需更详细的合规性分析,或 博客详解 请参阅指南 2.5.2、ADPLA 3.3.1(B) 以及 2025 年指南 4.7 的澄清说明。

Capgo 能保证通过 App Store 或 Google Play 审核吗?

章节标题:“Capgo 是否保证 App Store 或 Google Play 审核通过?”

不保证。Apple 和 Google 会根据每个应用和版本的具体情况进行独立审核,Capgo 无法保证单个应用的审核结果。您的团队仍需对应用内容、披露信息、更新范围以及符合当前商店政策负责。

为了审核和发布规划,请直接阅读官方政策: Apple App Store 审核指南 以及 Google Play 设备和网络滥用政策.

我可以在我所在的国家使用 Capgo 吗?

标题为“我所在的国家可以使用 Capgo 吗?”的章节

我们并未尝试限制任何国家访问 Capgo。

我们了解到,某些国家对境内可访问的 URL 有限制。Capgo 目前使用 Cloudflare Cloud 托管,包括 R2 Storage 和 Cloudflare workers。

Capgo 使用以下 URL:

如果这些 URL 在你所在的国家都能访问,那么 Capgo 应该就能正常工作。

如果您的地区需要屏蔽上述任何 URL,请告知我们,我们可以与您合作寻找解决方案。代理服务器是一个可行的选项。

是的。当您需要在自己的基础设施中运行更新器后端时,Enterprise 支持许可的自托管 Capgo 部署。请参阅 自托管更新器 了解部署模型和端点。

是的。虽然可以设想运行一个服务器来独立于公共互联网分发更新,但将更新传输到设备需要某种形式的网络连接。

没有网络连接时,Capgo 会受到什么影响?

标题为“网络连接中断会对 Capgo 产生什么影响?”的章节

Capgo 更新器(使用 Capgo 构建应用时会包含在你的应用中)在设计上能够应对网络连接问题。

在默认更新行为下,应用启动时会通知 Capgo 更新器,后者会启动一个独立线程,向 Capgo 的服务器发起网络请求并请求更新。我们特意使用独立线程,是为了避免阻塞应用可能正在执行的其他任务。如果网络请求失败或超时,更新器会在下次应用启动时再尝试检查。

Capgo 命令行工具(例如 npx @capgo/cli@latest bundle upload)需要网络连接才能运行。如果你使用 Capgo 分发应用,请确保你的 CI 系统可以联网。

如果用户长时间未更新并错过了某次更新,会发生什么?

章节标题:“如果用户长时间不更新并错过了一次更新,会发生什么?”

我们的实现始终会向发起请求的设备发送专门适配的更新,把请求方更新到当前可用的最新版本。因此,如果用户一段时间不更新,就会“错过”中间的更新。

更新服务器可以调整,以根据你的应用需求返回下一个增量版本或最新版本。如果其他更新行为对你很重要,请告诉我们。

Capgo 是 Capacitor 的一个插件,它增加了 code 推送功能。Capgo 并不是 Capacitor 的替代品。你可以继续使用你熟悉且喜爱的 Capacitor 工具。

我们会跟踪 Capacitor 的最新稳定版本,并更新我们的 code 推送插件以保持兼容。

更新会在什么时候发生?

标题为“更新何时发生?”的章节

默认情况下,Capgo 更新程序会在应用启动时检查更新。它在后台线程运行,不会阻塞 UI 线程。任何更新都会在用户使用应用时进行安装,并在下次重启应用时生效。

你也可以通过以下方式手动运行 Capgo 更新程序: @capgo/capacitor-updater 使用该 package,你可以随时触发更新,包括通过推送通知触发。

Capgo 更新器的设计确保在网络不可用、服务器宕机或无法访问时,应用仍能正常运行。即使您选择从我们的服务器上删除某个更新,所有客户端也都会继续正常运行。

我们已添加回滚补丁的功能。最简单的方法是直接将之前的 bundle 附加到您的 channel 上以撤销更改。

不需要。 app_id 包含在您的应用中,公开是安全的。您可以将其提交到版本控制(甚至是公开的),无需担心他人访问。

拥有您的 app_id 的人可以从 Capgo 服务器获取您应用的最新版本,但他们无法向您的应用推送更新,也无法访问您 Capgo 账户的其他任何方面。

完整的数据清单、端点行为和隐私控制详见 合规性.

设置 statsUrl: '' 以禁用显式更新器统计报告。你也可以将数据发送至 statsUrl 你控制的代理或端点;请参阅 在自托管基础设施中处理统计数据。更新检查仍需应用范围内的设备标识符,以便 Capgo 选择正确的更新并统计月活跃设备数。

本指南中介绍的 子处理者列表 是我们关于供应商、处理地点、传输机制及变更历史的最新公开权威来源。

我可以在涉及 HIPAA 敏感数据的应用中使用 Capgo 吗?

标题为“我可以将 Capgo 用于 HIPAA 敏感应用吗?”的章节

可以,但您的合规负责人需要选择合适的部署模式。Capgo Cloud 目前并未被定位为符合 HIPAA 的托管统计处理服务。默认情况下,更新器数据按设备划分,不与已知的应用用户关联,许多团队已成功采用这种模式。

对于更严格的审查,您可以按地域本地化插件流量,通过设置 statsUrl 为空字符串来禁用统计,只自托管统计端点,或使用授权自托管。请勿调用 CapacitorUpdater.setCustomId(...) 并传入邮箱、用户 ID、患者 ID、员工 ID 或任何能把更新器遥测数据关联到具体个人的值。

查看 HIPAA 合规 以了解完整技术配置和禁用统计后的可观测性取舍。

我可以把 Capgo live update 数据保存在欧洲吗?

标题为“我可以将 Capgo live update 数据保留在欧洲吗?”的章节

可以。需要让 Capgo Cloud 插件流量满足欧盟数据驻留要求的应用,可以将更新器端点设为欧盟主机:

  • updateUrl: https://plugin.eu.capgo.app/updates
  • statsUrl: https://plugin.eu.capgo.app/stats
  • channelUrl: https://plugin.eu.capgo.app/channel_self

同时使用这三个欧盟 URL,以便更新检查、统计数据和频道自动分配使用相同的区域数据路径。由于这些值位于 capacitor.config.ts,生产环境移动应用需要原生发布,现有安装才能使用新端点。

查看 数据位置 查看 Capacitor 和 Electron 的完整示例。

目前,Capgo 支持 Android、iOS 和 Electron。它们均已达到生产就绪状态。

在 iOS、Android 或 Electron 上使用 Capgo 可以是独立的决策。您可以为 Android 设置频道策略,为 App Store 构建 ipa,或按需设置 Electron 频道。

Capgo 可以(相对轻松地)扩展以支持桌面或嵌入式目标。如果这对您很重要,请告诉我们。

Capgo 如何与 Play Testing Tracks 或 Apple TestFlight 配合使用?

章节标题为“Capgo 如何与 Play 测试轨道或 Apple TestFlight 交互?”

每个应用商店都有各自独立的机制,用于向有限用户组分发应用(例如“内部测试”、“封闭 Beta”等)。这些机制都是将用户分组,并向各组分别分发特定版本应用的方式。

遗憾的是,并非所有这些机制都允许第三方检测应用是否安装在特定测试轨道中,或是否通过 TestFlight 安装。因此,我们无法可靠地了解这些用户组的构成,也无法基于这些组可靠地限制对 Capgo 补丁的访问。 https://stackoverflow.com/questions/53291007/can-an-android-application-identify-the-test-track-within-google-play https://stackoverflow.com/questions/26081543/how-to-tell-at-runtime-whether-an-ios-app-is-running-through-a-testflight-beta-i

如果你想细分 Capgo bundle 的可用性,有 4 种可选方案:

  1. 为每个组使用独立的 channel。这是最直接的方法,但需要你管理多个 channel。你可能已经有可用性不同的 dev channel 和 prod channel。这样,你可以先更新 dev channel,验证后再单独更新 prod channel。我们建议在版本控制中使用 branches / tags,帮助追踪与每次发布关联的源码。
  2. 跟踪你自己的选择加入用户群,禁用自动更新,并仅通过以下方式为特定用户触发更新: @capgo/capacitor-updater 该功能目前可用,但需要你自行管理选择加入列表。
  3. Capgo 支持按设备创建自己的选择加入机制(类似 Test Tracks 或 TestFlight,但不限平台)。这样你的 QA 团队就能在 bundle 向公众发布前选择加入。
  4. 使用 渐进式发布 将候选 bundle 推送给某个 channel 中随机且固定的用户子集。设置 0–100% 的发布比例,或使用 --rollout-percentage-bps 以 0.01% 为增量;可配置 60 秒到 365 天的缓存时长,以及可选的自动暂停策略。此功能不会选择指定名称的设备组。

你可以随时在 dashboard 中升级或降级方案: https://console.capgo.app/settings/organization/plans。升级会立即生效。降级会在当前计费周期结束时生效。

如果我达到了 MAU 上限会怎样?

章节标题:“如果我达到 MAU 上限会怎样?”

Capgo 会在你的 MAU 用量达到上限的 50%、70%、90% 和 100% 时给你发邮件。一旦达到上限,Live Updates 会被阻止,直到当前计费周期结束。升级到更高方案或购买 credits 以恢复更新服务。请参阅 Capgo 价格 以及 定价 了解方案档位。

除法律要求外,已支付的订阅费用不予退还。部分退款申请可能由 Capgo 自行决定逐案审核。请联系 支持团队 如果您认为自己符合条件。

账单周期每月自动重置,重置日期为您首次订阅 Capgo 的当天。例如,如果您在 15 日订阅,账单周期将在每月 15 日重置。

你可以随时在 dashboard 中取消订阅: https://console.capgo.app/settings/organization/plans

可以。你可以选择按年计费,在 组织计划设置中.

哪些内容计入存储空间,我们可以更改保留期吗?

标题为“哪些内容计入存储,以及我们能否更改保留策略?”的章节

存储包括跨你的各个渠道保留的历史 bundle 及其 Delta 资源。你可以在 App Settings 中按应用控制未使用 bundle 的保留策略。关联到活跃渠道或 rollout 的 bundle 会受到保护,因此仍可用于下发和回滚。

区域复制会增加存储或带宽消耗吗?

标题:“区域复制会让存储或带宽成倍增加吗?”

不会。无论由哪些区域提供服务,一个 bundle 在存储中只计一次。带宽也不会因区域而倍增:参见 带宽是如何计算的?.

带宽只计入设备实际从 Capgo 下载的文件:

  • 增量更新: 使用以下方式上传时 --delta,设备仅下载自其已有版本以来发生变化的文件。只有这些文件会计入带宽。未更改的文件(如大图片或字体)不会再次下载,也不产生费用。参见 增量更新.
  • 边缘缓存: 如果请求的文件或完整 zip 已在边缘缓存,则该下载不计入带宽。Delta 文件和完整 zip 都适用。
  • 断点续传: 如果下载中断,设备会从中断处继续。已下载的部分不会重复下载,也不会重复计入带宽。
  • 完整 zip: 未使用...上传的 bundles --delta或使用不支持 Delta 的插件版本的设备,会下载完整 zip。只有未从边缘缓存提供时才会计入带宽。

为降低带宽,请使用...上传 --delta 并将很少变动的大型资源放在稳定的文件路径中。

Enterprise SLA 包含哪些内容?

“Enterprise SLA 包含哪些内容?”章节

Enterprise 版本承诺生产平台每月 99.9% 的可用性。若未达到该承诺,将根据每月可用性提供 10% 至 30% 的服务抵扣额度。初始支持响应目标为:P1 级:1 小时(24/7/365);P2 级:2 个工作小时;P3 级:1 个工作日;P4 级:2 个工作日。请阅读 企业级 SLA 以了解完整条款。

您 dashboard 中的统计数据每天 UTC 午夜更新。 统计数据根据独立 MAUs (滚动 30 天周期内活跃)计算得出。

设备 ID 的生成方式

“设备 ID 如何生成”章节

设备 ID 在首次运行时于设备本地生成,用于对每台设备的安装去重,并让我们可以按安装用户数(例如月活跃用户数)计费,而不是按补丁总数或补丁安装总数计费。

用 MAU 给 Capgo 定价比按安装量更合适,因为它更准确,也能反映每台设备 Capgo 的实际成本。

设备 ID 持久化:

  • iOS: 从 v7.25.0+ 开始,设备 ID 存储在 Keychain 中,普通重装后仍会保留。
  • Android: 请使用 v7.50.1+(或对应版本线的 v5.50.1+/v6.50.1+)。仅当 Android Backup/Restore 保留应用偏好设置时,设备 ID 才会恢复。
  • Electron: 设备 ID 存储在安全存储中。
  • Android 注意事项: 禁用备份、排除相关偏好设置或清除应用数据都会生成新的设备 ID。在 Android v7.25.0 至 v7.50.0 中,即使启用了备份,重装后仍可能生成新的设备 ID。

设备 ID 按应用隔离,支持 Live Update 下发和 MAU 去重;它不是广告标识符,也不是跨应用跟踪标识符。

应用通过 updater 或 stats 端点向 Capgo 上报后,设备 ID 才会出现在设备列表中。设备无需安装补丁即可出现在设备列表中。

为什么我的设备数与 MAU 不一致?

标题为“为什么我的设备数与 MAU 不同?”的章节

设备列表和 MAU 基于不同的信号。

设备列表显示每个设备的最新已知元数据,例如设备 ID、平台、插件版本、操作系统版本、原生版本、渠道、已安装的 bundle,以及可用时的请求国家/地区。请求国家/地区是指从由 Cloudflare 处理的、针对该设备的请求中收到的最新有效两位 code,而不是 GPS 或应用提供的位置。没有有效国家/地区的请求不会清除最后一个有效值。Capgo 会在应用上报时更新这些元数据,但重复上报相同元数据可能不会更改该行记录或其最后更新时间。

MAU 统计计费窗口内去重后的活跃设备数。即使设备元数据保持不变,活跃度也可能上升,因此设备数和 MAU 可能不同。

你可以为每个平台创建一个 channel,并在每个 channel 中禁用平台专属更新。

在 iOS channel 中禁用 Android 更新,在 Android channel 中禁用 iOS 更新。

然后为每个 channel 上传一个 bundle,让每个平台获得不同的更新。

如果两个平台需要相同的更新,可以将同一个 bundle 关联到多个 channel,无需复制 bundle。

如果你正在使用 常见问题 要规划 live update 的交付,请将其与 Capgo Live Update 用于 Capgo Live Updates 中的产品工作流, 概览 用于 Overview 中的实现细节, 功能 用于 Features 中的实现细节, 更新行为 有关 Update Behavior 中的实现细节,请参阅 更新类型 关于 Update Types 中的实现细节。