常见问题

如果您在这里找不到答案，请问！既可以提交问题，也可以在 Discord 工作。

什么是“code push”？

Code push，也被称为“远程更新”（OTA），是一项云服务，允许Capacitor开发者在生产环境中部署更新到他们的应用程序。Capgo目前支持Android、iOS和Electron。

“Code Push”是React Native社区中使用的部署功能名称的引用，从 Microsoft 和 Expo，两者都没有支持 Capacitor。

什么是bundle和release的区别？

我们使用“release”一词指的是为应用商店准备二进制文件。在后续生成bundle Capgo 时需要知道准确的二进制文件被发送到应用商店中。

我们使用“bundle”一词指的是一个补丁，可以应用到release中来更新它到最新的 code。 npx @capgo/cli@latest bundle upload 命令用于生成bundle从您的新本地 code，然后将其发送到您的用户。

是否有Delta更新文件路径限制？

Yes:

• 零字节文件： CLI 日志 Ignoring empty file... 并排除 Delta 清单中的空文件。它不会导致上传失败，因此一个空文件可以改变最终的包而不会停止您的部署。请勿在 Delta 包路径中包含零字节文件。
• 包含空格的路径： 当包路径包含空格时，Delta 上传会早早失败并显示明确的错误。请在上传 Delta 更新之前重命名文件或目录以移除空格。

查看 Delta 更新 的设置细节。

路线图是什么？

我们的项目板也公开，位置在： https://github.com/orgs/Cap-go/projects

我们的团队也在公开中，所以你可以随时看到我们在做什么。我们很乐意回答关于我们的路线图或优先级的任何问题，通过Github问题或 Discord.

你能用Capgo和你的团队一起工作吗？

是的！所有计划都支持无限开发者。我们只限制应用指标（MAU、存储和带宽）到每个组织。

查看 团队 更多信息。

Capgo会存储我的源code吗？

不。Capgo 服务器永远不会看到你的源 code。当你运行 npx @capgo/cli@latest bundle upload, Capgo 存储一个 zip 文件的最小化/编译的 code - 与浏览器接收到的相同的 code，而不是你的源 code。

为了额外的安全性，你有两个选项：

• 端到端加密: 在上传之前对你的包进行加密，保护它在存储和传输中，并防止第三方使用你的私钥生成有效的加密更新。这不会使已发布的 Web 资产无法逆向工程，因为公钥在分发的应用程序中。
• 外部 URL 上传: 将包存储在你的服务器上，并只向 Capgo 提供下载链接并选项 --external <url>

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

是否将包文件视为私密数据?

不。Bundle 文件是公共的 Web 资产，旨在让您的应用用户下载。任何知道 Bundle URL 的人都可以获取这些文件，Capgo 在设置和文档中告知用户这一点。

访问 Bundle 文件不被认为是数据泄露。不要将机密信息、凭据、个人数据或受管制数据放入应用程序包中。如果您需要为高安全性用例提供更强的保密性，请使用端到端加密，但仍然从安全报告的角度将运送的应用程序code和资产视为公共。

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

是。Capgo旨在从 CI 系统中使用。我们已经发布了一个关于 Android 和 Github Actions 和 iOS, 和 GitLab. 其他 CI 系统应该类似。

请勿犹豫联系我们关于 GitHub 问题或 Discord 如果您遇到任何问题。

如何与 Firebase Remote Config 或 Launch Darkly 相关?

Code 推送允许在设备上添加新 code / 替换 code。 Firebase Remote Config 和 Launch Darkly 都是配置系统。它们允许您更改应用程序的配置而无需发布新版本。它们不打算取代 code。

这会增加多少依赖项的脚步?

我最近没有测量，但我预计 code 推送库将在 Capacitor 应用程序中添加少于 1 兆字节。我们知道我们可以通过优先考虑大小来使其更小。如果大小是您阻塞的，请告诉我们!

Capgo 在 iOS 18.4 模拟器上是否可用?

不。由于影响 iOS 18.4 模拟器的上游问题，Capgo 在此模拟器上无法正常运行。请在真实设备上测试或使用不同的 iOS 模拟器版本。

查看 React Native 中的详细信息： facebook/react-native#50510

Does code push 与大型应用程序兼容吗？

是的。code push 无法更新的应用程序大小限制。如上所述 ，__CAPGO_KEEP_0__ 可以更改您的应用程序中的任何 JS __CAPGO_KEEP_1__ ，无论大小如何。, Capgo can change any JS code in your application regardless of size.

查看下文：

您可以用 Capgo code 推送什么？

我们看到各种用途，包括：

