メインコンテンツへスキップ

AppFlowからCapgoへの移行

🚦 Ionic は、Live Update を含む AppFlow の商用製品が終了することを発表しました。既存プロジェクトは 2027年12月31日まで実行可能ですが、新規顧客の受け入れや新機能の追加は予定されていません。このガイドでは、Capgo への移行に必要な手順と、得られるネイティブ自動化について説明します。

Capgo は、チャネル、バンドルの保持、ロールバック、分析、および CLI アップロードを管理します。移行は、プラグインのインストールと CapacitorUpdater.notifyAppReady()の呼び出し、および必要に応じて任意の手動コントロールの設定に集約されます。以下のセクションで各タスクを順を追って説明します。

  • AppFlow の以下の情報を控えておいてください: App ID、既存のチャンネル、および署名キー。
  • アーカイブしたい bundle の履歴があればエクスポートしてください。
  • GitHub Actions や他の CI プロバイダーを使用している場合、それらの pipeline はそのまま維持してください。Capgo でも引き続き動作します。

ステップ 1 – AppFlow の SDK を Capgo に置き換える

「ステップ 1 – AppFlow の SDK を Capgo に置き換える」というセクション
ターミナル
npm uninstall @capacitor/live-updates
npm install @capgo/capacitor-updater
npx cap sync

以上です。Capgo は iOS と Android 両方のネイティブ code をバンドルします。追加の JavaScript ヘルパーは不要です。

ステップ 2 – 最小限の設定(手動入力なし)

セクション「Step 2 – 最小構成(手動フィールドなし)」

既存の設定ブロックは広範です。Capgo はプロジェクトとチャネルを自動検出するため、最小構成は以下の通りです:

capacitor.config.ts
import { CapacitorConfig } from '@capacitor/cli'
const config: CapacitorConfig = {
plugins: {
CapacitorUpdater: {
autoUpdate: true,
autoDeletePrevious: true,
},
},
}
export default config
Ionic AppFlow 設定Capgo 相当設定は必要ですか?
appIdCapgo ダッシュボードで管理プロジェクト作成時に自動で設定されます
channel / defaultChannelダッシュボードのチャネルルール/API任意のオーバーライド。デフォルトはサーバーから取得されます。次を参照 バージョンターゲティング マルチバージョン戦略については
autoUpdateMethodautoUpdate: trueデフォルトで有効
maxVersions保持ポリシー一元管理(デフォルト1ヶ月、最大24ヶ月)
enabled不要Capgoでチャネルごとに利用可否を切り替え

ステップ3 – 呼び出し notifyAppReady() (唯一の必須フック)

「ステップ 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 – アップデート戦略の変換

「ステップ 4 – アップデート戦略の変換」セクション

AppFlow では 3 つの戦略を説明しています。Capgo では次のように対応します:

  • AppFlow:設定 autoUpdateMethod = background、呼び出し sync() を手動で行います。
  • Capgo:デフォルトで有効。JavaScriptは不要です。
  • AppFlow:〜を追加 App.addListener('resume') ダウンロードしてリロードするハンドラー。
  • Capgo: auto-update は resume 時に既に実行されます。カスタムのタイミングウィンドウが必要な場合のみハンドラーを追加してください。
オプション: 手動の resume チェック
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: ダッシュボードで bundle を「mandatory」としてマークし、次の majorAvailable イベント(〜の後に発行)をリッスンします notifyAppReady()) アプリ内でユーザーにプロンプトを表示したり、強制更新させたりするために使用します。

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

セクション「ステップ 5 – API コールのマッピング」
AppFlow メソッドCapgo 相当必要ですか?
LiveUpdates.sync()自動処理Capgo のネイティブ自動更新は、手動の同期コールなしで実行されます
LiveUpdates.download()CapacitorUpdater.download()カスタムフローでは任意
LiveUpdates.reload()CapacitorUpdater.set()任意。強制更新はダッシュボードのトグルで管理します
LiveUpdates.getVersion()CapacitorUpdater.current()任意の診断

ステップ 6 – Capgo CLI または API を使用してデプロイ

「ステップ 6 – Capgo CLI または API を使用したデプロイ」セクション

Capgo CLI または API で bundle を upload して移行を完了します。ワークフローは以前にスクリプト化した内容と同様ですが、ネイティブの安全策が追加されています:

ターミナル
capgo login # authenticate once
capgo bundle upload \
--path dist \
--channel production # automatically tags platform/version

バージョン指定のデプロイ(AppFlow と同様)

「バージョン指定のデプロイ(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リージョンのレイテンシ指標を以下で公開しています: capgo アプリの履歴ステータス.

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

なぜAppFlowはLive Updateを終了するのですか?

「なぜAppFlowはLive Updateを廃止するのですか?」セクション

Ionicは、オープンソースフレームワークに注力するため、AppFlowを含む商用プロダクトを廃止します。既存の顧客は、Live Updateを 2027年12月31日まで引き続き利用できますが、新機能の追加や新規顧客の受け入れは行われません。Capgoは、専用のネイティブOTAプラットフォームとしてこのギャップを埋めます。

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

「移行にはどのくらい時間がかかりますか?」というセクション

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

コスト削減はできますか?

「コスト削減は可能か?」セクション

はい。AppFlowのライブアップデートは 月額499ドルからです。Capgoは 月額14ドル からで、従量課金制なら MAUあたり約0.001ドルまで下がります。さらに、暗号化、自動ロールバック、世界中のレイテンシ監視も利用できます。

いつ移行すべきですか?

「いつ移行すべきか?」セクション

AppFlowは現在メンテナンスモードにあるため、早めに移行すると、Capgoの継続的なイノベーションを利用できます。リリーススケジュールに合うタイミングでの切り替えをお勧めします。当社のエンジニアリングチームが、CI/CDとデプロイが止まらないよう、切り替え計画を支援します。

Capgo は、ネイティブのデルタアップデート、暗号化されたbundle、継続的なイノベーションを必要とするエンタープライズ向けに設計されています。移行後はAppFlowのグルーコード code を削除し、ネイティブな自動化に任せて、中断なくリリースを続けられます。

使用している場合 AppFlowからCapgoへの移行 移行とエンタープライズ運用を計画するには、次と連携してください Capgo エンタープライズ Capgo Enterprise のプロダクトワークフロー向けに、 Ionic Enterprise プラグインの代替案 Ionic Enterprise Plugin Alternatives のプロダクトワークフロー向けに、 Capgo の代替案 Capgo Alternatives でのプロダクトワークフロー向け、 Capgo コンサルティング Capgo Consulting でのプロダクトワークフロー向け、および Capgo プレミアムサポート Capgo Premium Support でのプロダクトワークフロー向け。