AppFlowからCapgoに移行する

このプラグインのセットアッププロンプトをコピーして、インストール手順とフルマークダウンガイドを取得します。

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

AppFlowの商用製品、Live Updatesを含む、商用製品の提供を終了することを発表しました。既存のプロジェクトは2027年12月31日まで実行できますが、新規顧客の受付は停止し、新機能の開発は計画されていません。

Capgoはチャンネル、バンドル保持、ロールバック、アナリティクス、CLIのアップロードを自動的に行ってくれます。マイグレーションは、プラグインのインストール、コール、オプションのマニュアルコントロールの設定（必要に応じて）に過ぎません。以下のセクションでは、各タスクを直接実行します。 CapacitorUpdater.notifyAppReady()バージョン対象化Like AppFlow

セクションのタイトル “ステップ 0 – Capture your current AppFlow setup”

App ID 、既存のチャンネル、署名キーを含めて。, existing channels, and signing keys.
アーカイブしたいバンドル履歴をすべてエクスポートしてください。
CIツールとしての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の同等	__CAPGO_KEEP_0__を設定する必要がありますか?
`appId`	Capgoダッシュボードで管理	プロジェクトを作成すると自動的に提供されます
`channel` / `defaultChannel`	APIダッシュボード/チャネルルール	オプションのオーバーライド; デフォルトはサーバーから取得します。参照バージョン対象複数バージョンの戦略のために
`autoUpdateMethod`	`autoUpdate: true`	デフォルトで有効
`maxVersions`	保持ポリシー	中央で設定 (1 か月のデフォルト、24 か月の最大)
`enabled`	必要ない	Capgo チャンネルごとに利用可能性を切り替える

ステップ 3 – 呼び出し `notifyAppReady()` (必要な唯一のハック)

イオニクスのガイドでは、 sync, download、 reload, then hide the splash screen manually. Capgo performs those actions natively. You only need to confirm the app is ready:

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

CapacitorUpdater.notifyAppReady()

If the confirmation never arrives, Capgo rolls the bundle back automatically.

それが終わり—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は3つの戦略を記述しています。ここではCapgoにどのようにマップされるかを説明します。

背景 (デフォルト)

AppFlow: 設定 autoUpdateMethod = background, 呼び出し sync() 手動で実行
Capgo: __CAPGO_KEEP_0__

Always latest

AppFlow: __CAPGO_KEEP_0__ App.addListener('resume') __CAPGO_KEEP_0__
: CapgoOptional: __CAPGO_KEEP_0__

Copy to __CAPGO_KEEP_0__

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 })
  }
})

__CAPGO_KEEP_0__

AppFlow: ユーザーに質問し、呼び出し reload().
Capgo: ダッシュボードで「必須」としてマークし、次にリスンするイベント ( majorAvailable ) を発行して、ユーザーに質問または強制する notifyAppReady()ステップ 5 – __CAPGO_KEEP_0__ の呼び出しをマッピングする

ステップ 5 – API の呼び出しをマッピングする

__CAPGO_KEEP_0__ の等価値	Capgo equivalent	Do you need it?
`LiveUpdates.sync()`	自動で処理される	Capgoのネイティブな自動更新は、手動のSyncコールなしで実行される
`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 のグローバル地域で、18 のグローバル地域の遅延メトリクスを公開します。status.__CAPGO_KEEP_0__.app/history Publishes latency metrics for 18 global regions at capgo..

Ionic エンタープライズプラグイン

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

よくある質問

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

Ionic は、オープンソースフレームワークに焦点を当てて、商用製品を中止することを決定しました。既存の顧客は、ライブ更新を使用することができますが、2027 年 12 月 31 日までに 2027年12月31日が新機能や顧客を受け付けていない場合、Capgoは専用のネイティブオーバー・ザエア(OTA)プラットフォームを補完する。

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

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

お金を節約できますか。

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

どの時点で移行するのが適切でしょうか?

AppFlowは現在メンテナンスモードにあります。早期に移行することで、継続的なCapgoの革新にアクセスできます。リリーススケジュールに合わせて切り替えることをお勧めします。エンジニアリングチームはCI/CDとデプロイメントを継続させるために移行計画を支援します。

追加リソース

バージョン対象指南 - AppFlowスタイルのバージョンマッチング戦略の深い理解
バージョン変更 - チャンネルを使用したメジャーバージョンアップデートの管理
チャンネル管理 - チャネル構成の完全なリファレンス

お困りの場合は?

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

Capgoは、企業向けにネイティブのデルタ更新、暗号化されたバンドル、連続的な革新を必要とするエンジニアリングされています。移行した後は、AppFlowの接着剤codeを削除できます。ネイティブの自動化に頼り、停止なしで継続して配信できます。