• 紧急修复生产应用程序。
• 将bug修复发送给使用较旧版本的应用程序的用户。
• 持续发送（例如，每小时）。

注意，大多数应用商店禁止发送 code，它会改变应用程序行为的方式。请参阅 下面的信息。 什么算作“MAU”（每月活跃用户）？

What counts as a “MAU” for Capgo?

MAU（每月活跃设备）是指在一个滚动的 30 天周期内与 Capgo 进行联系的不同设备。同一台物理设备用于两个不同的原生 app ID 计算一次，每个 app ID 不会合并。

如果您的版本仅在 web 层或更新路由上有所不同，请使用一个原生 app ID 和 "channels"。这样可以将版本归为一个 __CAPGO_KEEP_0__ 应用，并简化发布。使用不同的原生 app ID 时，版本需要一个独特的包 ID、签名身份、权限集或商店列表。 在 iOS 上，. That keeps the flavours under one Capgo app and makes releases simpler. Use separate native app IDs when a flavour needs a distinct bundle ID, signing identity, entitlement set, or store listing.

会在正常重装时使用 Keychain 保持随机的、应用范围的设备 ID。 在 Android 上，请使用 v7.50.1+ (或 v5.50.1+ ) channels channels v6.50.1+ 在这些发布线上，ID只在Android Backup/Restore保留应用偏好时才会恢复。禁用备份、排除这些偏好或清除应用数据会生成一个新的设备ID。更新应用程序不会创建一个新的设备ID。

测试和开发构建时，请在生产渠道上关闭开发构建和模拟器分发。控制分发，而不是MAU：设备仍然可以在联系Capgo时计算。为了将其排除在生产使用之外，请禁用实时更新，并不调用生产Capgo端点。见 测试本机构建无实时更新 关于具体设置的详细信息。

我们不能使用Capgo code推送的什么?

Capgo不能改变本机code，例如Java、Kotlin、Objective-C、Swift、本机插件或本机配置。这些更改需要发布一个新的本机应用程序。对于商店审查范围，请参见 App Store和Google Play政策.

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

不。简短规则：Capgo 可以将生成的 Web 构建文件夹，包括 HTML、CSS、JavaScript、资产和纯 JavaScript 包的更改，打包到输出中。更改 capacitor.config.ts、 npx cap sync native 插件配置、native 包安装或升级，以及需要通过 npx cap copy 或

The Capacitor configuration file is read at native build time and compiled into the native app binary. If you need to change your Capacitor configuration, you must:

1. __CAPGO_KEEP_0__ 配置文件在 native 构建时被读取并编译到 native 应用二进制文件中。如果您需要更改 __CAPGO_KEEP_1__ 配置，请务必： capacitor.config.ts 更新
2. 本地npx cap sync 重新构建您的 native 应用（
3. 后跟 native 构建

Does Capgo submit to the stores for me?

Capgo Build 可以编译和签署一个准备好的本机 iOS 或 Android 项目，并且在配置时将签名结果提交到 App Store Connect 或 Google Play。您可以保留现有的 CI 来处理私有依赖项、Web 构建、Capacitor 同步和自定义本机准备；Capgo 接收准备好的本机项目以进行本机构建步骤。

查看 Capgo Build 和 构建配置参考 以获取工作流和商店提交选项。

Capgo 在磁盘上存储什么并且在哪里？

Capgo 更新器（在您构建应用程序时包含在应用程序中）缓存了最新下载的捆绑包，仅允许 capacitor 加载 code。在 Android 上，这位于 /data/user/0/com.example.app/code_cache/capgo_updater 尽管该路径的基础由 Android 系统提供，并且可以在运行时动态更改。 在 iOS 设备上，数据存储在 Library/Application Support/capgo.

The Capgo 命令行工具（例如 npx @capgo/cli@latest bundle upload）在磁盘上安装在 npm 缓存中，您的登录信息存储在您的主目录中在 ~/.capgo.

如何与 Capacitor 热重载相关？

Capacitor 的热重载是一个仅在开发时可用的功能。 Code 推送是用于生产的。

热重载是 Capacitor 的一个功能，允许您在开发期间在设备上更改 code。它需要在您的本地机器上连接代理来构建 Capacitor 应用程序。

Code 推送是一个功能，允许您在生产中更改 code。我们将使用各种不同的技术来使其成为可能，取决于平台。

Capgo code 推送支持哪些类型的更改？

Capgo 可以更改任何 JS code 在您的应用程序中。这包括应用程序 code 和生成的 code。您还可以更新依赖项在 package.json 只要它们不需要原生 code 变化。

