AppFlowからCapgoに移行する

インストールステップとこのプラグインの完全なマークダウンガイドを含むセットアッププロンプトをコピー

🚦 ionicは、AppFlowの商用製品、包括Live Updatesが終了することを発表しました。既存のプロジェクトは31年12月まで実行できますが、新規顧客は受け入れられず、新機能は計画されていません。このガイドでは、__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_KEEP_0はチャンネル、バンドル保持、ロールバック、分析、およびCAPGO_KEEP_1__のアップロードを管理します。移行はプラグインのインストールとコールのみです。

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
GitHub の Actions または他の CI プロバイダーを使用している場合、そのパイプラインをそのままにしておきます。それらは Capgo とともに機能します。

Step 1 – AppFlow の SDK を 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

設定のクイックリファレンス

イオニックアプリフロー設定	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 は自動的にバンドルをロールバックします。

Optional: スプラッシュ画面が隠される前にロジックを実行する

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 にどのようにマップされるかを説明します。

背景 (デフォルト)

: 設定: 呼び出し autoUpdateMethod = background手動で。 sync() __CAPGO_KEEP_0__
Capgo: __CAPGO_KEEP_0__ する必要があります。JavaScript は必要ありません。

Always latest

AppFlow: __CAPGO_KEEP_0__ を追加して、ダウンロードして再読み込みするハンドラーを追加します。 App.addListener('resume') __CAPGO_KEEP_0__
CapgoOptional: manual resume check

Copy to clipboard

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

Section titled “Force update”

AppFlow:ユーザーに質問し、呼び出し reload().
Capgo:ダッシュボードで「必須」とマークし、次に majorAvailable イベント ( notifyAppReady()) が発生した後、ユーザーに質問したり強制したりする

Step 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 自動的に:

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

イオニックエンタープライズプラグイン

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

よくある質問

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

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

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

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

お金を節約できますか?

はい。AppFlowライブアップデートは $499/月から始まります。Capgoは $14/月 から始まり、使用ベースの価格設定により約 $0.001/MAU. You also gain encryption, automatic rollbacks, and worldwide latency monitoring.

何時を選択して移行するか

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

追加リソース

バージョン対象指南 - AppFlowスタイルのバージョンマッチング戦略の深い理解
バージョン変更 - メジャーバージョンアップデートをチャンネルで管理する
チャンネル管理 - チャンネル構成の完全な参照

お困りですか？

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

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