Capgo への Capawesome Cloud の移行

このプラグインのインストール手順と全マークダウンガイドを含む設定の質問をコピーしてください。

⚡️ Capgo は自動チャンネル、バンドルクリーンアップ、ロールバック、分析、CLI のネイティブアップロードを実行します。このガイドを使用して、最小限の手順で移行し、必要に応じてカスタム動作を再作成することができます。

概要

既存のCapawesome Cloud設定（アプリID、チャンネル、署名キー、CLI トークン）を収集して、後でアーカイブまたは監査することができます。
Capgo プラグインをインストールし、Capawesome SDK を削除し、 CapacitorUpdater.notifyAppReady().
オプションの動作を構成（マニュアルダウンロード、バンドルピン、リロード）を行う場合は、現在依存しているフローを実行します。

Capgo を使用すると、プラグインをインストールし、 CapacitorUpdater.notifyAppReady()のみで済みます。チャンネル、バンドルクリーンアップ、ロールバック、分析、CLI のネイティブ自動化はすべて、ネイティブで処理されます。以下のセクションでは、各タスクを直接実行します。

始めましょう

Capacitor 5 以上をすでに使用しているプロジェクトがあれば、問題ありません。
Capgo CLI (npm install -g @capgo/cli) をインストールする必要があります。CI/CD からバンドルをプッシュする場合。

ステップ 1 – Capgo をインストールし、Capawesome SDK を削除します。

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

Capgo のネイティブ code はプラグインとともに提供されます。追加の JavaScript ヘルパーは必要ありません。

ステップ 2 – 最小限の設定

前のセットアップでは、数十のオプションをマッピングする必要がありました。 capacitor.configCapgoは、プロジェクトを自動的に認識するので、最小限の構成は次のようになります。

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
      periodCheckDelay: 10 * 60 * 1000, // optional: check every 10 minutes
    },
  },
}

export default config

Capawesomeがすべてのマニュアルフラグ (defaultChannel, autoDeleteBundles, retention policies, etc.) is managed through the Capgo dashboard or API. You only need to override these keys if you want behaviour that differs from Capgo’s defaults.

これらのキーをオーバーライドする必要があるのは、__CAPGO_KEEP_2__のデフォルトの動作と異なる動作を実現したい場合のみです。

「構成のクイックリファレンス」のセクション	Capgo equivalent	__CAPGO_KEEP_0__の同等
`appId`	Taken from the Capgo dashboard once you create a project	複数のプロジェクトを 1 つのバイナリで使用する場合のみ
`defaultChannel`	API ダッシュボードで管理されるチャネル規則	オプション; 多くのチームはサーバー側で設定
`autoDeleteBundles`	`autoDeletePrevious: true` (デフォルト)	既に有効
`publicKey`	Capgo コンソールで管理	キーを手動でローテートする場合のみ
`maxVersions` /保持	バンドル保持ポリシー	Capgo で中央に構成 (1 か月のデフォルト、24 か月の最大)

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

古いワークフローではカスタムリスナー (checkForUpdates(), retryDownload(), hiding the splash screen, etc.). Capgo performs those steps natively. The only API you must call is:

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

CapacitorUpdater.notifyAppReady()

This confirms the app booted successfully. If the confirmation never arrives, Capgo automatically rolls back the bundle—no extra JavaScript needed.

アプリが正常に起動したことを確認します。確認が来ない場合は、Capgo は自動的にバンドルをロールバックします—追加の JavaScript は必要ありません。

それがすべてです—__CAPGO_KEEP_0__ はバックグラウンドチェック、スプラッシュ画面の表示、ロールバックをネイティブで実行します。

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

CapacitorUpdater.addListener('appReady', () => {
  // Run diagnostics or logging if you need to
  SplashScreen.hide()
})

CapacitorUpdater.notifyAppReady()

Step 4 – Map API calls (mostly optional)

セクションのタイトル “Step 4 – Capgo の呼び出しをマップする（ほとんどの場合オプション）”

