常见问题

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

什么是“code push”?

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

“Code推送”是React Native社区中使用的部署功能名称 微软 和 Expo，但它们都没有支持Capacitor。

我是否需要将Capgo和CLI的版本匹配到我的插件或Capacitor版本?

No. Always use the latest Capgo CLI (npx @capgo/cli@latest). The CLI and Capgo Console follow their own versioning and stay compatible with any supported updater plugin major. Capgo plugins follow Capacitor majors; see Capgo 版本 为 LTS 标签，如 @lts-v7.

什么是捆绑包和发布之间的区别?

我们使用“发布”一词来指代为应用商店准备的二进制文件。在稍后生成捆绑包 Capgo 需要知道已向应用商店发送的确切二进制文件。

我们使用“捆绑包”一词来指代可以应用于发布以将其更新到新 code 的补丁。然后 npx @capgo/cli@latest bundle upload 命令用于从您的新本地 code 生成捆绑包，然后将其发送给您的用户。

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

是：

• 零字节文件： The 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/privacy

包文件是否是私密数据?

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

访问捆绑文件不被认为是数据泄露。不要将机密信息、凭据、个人数据或受管数据放入应用程序捆绑中。如果您需要为高安全性用例提供更强的保密性，请使用端到端加密，但仍然从安全报告的角度将发送的应用程序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 应用中添加小于 1MB 的依赖项。我们知道如何在此成为优先事项时减小其大小。如果大小是一个阻碍，请告诉我们!

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

Capgo 在 iOS 18.4 Simulator 上不工作。由于 iOS 18.4 Simulator 的上游问题，Capgo 在此环境下无法可靠地运行。请在真实设备或使用不同版本的 iOS 模拟器上测试。

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

code push 与大型应用程序是否兼容？

是的。code push 没有应用程序大小限制。如上所述，code 可以更改您的应用程序中的任何 JS __CAPGO_KEEP_1__，无论大小如何。 注意：应用程序越大，用户下载更新的难度越大。我们建议您尽可能保持应用程序的大小。您可以使用 Capgo code push 进行什么？

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ push 的用途是什么？

Capgo code push 的用途

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

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

注意，大多数应用商店禁止发送 code，该内容会显著改变应用程序的行为。请参阅 以下 内容

What counts as a “MAU” for Capgo?

A MAU 是一个月度活跃设备。一个在 Capgo 的滚动 30 天期间与之联系的设备被视为一个 MAU，用于该本地应用 ID。同一物理设备用于两个不同的本地应用 ID，仅计算一次；它们不会在它们之间进行重复计算。

如果您的风味仅在其 web 层或更新路由上有所不同，请使用一个本地应用 ID， 渠道。这样可以将风味放在一个 Capgo 应用中，发布更简单。使用不同的本地应用 ID，当一个风味需要一个不同的包 ID、签名身份、权限集或商店列表时。

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

测试和开发构建时，请在生产渠道上关闭开发构建和模拟器分发。控制分发，而不是MAU：设备仍然可以在联系Capgo时被计算。为了将其排除在生产使用之外，请禁用实时更新，并且不要调用生产Capgo端点。请参见 测试本机构建无实时更新 for the exact settings.

What can’t we use Capgo code push for?

关于Capgo code推送我们不能使用什么? __CAPGO_KEEP_0__不能改变本机__CAPGO_KEEP_1__，例如Java、Kotlin、Objective-C、Swift、本机插件或本机配置。这些更改需要发布一个新的本机应用程序。对于商店审查范围，请参见.

Can I update capacitor.config.ts changes via Capgo?

No. Short rule: Capgo 可以发送生成的 Web 构建文件夹，包括 HTML、CSS、JavaScript、资产和纯 JavaScript 包的更改，打包到该输出中。更改到 capacitor.config.ts或 npx cap sync native 插件配置、native 包安装或升级，以及必须更新 iOS 或 Android 项目的任何内容 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 app 二进制文件中。如果您需要更改您的 __CAPGO_KEEP_1__ 配置，请务必 capacitor.config.ts 更新
2. 本地npx cap sync 重建您的 native app（
3. 后跟 native 构建）

Does Capgo submit to the stores for me?

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

查看 Capgo Build 和工作流和商店提交选项的构建配置参考。 什么__CAPGO_KEEP_0__在磁盘上存储和在哪里? 直接链接到什么__CAPGO_KEEP_0__在磁盘上存储和在哪里?

Section titled “什么Capgo在磁盘上存储和在哪里？”

The Capgo updater (included in your application when you build your app) caches the latest downloaded bundle in the only directory that capacitor allow to load code. On Android, this is located in /data/user/0/com.example.app/code_cache/capgo_updater __CAPGO_KEEP_2__ 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 (例如 Java/Kotlin 在 Android 或 Objective-C/Swift 在 iOS) 的更改，并且工具将警告您如果它检测到您已更改原生code，因为它将不会包含在捆绑包中。

这是否支持 Web?

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

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

这是否在 iOS、Android、Mac、Windows、Linux 等上工作?

是的。

到目前为止，我们已经专注于 Android、iOS 和 Electron 的支持，code推送在所有三个平台上都是生产就绪的。

什么操作系统版本Capgo支持?

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

Capacitor目前支持AndroidAPI级别22+和iOS 13.0+: https://capacitorjs.com/docs/main/reference/support-policy

什么版本的CapacitorCapgo支持?

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

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

How does this relate to the App/Play Store review process or policies?

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

请为每个原生更改和可能影响应用程序已审查目的或功能的材料更改使用原生商店发布。保持实时更新在您提交并向用户透露的应用程序体验中。

