AppFlow から Capgo への移行

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

バージョン対象化 Like AppFlow

Capgoは、AppFlowの自動バージョンマッチング（ネイティブバージョンに基づいて互換性のある更新を配信）に依存していた場合に、同じ機能を強化された制御で提供します。詳細な更新管理戦略については、 バージョン対象化ガイド 複数のアプリバージョン間で更新を管理するための詳細な戦略については、

ステップ 0 – 現在のAppFlow設定をキャプチャ

• AppFlowの App ID既存のチャンネル、署名キーを記録してください。
• アーカイブしたいバンドル履歴をエクスポートしてください。
• GitHubアクションまたは他の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 はプロジェクトとチャンネルを自動検出するため、最小限の構成は:

capacitor.config.ts

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	保持ポリシー	中央で構成 (1 か月のデフォルト、24 か月の最大)
enabled	Not required	Capgo がチャンネルごとに利用可能性を切り替えます

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

Ionic のガイドでは、 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 – 翻訳された戦略を更新する

AppFlow は 3 つの戦略を文書化しています。 以下に、それらが Capgo にどのようにマップされるかを示します。

背景（デフォルト）

• AppFlow：設定 autoUpdateMethod = background：呼び出し sync() 手動で。
• Capgo：デフォルトで有効。 JavaScript が必要ありません。

常に最新

• AppFlow：ダウンロードと再読み込みを実行するハンドラーを追加します。 App.addListener('resume') __CAPGO_KEEP_0__
• 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 })
  }
})

強制更新セクション

• __CAPGO_KEEP_0__:ユーザーに質問し、呼び出し reload().
• Capgo:ダッシュボードで「必須」とマークし、次にイベント ( majorAvailable ) が発生した後、ユーザーをアプリ内で促すか強制する notifyAppReady()Step 5 – __CAPGO_KEEP_0__ の呼び出しをマッピングする

セクションのタイトル “Step 5 – API の呼び出しをマッピングする”

__CAPGO_KEEP_0__ の同等	Capgo equivalent	自動的に処理される
LiveUpdates.sync()	__CAPGO_KEEP_0__ のネイティブな自動更新は、手動の 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__ は、各インストールごとにデバイスレベルの監査ログを保持します。
• __CAPGO_KEEP_0__ は、計画上限に近づいたときに、積極的にメールを送信します。
• __CAPGO_KEEP_0__ は、リリース中のブロックを避けるために、バーストクレジットを提供します。
• __CAPGO_KEEP_0__ は、18 のグローバル地域で、18 のグローバル地域の遅延メトリックを公開します。 status.capgo.app/history.

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

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

• Ionic Secure Storageからマイグレーション
• Ionic Auth Connectからマイグレーション
• Ionic Identity Vaultからマイグレーション

よくある質問

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

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

マイグレーションにはどれくらいの時間がかかります?

Most teams complete the move in under a day. Concepts such as channels, deployments, and release rules map directly, and our team provides documentation plus hands-on support. In many cases you simply install the plugin, call notifyAppReady(), and upload your first bundle.

Most teams complete the move in under a day. Concepts such as channels, deployments, and release rules map directly, and our team provides documentation plus hands-on support. In many cases you simply install the plugin, call

Will we save money? Section titled “Will we save money?”. Capgo starts at Yes. AppFlow live updates start at $499/mo . __CAPGO_KEEP_0__ starts at$14/mo

都に安全だ、サイスに設定です。

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.

サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です。

• サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です。 サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です。
• サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です。 サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です。
• サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です。 サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です。

サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です、サイスのアサイスタイバートのサイスにいるだ。サイスを設定です。

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

Capgoは、エンタープライズ向けに開発された、ネイティブのデルタ更新、暗号化されたパッケージ、連続的な革新を必要とする企業向けに設計されています。移行後は、AppFlowの接着剤codeを削除できます。ネイティブの自動化に頼り、無中断に配信を続けることができます。

Migrate from AppFlow to Capgo から続ける:

AppFlowを使用している場合: AppFlowからCapgoに移行する: 企業移行とエンタープライズオペレーションを計画するには、 Capgo エンタープライズ Capgo エンタープライズの製品ワークフロー向けに Ionic エンタープライズ プラグインの代替 Ionic エンタープライズ プラグインの代替の製品ワークフロー向けに Capgo 代替 Capgo 代替の製品ワークフロー向けに Capgo コンサルティング Capgo コンサルティングの製品ワークフロー向けに Capgo プレミアム サポート Capgo プレミアム サポートの製品ワークフロー向けに