从 AppFlow 迁移到 Capgo

复制一个包含安装步骤和本插件的完整Markdown指南的设置提示.

🚦Ionic宣布AppFlow的商业产品，包括实时更新，正在停止。现有项目可以运行到 2027年12月31日但不接受新客户，也没有计划新功能。这份指南将指导您迁移到 Capgo 并突出了您获得的本机自动化。

迁移概述

Capgo 会为您处理通道、捆绑保留、回滚、分析和 CLI 上传。迁移简化为安装插件、调用 CapacitorUpdater.notifyAppReady()，并（如果需要）配置可选的手动控制。以下部分将逐步介绍每个任务。

步骤 0 – 捕获当前 AppFlow 设置

记下您的 AppFlow 应用 ID，现有的通道和签名密钥。
导出任何您想存档的捆绑包历史。
如果您正在使用 GitHub 动作或另一个 CI 提供商，请保留那些管道——它们将继续与 Capgo 一起工作。

Step 1 – Replace the AppFlow SDK with Capgo

npm uninstall @capacitor/live-updates
npm install @capgo/capacitor-updater
npx cap sync

完成了。 Capgo 为 iOS 和 Android 的本机 code 提供捆绑包;无需额外的 JavaScript 助手。

步骤 2 – 最小配置（无手动字段）

现有的配置块非常全面。 Capgo 会自动检测您的项目和频道，因此最小的配置是：

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
    },
  },
}

export default config

配置快速参考

Ionic AppFlow 设置	Capgo 的等效项	您需要设置它吗？
`appId`	在 Capgo 控制台中管理	在创建项目时自动提供
`channel` / `defaultChannel`	频道规则在控制台/API 中	可选覆盖；默认值来自服务器。请参阅版本目标为多版本策略服务
`autoUpdateMethod`	`autoUpdate: true`	默认启用
`maxVersions`	保留策略	中央配置（默认1个月，最大24个月）
`enabled`	不需要	Capgo 每个渠道切换可用性

步骤3 – `notifyAppReady()` (唯一必需的钩子)

在Ionic的指南中您会连接 sync, download, reload然后手动隐藏启动屏幕。 Capgo 会执行这些操作。您只需确认应用程序准备就绪：

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

如果确认信息从未到达，Capgo 将自动回滚捆绑包。

这就是它的用处—Capgo 会为您处理背景检查、启动屏幕可见性和回滚。

可选：在启动屏幕隐藏之前运行逻辑

import { CapacitorUpdater } from '@capgo/capacitor-updater'
import { SplashScreen } from '@capacitor/splash-screen'

CapacitorUpdater.addListener('appReady', () => {
  // Log diagnostics or run custom code if needed
  SplashScreen.hide()
})

CapacitorUpdater.notifyAppReady()

步骤 4 – 更新策略已翻译

AppFlow 文档提到三种策略。以下是它们如何映射到 Capgo:

背景（默认）

AppFlow: 给算器 autoUpdateMethod = background, 另号认论 sync() 此得得。
Capgo: 当前给算器当前常用。不会用系统代码。

全一有更新

安全工具: 深定一个 App.addListener('resume') 李器为给算器和加线。
Capgo: 自动更新得得。当前常用得得。请得得一个服务时间。

Optional: 手动检查简历

import { App } from '@capacitor/app'
import { CapacitorUpdater } from '@capgo/capacitor-updater'

App.addListener('resume', async () => {
  const bundle = await CapacitorUpdater.download()
  if (bundle) {
    await CapacitorUpdater.set({ id: bundle.id })
  }
})

强制更新

AppFlow:提示用户并调用 reload().
Capgo:在仪表板中将捆绑包标记为“强制”，然后监听事件（在 majorAvailable )后发射，提示或强制用户在您的应用程序中 notifyAppReady()步骤 5 – 将__CAPGO_KEEP_0__调用映射

标题：步骤 5 – 将API调用映射

AppFlow 方法	Capgo 的等效	您需要它吗？
`LiveUpdates.sync()`	已自动处理	Capgo 的原生自动更新不需要手动同步调用
`LiveUpdates.download()`	`CapacitorUpdater.download()`	自定义流程可选
`LiveUpdates.reload()`	`CapacitorUpdater.set()`	自定义流程可选；仪表盘开关可强制更新
`LiveUpdates.getVersion()`	`CapacitorUpdater.current()`	可选诊断

第 6 步 – 使用 Capgo CLI 或 API 部署

通过上传 Capgo CLI 或 API 的捆绑包完成迁移。工作流程与您以前编写的脚本类似，但现在包括原生的安全措施：

capgo login                # authenticate once
capgo bundle upload \
  --path dist \
  --channel production     # automatically tags platform/version

版本特定部署（如 AppFlow）

如果您需要针对特定的本机版本（类似于 AppFlow 的本机版本锁定）：

# Only deliver to devices on native version 2.0.0 or higher
capgo bundle upload \
  --path dist \
  --channel production \
  --native-version "2.0.0"

# Use channels for different major versions
capgo bundle upload --channel v2  # for app version 2.x
capgo bundle upload --channel v3  # for app version 3.x

参见版本目标指南，了解全面策略。

Capgo 自动执行：

在每次安装时保留设备级审计日志。
在您接近计划限制时发送主动邮件。
为您提供突发的信用额度，以确保您在发布过程中不会被阻塞。
发布18个全球区域的延迟指标 status.capgo.app/history.

Ionic企业插件

如果您的Ionic堆栈还使用企业插件，请遵循以下针对性的迁移文档。每个指南建议Capgo替换和下一步。

常见问题

AppFlow为什么关闭实时更新?

ionic 正在停止商业产品，包括 AppFlow，来专注于他们的开源框架。现有客户可以继续使用实时更新直到 31 December 2027,但不会接受新的功能或客户。Capgo 填补了这一空白，提供了一个专门的原生 OTA 平台。

迁移需要多长时间？

大多数团队在一天内就完成了迁移。概念，如通道、发布和发布规则直接映射，我们的团队提供了文档和实践支持。在许多情况下，您只需安装插件、调用 notifyAppReady()，并上传您的第一个包。

我们会节省多少钱？

是的。AppFlow 实时更新从 $499/mo. Capgo 开始于 $14/mo 使用基于使用量的定价，价格会降低到大约 $0.001/MAU. 您还获得加密、自动回滚和全球延迟监控。

何时迁移?

由于 AppFlow 进入维护模式，迁移越早，您就可以获得持续的 Capgoinnovation。我们建议在您的发布计划中切换。我们的工程团队将帮助您规划更改以确保 CI/CD 和部署继续运行。

额外资源

版本目标指南 - 深入了解 AppFlow 风格的版本匹配策略
Breaking Changes - 使用频道管理主要版本更新
Channel Management - 频道配置参考指南

需要帮助?

预约迁移会话： book.capgo.app/demo
加入社区： Capgo Discord
跟踪问题/请求功能： github.com/Cap-go/capacitor-updater

Capgo 为企业客户提供原生增量更新、加密包和持续创新。迁移后，您可以删除 AppFlowglue code，依赖原生自动化，并保持不间断的发布。