__CAPGO_KEEP_0__ では通常、自動アップデータを実行しますが、完全な制御を得るには手動 API を使用できます。	Capgo equivalent	__CAPGO_KEEP_0__ が必要ですか?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	__CAPGO_KEEP_0__ を実装する際にのみ
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	オプション: 自動更新が既にダウンロードしている場合
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	オプション: ダッシュボードが自動でバンドルを固定します
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	オプション; Capgo は必須のバンドルを強制します `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	オプション:診断

__CAPGO_KEEP_0__ を削除することができます。

「__CAPGO_KEEP_0__」の手動制御の例

最新のバンドルをダウンロード

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

const downloadUpdate = async () => {
  const latest = await CapacitorUpdater.getLatest()
  if (latest?.url) {
    const bundle = await CapacitorUpdater.download({
      url: latest.url,
      version: latest.version,
    })
    console.log('Bundle downloaded', bundle?.id)
  }
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const downloadUpdate = async () => {
  const result = await LiveUpdate.fetchLatestBundle()
  if (result.downloadUrl) {
    await LiveUpdate.downloadBundle({
      bundleId: result.bundleId,
      url: result.downloadUrl,
    })
    console.log('Bundle downloaded')
  }
}

次のバンドルを設定

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

const setNextBundle = async () => {
  await CapacitorUpdater.next({ id: 'bundle-id-123' })
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const setNextBundle = async () => {
  await LiveUpdate.setNextBundle({ bundleId: 'bundle-id-123' })
}

ダウンロードしたバンドルを即時適用

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

const applyUpdate = async () => {
  await CapacitorUpdater.reload()
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const applyUpdate = async () => {
  await LiveUpdate.reload()
}

Capgoのアップデート戦略: これがCapgoがどのように対応しているか

__CAPGO_KEEP_0__は3つの戦略を文書化しています。ここではそれらをどのように翻訳するかを説明します。

バックグラウンド更新

前のワークフローcodeで設定して、ダウンロードを手動でスケジュールする。
Capgo__CAPGO_KEEP_0__がデフォルトで有効になっているため、追加の__CAPGO_KEEP_0__が必要ありません。autoUpdate: true). No additional code required.

Capawesomeは3つの戦略を文書化しています。ここではそれらをどのように翻訳するかを説明します。

前のワークフロー: 追加する App.resume リスナーを呼び出し download, すると set.
Capgoバックグラウンドの自動更新は、再開後すぐにチェックを実行します。カスタム間隔を使用したい場合は、手動リスナーが必要です。

オプション: 手動再開チェック

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

App.addListener('resume', async () => {
  const latest = await CapacitorUpdater.getLatest()
  if (latest?.url) {
    const downloaded = await CapacitorUpdater.download({
      url: latest.url,
      version: latest.version,
    })
    if (downloaded) {
      await CapacitorUpdater.next({ id: downloaded.id })
    }
  }
})

強制更新

前のワークフロー: wire prompt logic and enforce reload.
Capgo: majorAvailable をマークし、ダッシュボードで強制的に再読み込みするようにします。次に、 notifyAppReady()イベント (

) が発生した後、ユーザーにアプリ内でアップグレードするように求める必要があります。

セクション「Step 6 – Deploying bundles」 capawesome live-update deploy, Capgo offers a similar CLI workflow, and you can also automate deployments entirely via API.

# Authenticate once (stores a token in your CI environment)
capgo login

# Upload a new bundle (auto-detects platform/version)
capgo bundle upload --path dist --channel production

Because Capgo tracks bundle health automatically, you also get:

デバイスレベルの監査ログは、すべてのインストールに適用されます。
自動的な保持期間 (1 か月がデフォルト) と、24 か月までのカスタマイズ可能な制限
リアルタイムのレイテンシーメトリクスは「status.__CAPGO_KEEP_0__.app/history」で確認できます。 status.capgo.app/history.

「移行計画」セクション

: 10 分 (: 旧プラグインを削除npm install設定 & 準備
: 5 分 (正常性チェックnotifyAppReady).
正常性チェック: 15 分 (オプションのマニュアルテストまたはリスナー).
最初のデプロイ: 10 分で Capgo CLI または CI統合で完了。

実際のチームは 1 時間以内に完了します。Capawesome プロジェクトの詳細を提供すると、チャンネルとデバイスリストをインポートすることもできます。

Capgo サポート

マイグレーションコンシェルジュ: __CAPGO_KEEP_0__ のデモセッションに予約する cal.com/team/capgo/demo.
コミュニティ: __CAPGO_KEEP_0__ Discord に参加する Capgo Discord.
問題追跡: github.com/Cap-go/capacitor-updater/issues.

Capgoは長期的な信頼性向上のために設計されています:ネイティブのデルタ更新、暗号化されたパッケージ、自動ロールバック、およびカスタムJavaScriptが必要ない分析。