Migrate from AppFlow to Capgo

このプラグインのインストール手順と完全なマークダウンガイドを含むセットアップの質問をコピーする。

🚦 IonicはAppFlowの商用製品、Live Updatesを含むが、終了が発表されました。既存のプロジェクトは31 December 2027まで実行できますが、新規顧客は受け入れられず、機能の追加は計画されていません。このガイドでは、__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.

「移行の概要」のセクション

Capgo handles channels, bundle retention, rollbacks, analytics, and CLI uploads for you. Migration boils down to installing the plugin, calling CapacitorUpdater.notifyAppReady()AppFlowの自動バージョンマッチングに依存していた場合、__CAPGO_KEEP_0__は同じ機能を提供し、より高度な制御を提供します。詳細なアップデートの管理戦略については、

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

Note your AppFlow App ID, existing channels, and signing keys.
Export any bundle history you want to archive.
If you are using GitHub Actions or another CI provider, keep those pipelines—they will keep working with Capgo.

Step 1 – AppFlow SDK を Capgo に置き換える

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

That’s it. Capgo bundles the native code for both iOS and Android; no extra JavaScript helpers are required.

ステップ 2 – 最小構成 (手動フィールドなし)

既存の構成ブロックは広範です。Capgoはプロジェクトとチャンネルを自動検出するため、最小構成は次のようになります。

import { CapacitorConfig } from '@capacitor/cli'

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

export default config

構成のクイックリファレンス

イオニックアプリフロー設定	Capgoの同等	設定する必要がありますか?
`appId`	Capgo ダッシュボードで管理	プロジェクトを作成するときに自動的に提供されます
`channel` / `defaultChannel`	ダッシュボード内のチャンネル規則/API	オプションで指定可能; それ以外はサーバーから取得される。詳しくはバージョン対象設定複数バージョンの戦略については
`autoUpdateMethod`	`autoUpdate: true`	デフォルトで有効
`maxVersions`	保持ポリシー	中央で設定 (1 か月のデフォルト、24 か月の最大)
`enabled`	必要ない	Capgo チャンネルごとに利用可能性を切り替える

ステップ 3 – Call `notifyAppReady()` (必要な唯一のハック)

In Ionicのガイドでは、__CAPGO_KEEP_0__をwireします。 sync, download, そして reload, すると、splash screenを手動で非表示にします。Capgoは、上記のアクションをネイティブに実行します。アプリが準備できたことを確認するだけです。

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

CapacitorUpdater.notifyAppReady()

確認が来ない場合、Capgoは自動的にバンドルをロールバックします。

それがすべてです—Capgoはバックグラウンドチェック、splash screenの表示非表示、ロールバックをすべて管理してくれます。

オプション: splash screenが非表示になる前にロジックを実行する

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: JavaScriptが必要なく、デフォルトで有効です。

常に最新

AppFlow: ダウンロードと再読み込みを行うハンドラを追加します。 App.addListener('resume') configure
Capgo: auto-update が再開時に実行される。カスタムタイミングウィンドウを設定したい場合は、ハンドラーを追加してください。

オプション: マニュアル再開確認

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 AppFlow notifyAppReady(): ユーザーに質問し、呼び出し

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

AppFlow メソッド	Capgo の同等	必要ですか?
`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_KEEP_0__は自動的に: バージョン対象のガイドを参照してください。__CAPGO_KEEP_0__は自動的に:

Capgoは自動的に:

各種インストール毎にデバイスレベルでの監査ログを保持します。
あなたが計画の制限に近づくと、積極的にメールを送信します。
リリース中のブロックを避けるために、バーストクレジットを提供します。
18のグローバル地域で18の地域のレイテンシーメトリクスを公開します。 status.capgo.app/history.

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

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

よくある質問

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

Ionicは商用製品を含むAppFlowを終了し、オープンソースフレームワークに焦点を当てます。既存の顧客は、31年12月までライブ更新を使用できます。 しかし、新しい機能や顧客は受け付けられません。__CAPGO_KEEP_0__は、専用のネイティブOTAプラットフォームを提供して、この空白を埋めます。, but no new features or customers are accepted. Capgo fills that gap with a dedicated native OTA platform.

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

を呼び出し、最初のバンドルをアップロードするだけです。 notifyAppReady()お金を節約できますか?

節約できるお金はありますか?

Yes. AppFlowライブ更新は $499/月. Capgo starts at __CAPGO_KEEP_0__は $14/月 から始まり、使用ベースの価格で約$0.001/MAU

に下がります。

Because AppFlow is now in maintenance mode, migrating sooner gives you access to ongoing Capgo innovation. We recommend switching when it fits your release schedule. Our engineering team will help you plan the changeover so your CI/CD and deployments keep running.

「移行するときはいつですか?」のセクション

バージョン対象化ガイド - AppFlow-style バージョンマッチング戦略の深掘り
変更点 - メジャーバージョンアップデートの管理にチャンネルを使用する
チャンネル管理 - チャンネル構成の完全なリファレンス

必要な助け

マイグレーションセッションの予約: book.capgo.app/demo
コミュニティに参加: Capgo Discord
問題発生を追跡 / 機能の要求: github.com/Cap-go/capacitor-updater

Capgoは、ネイティブのデルタ更新、暗号化されたバンドル、連続的な革新が必要な企業向けに設計されています。マイグレーション後は、AppFlowの接着剤codeを削除できます。ネイティブの自動化に頼り、無中断に配信を続けます。