Migrate from AppFlow to Capgo

インストール手順とこのプラグインのマークダウンガイドの全体を含む設定プロンプトをコピーする

🚦 ionicは、AppFlowの商用製品、Live Updatesを含む、が終了することを発表しました。既存のプロジェクトは2027年12月31日まで実行できますが、 2027年12月31日新規顧客の受付は停止し、新機能の開発は計画されていません。このガイドでは、Capgoへの移行のための必要なアクションを説明し、ネイティブの自動化を強調しています。

移行概要

Capgoはチャンネル、バンドル保持、ロールバック、アナリティクス、CLIのアップロードを管理します。移行はプラグインのインストール、 CapacitorUpdater.notifyAppReady()を呼び出し、必要に応じてオプションのマニュアルコントロールを設定することだけです。以下のセクションでは、各タスクを直接説明します。

Step 0 – AppFlowの現在の設定をキャプチャする

既存のバンドル履歴をエクスポートして保存しておきます。 CIプロバイダー（__CAPGO_KEEP_0__ Actionsや他のCIプロバイダー）を使用している場合は、パイプラインをそのままにしておきましょう。__CAPGO_KEEP_1__と互換性があります。Step 1 – AppFlowの設定をCapgoに移行する
Step 2 – Capgoの設定を確認する
If you are using GitHub Actions or another CI provider, keep those pipelines—they will keep working with 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 ヘルパーは必要ありません。

Step 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`	Not required	Capgo のチャンネルごとに利用可能性を切り替えます

Step 3 – __CAPGO_KEEP_0__ を呼び出してください `notifyAppReady()` (必要な唯一のハック)

Ionic のガイドでは、__CAPGO_KEEP_0__ を 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 – Capgo にアップグレードする

Capgo では、AppFlow が提案する 3 つのアップグレード戦略を使用します。以下に、各戦略が Capgo にどのように対応するかを示します。

バックグラウンド (デフォルト)

AppFlow: 設定 autoUpdateMethod = background, 呼び出し sync() 手動で。
Capgo: デフォルトで有効です。JavaScript は必要ありません。

AppFlow

__CAPGO_KEEP_0__:ユーザーに質問し、呼び出し reload().
Capgo:バンドルを「必須」とマークし、ダッシュボードでリスンし、 majorAvailable イベント (Capgoのバンドルがダウンロードされた後) notifyAppReady()ユーザーをアプリ内に促すか強制する

Step 5 – Mapping API calls

AppFlowのメソッド	Capgo equivalent	必要ですか?
`LiveUpdates.sync()`	自動で処理される	Capgo’s native auto-update runs without a manual sync call
`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 自動的に:

__CAPGO_KEEP_0__ は、デバイスごとのアクセスログをすべてのインストールで保持します。
__CAPGO_KEEP_0__ は、計画上限に近づいたときに自動的にメールを送信します。
__CAPGO_KEEP_0__ は、リリース中断を防ぐためにクレジットを提供します。
__CAPGO_KEEP_0__ は、18 のグローバル地域でレイテンシーメトリクスを公開します。 status.capgo.app/history.

「Ionic エンタープライズプラグイン」のセクション

Ionic スタックもエンタープライズプラグインを使用している場合、以下のターゲットマイグレーションドキュメントを参照してください。各ガイドでは、Capgo の置き換えと次のステップを推奨しています。

よくある質問

AppFlowがライブ更新を停止する理由は何ですか?

Ionicは、商用製品であるAppFlowを含む、オープンソースフレームワークに焦点を当てて、商用製品を廃止することを決定しました。既存の顧客は、ライブ更新を使用することができますが、 2027年12月31日新しい機能や顧客を受け付けることはありません。Capgoは、専用のネイティブOTAプラットフォームを提供することで、この空白を埋めます。

マイグレーションにはどれくらいの時間がかかります?

ほとんどのチームは、1 日以内に移行を完了します。チャンネル、デプロイ、リリースルールなどの概念は直接対応し、チームはドキュメントの提供とハンドオンサポートを提供します。多くの場合、単にプラグインをインストールし、 notifyAppReady()を呼び出し、最初のバンドルをアップロードするだけです。

お金を節約できるのですか？

はい。AppFlowのライブアップデートは $499/moから始まります。Capgoは $14/mo から始まり、使用ベースの価格設定により約 $0.001 per MAUに下がります。加えて、暗号化、自動ロールバック、世界中のレイテンシーモニタリングも利用できます。

アップグレードするときはいつ?

AppFlowはメンテナンスモードに移行したため、早くアップグレードすると、継続的なCapgoの革新にアクセスできます。リリーススケジュールに合わせてアップグレードすることをお勧めします。エンジニアリングチームは、CI/CDとデプロイが正常に動作するように、変更を計画してくれます。

追加リソース

バージョン対象化ガイド - AppFlowスタイルのバージョンマッチング戦略の深掘り
変更点 - メジャーバージョンアップデートをチャンネルで管理する
チャンネル管理 - チャンネル構成の完全な参考資料

必要な支援があります。

ブックする移行セッション: book.capgo.app/demo
コミュニティに参加する: Capgo Discord
問題を追跡 / 機能の要求: github.com/Cap-go/capacitor-updater

Capgo is engineered for enterprises that need native delta updates, encrypted bundles, and continuous innovation. Once you migrate you can delete the AppFlow glue code, rely on native automation, and keep shipping without interruption.