Migrate from AppFlow to Capgo

このプラグインのインストールステップとフルマークダウンガイドのすべてのステップを含む設定プロンプトをコピーする

🚦 イオニクスは、AppFlowの商用製品、包括的にはライブアップデートが終了することを発表しました。既存のプロジェクトは, but no new customers are accepted and no new features are planned. This guide walks you through the actions required to migrate to Capgo and highlights the native automation you gain.

が終了しますが、新規顧客は受け入れられず、新機能は計画されません。このガイドでは、__CAPGO_KEEP_0__への移行に必要なアクションを説明し、ネイティブな自動化を強調しています。

Capgo handles channels, bundle retention, rollbacks, analytics, and CLI uploads for you. Migration boils down to installing the plugin, calling CapacitorUpdater.notifyAppReady()、そして必要に応じてオプションのマニュアルコントロールを設定する。以下のセクションでは、各タスクを直接説明します。

バージョン対象設定ガイド

Step 0 – Capture your current AppFlow setup Step 0 – Capture your current AppFlow setup注意：AppFlow
App ID、既存のチャンネル、署名キーを記録しておきます。
Capgoを使用している場合は、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ヘルパーは必要ありません。

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`	保持ポリシー	__CAPGO_KEEP_0__で中央に設定されます (1 か月のデフォルト、24 か月の最大)
`enabled`	必要ありません	Capgoはチャンネルごとに利用可能性を切り替えます

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

Ionicのガイドでは、__CAPGO_KEEP_0__で sync, download、そして reload、をワイヤーします。 Capgoは、スプラッシュ画面を非表示にするためのアクションを実行します。 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 へのアップグレード

AppFlow documents three strategies. Here is how they map to Capgo:

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

AppFlow: 設定 autoUpdateMethod = background, 呼び出し sync() 手動で実行します。
Capgo__CAPGO_KEEP_0__

:

AppFlow: App.addListener('resume') ハンドラーを追加してダウンロードと再読み込み
Capgo:

自動更新は再開時から実行されます。ハンドラーを追加するのは、カスタムタイミングウィンドウを追加したい場合のみです。

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 – API の呼び出しをマッピングする

AppFlow方式	Capgo の相当物	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
# Channel must use metadata strategy: --disable-auto-update metadata
capgo bundle upload \
  --path dist \
  --channel production \
  --min-update-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 スタックがエンタープライズプラグインも使用している場合、以下のマイグレーションドキュメントを参照してください。各ガイドでは、Capgo の置き換えと次のステップを推奨しています。

よくある質問

AppFlow のライブ更新が終了する理由は何ですか?

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

移行にはどれくらいの時間がかかりますか?

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

お金を節約できますか?

はい。AppFlowのライブアップデートは 499ドル/月から始まります。Capgoは 14ドル/月 から始まり、使用ベースの価格設定により約 0.001 ドル/MAUAppFlowからCapgoへのアップグレード

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

AppFlowはメンテナンスモードに移行したため、早めにアップグレードすると、Capgoの継続的な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.

Migrate from AppFlowからCapgoに進む:

あなたはAppFlowを使用している場合 Migrate from AppFlow to Capgo をアップグレードして、__CAPGO_KEEP_0__と接続する Capgo Enterprise Capgo Enterprise イオニックエンタープライズプラグインの代替イオニックエンタープライズプラグインの代替 Capgo Alternatives Capgo Alternatives Capgo Consulting Capgo Consulting Capgo Premium Support Capgo Premium Support