我们没有计划支持更改原生 code (例如 Android 上的 Java/Kotlin 或 iOS 上的 Objective-C/Swift)，并且工具将警告您如果它检测到您已更改原生 code 因为它不会包含在捆绑包中。

这个支持 Web 吗？

Code 推送不是 Web 需要的，因为 Web 已经以这种方式工作。当用户打开 Web 应用时，它会从服务器下载最新版本，如果需要。

如果您有使用 code 推送的 Web 的用例，我们很想知道！

这个会在 iOS、Android、Mac、Windows、Linux 等上工作吗？

是。

目前我们已经支持了Android、iOS和Electron的开发，code在这三个平台上都已经准备就绪了。

Capgo支持哪些操作系统版本？

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

Capacitor目前支持的Android版本为API22+，iOS版本为13.0+。 https://capacitorjs.com/docs/main/reference/support-policy

Capgo支持哪些Capacitor版本？

Capgo目前只支持Capacitor的最新稳定版本。我们也可以支持Capacitor的旧版本，但我们还没有建立必要的基础设施来维护这些旧版本。我们将来会支持更多的Capacitor版本，包括我们的企业客户的任何版本。 https://github.com/Cap-go/capgo/issues/1100

Capgo 跟踪 Capacitor 稳定版本并在稳定发布后几小时内进行更新。我们使用自动化系统进行这些更新，耗时几分钟。然后我们进行额外的手动验证步骤，最后发布到我们的服务器上。

如何与应用商店的审查流程或政策相关?

Capgo 只更新 Capacitor 网页层：HTML、CSS、JavaScript 和资产已经在应用的 WebView 中运行。它不会改变原生二进制文件、原生插件、权限、特权、签名或商店元数据。

对于每个原生变化和可能影响应用目的或功能的材料变化，请使用原生商店发布。保持更新在您提交并向用户透露的应用体验中。

Capgo 是否保证应用商店或谷歌商店的通过?

不。苹果和谷歌将每个应用和发布单独审查，Capgo 不能保证个别审查或审批结果。您的团队仍然负责应用的内容、披露、更新范围和遵守当前商店政策。

为了审查和发布计划，请直接阅读官方政策。 Apple App Store Review 指南 和 Google Play 设备和网络滥用政策.

我可以在我国使用 Capgo 吗?

我们尚未尝试限制任何国家对 Capgo 的访问。

我们认识到一些国家对从该国访问的 URL 有限制。 Capgo 目前使用 Cloudflare 云进行托管，包括 R2 存储和 Cloudflare 工作者。

以下 URL 由 Capgo 使用：

• https://api.capgo.app — 由命令行工具用于与 __CAPGO_KEEP_0__ 服务器以及用户设备上的 __CAPGO_KEEP_1__ 更新器进行交互，以检查更新。 npx @capgo/cli command line tools to interact with the Capgo servers as well as the Capgo updater on users’ devices to check for updates.
• https://*.r2.cloudflarestorage.com — 由命令行工具使用来上传和下载捆绑包 npx @capgo/cli 如果您国家的所有这些URL都可访问，那么__CAPGO_KEEP_0__应该可以正常工作。

If all of those URLs are accessible from your country, then Capgo should work.

我可以自己托管__CAPGO_KEEP_0__吗？

直接链接到我可以自己托管Capgo吗？

Yes. Enterprise supports licensed self-hosted Capgo deployments when you need to run the updater backend in your own infrastructure. See ，了解部署模型和端点。 是否__CAPGO_KEEP_0__推送需要互联网才能工作？

Does code push require the internet to work?

Yes。可以想象一下，运行一个服务器来分发更新，独立于一般互联网，但某种形式的网络连接是必要的，以便将更新传输到设备。

Capgo 如何受到网络连接缺乏的影响?

Capgo 更新器（在您使用 Capgo 构建应用程序时包含在您的应用程序中）旨在对网络连接问题具有抵抗力。

在默认更新行为中，当应用程序启动时，它会警告 Capgo 更新器，后者会启动一个单独的线程来向 Capgo 服务器发起网络请求，要求更新。我们故意使用单独的线程，以避免影响阻塞应用程序可能正在执行的其他任务。如果网络请求失败或超时，更新器将简单地尝试下次应用程序启动时再次检查。

Capgo 命令行工具（例如 npx @capgo/cli@latest bundle upload)需要网络连接才能正常工作。如果您正在使用 Capgo 分发应用程序，请确保您的 CI 系统具有网络连接。

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

我们的实现始终发送针对设备的更新，设备请求更新时始终更新到最新版本。因此，如果用户长时间不更新，他们将会错过中间的更新。

