AppFlowからCapgoへの移行

AppFlow設定リファレンス

移行前に、現在のcapacitor.config.tsのAppFlow設定を確認してください：

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    LiveUpdates: {
      appId: 'your-app-id',
      channel: 'Production',
      autoUpdateMethod: 'background', // または 'always latest'、'force update'
      maxVersions: 2
    }
  }
};

この設定は、AppFlowの機能をCapgoの同等の機能にマッピングする際に役立ちます。

アップデート戦略の移行

バックグラウンドアップデート（デフォルト）

AppFlowのデフォルトのバックグラウンドアップデートを使用している場合：

// Capgoでの同等の設定（capacitor.config.ts）
{
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false,
      autoDeletePrevious: true
    }
  }
}

強制アップデート

AppFlowの強制アップデート戦略を使用している場合：

// Capgoでの同等の設定（capacitor.config.ts）
{
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: true,
      keepUrlPathAfterReload: true
    }
  }
}

// 必要なJavaScriptコード
import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { SplashScreen } from '@capacitor/splash-screen';

CapacitorUpdater.addListener('appReady', () => {
  SplashScreen.hide();
});

CapacitorUpdater.notifyAppReady();

常に最新版

AppFlowの「always latest」戦略を使用している場合、Capgoでは以下のように実装します：

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

async function setupAlwaysLatest() {
  App.addListener('resume', async () => {
    const result = await CapacitorUpdater.download({
      url: 'your-update-url'
    });
    if (result) {
      await CapacitorUpdater.set({ id: result.id });
    }
  });
}

APIメソッドの移行

AppFlowメソッド	Capgo同等メソッド	備考
`sync()`	`download()`	新しいアップデートをダウンロード
`reload()`	`set()`	アップデートを即時適用
`setConfig()`	`setChannel()`	チャネル設定を更新

移行例

// AppFlowコード
import * as LiveUpdates from '@capacitor/live-updates';
const result = await LiveUpdates.sync();
if (result.activeApplicationPathChanged) {
  await LiveUpdates.reload();
}

// Capgo同等コード
import { CapacitorUpdater } from '@capgo/capacitor-updater';
const bundle = await CapacitorUpdater.download({
  url: 'your-update-url'
});
if (bundle) {
  await CapacitorUpdater.set({ id: bundle.id });
}

Capgoへ移行する理由

Ionic AppFlowのサービス終了に伴い、Capgoへの移行によってモバイルアプリ開発ワークフローをスムーズに移行できます。Capgoは、重要な機能をすべて維持しながら、機能の向上、パフォーマンスの改善、大幅なコスト削減を提供します。

主なメリット

より高速なアップデート配信（10分から1分未満へ）
より手頃な価格（499ドル/月から14ドル/月へ）
すべてのプランにエンドツーエンド暗号化を含む
アップデートチャネルの制御性向上
包括的なCI/CD統合オプション

移行手順

1. ライブアップデートの移行

既存の依存関係を削除

npm uninstall @ionic/appflow
# capacitor.config.jsonからAppFlow固有の設定を削除

Capgoのインストール

npm install @capgo/capacitor-updater
npx cap sync

設定の更新

capacitor.config.jsonにCapgoの設定を追加：

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true
    }
  }
}

2. CI/CDの移行

Capgoは柔軟なCI/CDオプションを提供：

オプション1：既存のCI/CDを使用

人気のプラットフォームでCI/CDを設定する詳細なチュートリアル：

オプション2：CI/CDサービス

マネージドサービスで私たちがCI/CD設定を代行します。

3. チャネル設定

Capgoダッシュボードでチャネルを作成：

npx @capgo/cli channel create production
npx @capgo/cli channel create staging

チャネル設定の構成：

# プロダクションチャネルの設定
npx @capgo/cli channel update production --no-downgrade --no-upgrade

# ステージングチャネルの設定
npx @capgo/cli channel update staging

4. 移行のテスト

ライブアップデートのテスト

# テストバンドルの作成とアップロード
npx @capgo/cli bundle create --channel staging

アップデート受信の確認

テスト端末にアプリをインストール
アップデートが正しく受信されることを確認
アップデートのインストールプロセスを確認
リカバリー機能をテスト

トラブルシューティング

一般的な問題

アップデートが受信されない

チャネル設定の確認
デバイスログの確認
ネットワーク接続の確認
バンドルバージョン形式の検証

次のステップ

移行時に専任サポートが必要な企業チームは、チームとの通話を予約してください。