Does Capgo guarantee App Store or Google Play approval?

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

为了审查和发布计划，请直接阅读官方政策： Apple App Store Review Guidelines 和 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.
• — 由 — used by the npx @capgo/cli 命令行工具，用于上传和下载包装文件

如果您国家的所有这些URL都可访问，那么Capgo应该可以正常工作。

如果您的地区需要阻止访问任何这些URL，请告知我们，我们可以与您合作找到解决方案。代理服务器是其中一种选择。

我可以自己托管Capgo吗？

是的。企业版支持在您自己的基础设施中运行更新后端的许可自主托管Capgo部署。见 自主托管更新器 for the deployment model and endpoints.

Does code push require the internet to work?

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

网络连接不足会对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 can fetch the latest version of your app from Capgo servers, but they cannot push updates to your app or access any other aspect of your Capgo account.

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

__CAPGO_KEEP_0__服务器接收的完整数据清单、API端点行为和隐私控制都已在 合规.

设置 statsUrl: '' 来禁用明确的更新统计报告。您还可以将 statsUrl 发送到代理或您控制的端点；参见 在自托管基础设施中处理统计信息。更新检查仍然需要一个应用范围的设备标识符，以便Capgo可以选择正确的更新并衡量每月活跃设备。

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

我可以使用Capgo开发HIPAA敏感应用吗？

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

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

了解完整的技术设置和统计禁用时的可观性权衡。 是否可以在欧洲保留 __CAPGO_KEEP_0__ 实时更新数据? 直接链接到是否可以在欧洲保留 __CAPGO_KEEP_0__ 实时更新数据?

标题：是否可以在欧洲保留 Capgo 实时更新数据?

是的。需要欧盟数据存储的应用程序可以将更新端点设置为欧盟主机： Capgo

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

使用所有三个EU URL一起，以便更新检查、统计和频道自我赋值使用相同的区域数据路径。因为这些值存储在 capacitor.config.ts生产移动应用程序需要原生发布，才能让现有安装使用新的端点。

查看 数据存储位置 为精确的Capacitor和Electron示例。

Capgo 支持哪些平台?

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

使用 Capgo 的 Capgo 对 iOS、Android 或 Electron 的使用可以是独立的决定。您可以为 Android 设置您的渠道策略，并为 App Store 构建一个 ipa 文件，或者根据需要设置 Electron 渠道。

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

How does Capgo interact with Google Play Testing Tracks or 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 bundle的可用性进行分段，那么有4个潜在的选项：

1. 使用独立的频道为每个组。这种方法最直接，但需要您管理多个频道。您可能已经有一个dev频道和一个prod频道，具有不同的可用性。因此，您可以更新您的dev频道，验证它，然后单独更新您的prod频道。我们建议使用分支/标签在您的版本控制中帮助跟踪与每个发布相关的源代码。
2. 通过 @capgo/capacitor-updater package
3. Capgo allow creare its own opt-in mechanism on a per-device basis (similar to Test Tracks or TestFlight, just platform agnostic). This allow your QA team to opt-in to bundle before they’re promoted to the general public.
4. __CAPGO_KEEP_0__允许创建自己的优选机制，基于每个设备（类似于Test Tracks或TestFlight，只是平台无关）。这使您的QA团队可以在他们被推广到公众之前，优选bundle。 使用 渐进式发布 --rollout-percentage-bps 向随机、粘性频道的子集发送候选包。设置从0-100%的发布范围，或者使用

以0.01%的增量发布；配置缓存持续时间从60秒到365天，并可选自动暂停策略。这不选择一个命名的设备组。

账单页面的账单部分标题（Terms of Service Subscriptions Billing Subtitle）

您可以在您的控制台中随时升级或降级您的计划: 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_KEEP_0__.app/settings/organization/plans https://console.capgo.app/settings/organization/plans

是否可以预付一年费用?

是。您可以在组织计划设置中选择年度计费 组织计划设置.

什么会计入存储，是否可以改变保留期限?

是否会将区域复制存储或带宽乘以?

区域复制是否会将存储或带宽乘以?

不。无论服务区域在哪个区域，存储只计算一次，Capgo带宽基于下载设备，而不是缓存边缘缓存的下载。缓存服务的传递不计入Capgo带宽使用量。

What does the Enterprise SLA include?

Enterprise SLA包括99.9%的每月可用性承诺。 如果承诺未能实现，服务的信用计划将根据每月可用性从10%到30%进行调整。初期支持响应目标为P1：24小时/7天/365天；P2：两小时；P3：一天；P4：两天。 详细条款请参见 Enterprise SLA for the complete terms.

Stats and analytics

在您的仪表板中，统计数据每晚UTC更新。统计数据是从不同 月活跃用户数 指的是在过去的 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存储在安全存储中。
• Android注意事项禁用备份、排除相关偏好或清除应用数据会生成一个新的设备 ID。Android v7.25.0至v7.50.0版本可以在启用备份的情况下重新安装后生成一个新的设备 ID。

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

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

为什么我的设备号与我的MAU不一样?

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

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

MAU统计会根据计费时间窗口统计设备的活动次数。即使设备元数据保持不变，设备活动也可能会增加，因此设备数量和MAU可能会不同。

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

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

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

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

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

继续阅读FAQ

如果您正在使用 常见问题解答 为了计划实时更新的发布,连接它 Capgo 实时更新 为了产品工作流程在 Capgo 实时更新中 概述 为了概述的实现细节 功能 为了功能的实现细节 更新行为 为了更新行为的实现细节,和 更新类型 为了更新类型的实现细节。