更新服务器可以更改以支持响应下一个增量版本或最新版本，根据您的应用程序的需求。请告知我们，如果替代更新行为对您很重要。

Capgo与Capacitor之间的关系如何？

Capgo是Capacitor的一个插件，添加了code推送。Capgo不是Capacitor的替代品。您可以继续使用您已经熟悉和喜欢的Capacitor工具。

我们跟踪Capacitor的最新稳定版本，并更新code推送插件以与其兼容。

更新何时发生？

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

也可以手动运行Capgo更新器使用 @capgo/capacitor-updater 通过包来实现，包括通过推送通知触发更新

Capgo更新器设计为，当网络不可用，服务器下线或无法访问时，应用程序将继续正常运行。即使您选择从我们的服务器删除更新，所有客户端也将继续正常运行

我们添加了回滚补丁的功能。最简单的方法是简单地将之前的捆绑包附加到您的频道中来撤销

我需要保留我的app_id密钥吗

不需要。 app_id 包含在您的应用程序中，安全公开。您可以将其添加到版本控制（甚至公开）中，不用担心有人访问它

拥有您的 app_id 可以从Capgo服务器获取最新版本的应用程序，但他们无法推送更新到您的应用程序或访问Capgo帐户的任何其他方面

什么信息发送到Capgo服务器

完整的数据清单、接口行为和隐私控制都在 遵从性.

设置 statsUrl: '' 以禁用明确的更新统计报告。您还可以将其发送到您控制的代理或端点;请参阅 statsUrl 在自托管基础设施中处理统计信息 。更新检查仍需要一个应用范围的设备标识符，以便__CAPGO_KEEP_0__可以选择正确的更新并衡量每月活跃设备。. Update checks still need an app-scoped device identifier so Capgo can select the correct update and measure monthly active devices.

是我们最新的公共真实来源，提供了供应商、处理位置、传输机制和变更历史等信息。 子处理器列表是我们最新的公共真实来源，提供了供应商、处理位置、传输机制和变更历史等信息。 子处理器列表是我们最新的公共真实来源，提供了供应商、处理位置、传输机制和变更历史等信息。

是否可以在HIPAA敏感应用中使用Capgo？

是，但您的合规负责人需要选择正确的部署模型。Capgo Cloud目前尚未作为HIPAA合规的托管统计处理器呈现。默认情况下，更新器数据是设备范围的，并且不与已知应用用户相关联，许多团队使用该模型成功。

对于更严格的审查，您可以地理定位插件流量，设置为空字符串来禁用统计，仅自主托管统计端点，或者使用许可的自主托管。不要调用 statsUrl ，使用电子邮件、用户ID、患者ID、员工ID或任何将更新器遥测映射回个人值。 CapacitorUpdater.setCustomId(...) 参见

HIPAA合规 了解完整的技术设置和统计禁用时的可观性权衡。 是否可以在欧洲保留__CAPGO_KEEP_0__实时更新数据？

直接链接到是否可以在欧洲保留Capgo实时更新数据？

Yes. Apps that need EU data residency for Capgo Cloud plugin traffic can set the updater endpoints to the EU host:

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

Use all three EU URLs together so update checks, statistics, and channel self-assignment use the same regional data path. Because these values live in capacitor.config.tsproduction mobile apps need a native release before existing installs use the new endpoints.

See Data Location for exact Capacitor and Electron examples.

What platforms does Capgo support？”

Currently, Capgo supports Android, iOS, and Electron. All are production-ready.

Use of Capgo for iOS, Android, or Electron can be independent decisions. You can set your channel strategy for Android and an ipa built to the App Store, or Electron channels, as needed.

Capgo 可以（相对容易地）支持桌面或嵌入式目标。如果这些对您很重要，请告知我们。

Capgo 与 Play Testing Tracks 或 Apple TestFlight 如何交互？

每个应用商店都有自己的机制来将应用分发给有限的用户组（例如“内部测试”、“封闭测试”等）。这些都是将用户分段并将特定版本的应用分发给每个组的机制。

遗憾的是，这些机制中并不是所有的机制都允许第三方检测应用是否安装在特定的测试轨道或通过 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 包的可用性，那么有 4 个潜在的选项：

