Capgo への Capawesome Cloud の移行

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

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

概要

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

Capgo を使用すると、プラグインをインストールして呼び出すだけで済みます。すべての他の機能—チャンネル、バンドルクリーンアップ、ロールバック、アナリティクス、Capgo のネイティブ自動化—is handled natively. 以下のセクションでは、各タスクを直接実行します。 CapacitorUpdater.notifyAppReady(). Everything else—channels, bundle cleanup, rollbacks, analytics, and CLI automation—is handled natively. The sections below walk through each task directly.

開始する前に

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

That is the only mandatory swap. Capgo’s native code ships with the plugin; no extra JavaScript helpers are required.

ステップ 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__ を削除することができます。

マニュアルコントロールの例

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

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がどのように対応するか（ステップ5）

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

バックグラウンド更新

前のワークフローcodeをcodeに設定して、ダウンロードを手動でスケジュールする。
Capgo__CAPGO_KEEP_0__autoUpdate: truecodeはデフォルトで有効です（」）。追加のcodeが必要ありません。

常に最新

前のワークフロー: 追加する 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 – 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.

インベントリ & インストール

設定 & 可用性: 5 分 (npm install正常性チェック
__CAPGO_KEEP_0____CAPGO_KEEP_0__notifyAppReady).
__CAPGO_KEEP_0__: 15 分 (オプションのマニュアルテストまたはリスナー).
初回デプロイ: 10 分で Capgo CLI または CI統合で完了。

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

Capgo サポート

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

Capgoは長期的な信頼性向上のために設計されています:ネイティブのデルタ更新、暗号化されたパッケージ、自動ロールバック、およびカスタムJavaScriptが必要ない分析。マイグレーション後は、メンテナンス負荷の高い接着剤を削除して、プラットフォームが自動的に更新を実行できるようにします。