1. 使用独立的频道为每个组。这种方法最直接，但需要您管理多个频道。您可能已经有一个dev频道和prod频道，具有不同的可用性。因此，您可以更新您的dev频道，验证它，然后单独更新您的prod频道。我们建议使用分支/标签在您的版本控制中帮助跟踪与每个发布相关的源代码。
2. 跟踪自己的优选用户，禁用自动更新，并仅在特定用户上触发更新。 @capgo/capacitor-updater package。这种方法今天有效，但需要您管理自己的优选用户列表。
3. Capgo允许在每个设备上创建自己的优选机制（类似于测试轨道或测试飞行，只不限于平台）。这允许您的QA团队在推广到公众之前优先选择捆绑包。
4. 使用 渐进式发布 来交付候选捆绑包到随机、粘性的一部分频道。设置一个滚动从0-100%，或使用 --rollout-percentage-bps 每0.01％的增量；配置缓存持续时间从60秒到365天，并可选自动暂停策略。这种方法不选择一个命名的设备组。

计费

如何升级或降级我的计划？

您可以在任何时候在您的控制台中升级或降级您的计划: https://console.capgo.app/settings/organization/plans

什么时候我的账单周期会重置?

Billing periods are reset automatically every month on the month you first subscribed to Capgo. For example, if you subscribed on the 15th of the month, your billing period will reset on the 15th of every month.

如何取消我的订阅?

您可以在任何时候在您的控制台中取消您的订阅: https://console.capgo.app/settings/organization/plans

是否可以预付一年费用?

是。您可以在组织计划设置中选择年度计费 什么算作存储，是否可以改变保留期?.

直接链接到什么算作存储，是否可以改变保留期?

区域复制是否会增加存储或带宽?

直接链接到区域复制是否会增加存储或带宽?

无论哪个区域提供它，一个捆绑包只会被计入一次存储。 Capgo 依赖于设备下载，这些下载不从边缘缓存中提供；缓存服务的交付不会计入 Capgo 带宽使用量。

该企业服务水平协议（SLA）包含哪些内容？

企业版包含生产平台的每月 99.9% 可用性承诺。如果承诺未能实现，服务信用计划基于每月可用性，范围为 10% 到 30%。初期支持响应目标为 P1：24/7/365 一小时内响应；P2：两小时内响应；P3：工作日内响应；P4：两工作日内响应。 企业级服务水平协议 为了查看完整条款。

统计和分析

在您的仪表盘中，数据每天凌晨 UTC 时间更新一次。数据是从独特的 月活跃用户数（MAUs） 指的是在最近的30天内活跃的用户数。

设备ID生成方式

设备ID在首次运行时在设备上生成，用于去重设备安装和根据已安装的用户数（例如月活跃用户数）进行计费，而不是根据总数或总数的安装数。

MAU is a better solution than number of installs to price Capgo, as it is more accurate and reflects the actual cost of Capgo per device.

设备ID持久性

• iOS: 从v7.25.0开始，设备ID存储在Keychain中，并在正常重装时保持有效。
• Android: 使用v7.50.1+（或v5.50.1+/v6.50.1+在这些发布线上）。设备ID仅在Android备份/还原保留应用首选项时才会恢复。
• Electron：设备ID存储在安全存储中。
• 安卓注意事项：禁用备份、排除相关首选项或清除应用数据会生成一个新的设备ID。安卓v7.25.0至v7.50.0版本可以在重新安装时即使备份启用也会生成一个新的设备ID。

设备ID是应用范围内的，支持实时更新和MAU去重；它不是广告或跨应用跟踪标识符。

设备列表在应用通过Capgo的更新器或统计端点检查入时会列出。设备不需要安装补丁就可以出现在设备列表中。

为什么我的设备号与MAU不一致？

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

设备列表显示每个设备的最新已知元数据，例如设备ID、平台、插件版本、OS版本、原生版本、通道、安装的捆绑包和可用请求国家。请求国家是最新有效的两位code从Cloudflare处理的请求中接收到的值，而不是GPS或应用提供的位置。没有有效国家的请求不会清除最后有效的值。Capgo会在应用检查入时更新此元数据，但重复检查入并报告相同元数据的请求可能不会改变行或其最后更新时间。

MAU 计数的是每个账期内的不同活跃设备。即使设备元数据保持不变，设备的活动也可能会增加，因此设备计数和 MAU 可能会不同。

如何为不同平台设置不同的更新方式?

您可以为每个平台创建一个频道，并在每个频道中禁用平台特定的更新。

在 iOS 频道中禁用 Android 更新，在 Android 频道中禁用 iOS 更新。

然后将每个频道的包上传以便为每个平台设置不同的更新。

如果您需要为两个平台设置相同的更新，则可以将一个包链接到多个频道。无需重复上传包。

继续阅读 FAQ

如果您正在使用 常见问题 为__CAPGO_KEEP_0__实时更新配置计划，连接它 Capgo实时更新 在Capgo实时更新中， 概览 在概览中的实现细节， 功能 在功能中的实现细节， 更新行为 在更新行为中的实现细节， 更新类型 在更新类型中的实现细节，