Capawesome CloudからCapgoに移行する

このプラグインのインストールステップとフルマークダウンガイドのセットアッププロンプトをコピーする

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

概要

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

Capgo を使用すると、プラグインをインストールするだけで済みます。 Everything else—チャンネル、バンドルクリーンアップ、ロールバック、アナリティクス、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.

__CAPGO_KEEP_0 は自動チャンネル、バンドルクリーンアップ、ロールバック、アナリティクス、CAPGO_KEEP_1__ のアップロードをネイティブに実行します。

プロジェクトが Capacitor 5 以上を使用していることを確認してください。
CI/CDからバンドルをプッシュする場合にのみ、Capgo CLI (npm install -g @capgo/cli)をインストールしてください。

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

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

これが唯一の必須のスワップです。Capgo のネイティブ code はプラグインとともに配布されており、追加の JavaScript ヘルパーは必要ありません。

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

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

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, 保存期間ポリシーなど) としてリストアップしているすべてのものは、Capgo ダッシュボードまたは API で管理されます。Capgo のデフォルトの動作と異なる動作を実現したい場合は、のみこれらのキーを上書きする必要があります。

構成のクイックリファレンス

Capawesome オプション	Capgo の同等	設定する必要がありますか?
`appId`	Capgo ダッシュボードでプロジェクトを作成すると、Capgo ダッシュボードから取得します。	複数のプロジェクトを 1 つのバイナリに使用する場合のみ
`defaultChannel`	Channel rules managed in the dashboard/API	オプション; 多くのチームはサーバーサイドで設定
`autoDeleteBundles`	`autoDeletePrevious: true` (デフォルト)	既に有効
`publicKey`	Capgoコンソールで管理	キーを手動で回転する場合のみ
`maxVersions` /保持	バンドル保持ポリシー	Capgoで中央に設定 (1 か月のデフォルト、24 か月の最大)

ステップ 3 – Call `notifyAppReady()` (唯一の必須のフック)

The old workflow introduced custom listeners (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はバックグラウンドチェック、スプラッシュの表示、ロールバックをネイティブで処理します。

オプション：スプラッシュが隠される前にカスタムロジックを実行

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

ステップ 4 – API の呼び出しをマップする（ほとんどの場合、オプション）

Capgoでは通常、自動アップデータを実行しますが、完全な制御を得るには手動APIを使用できます。

Capawesome Cloud	Capgoの同等	必要ですか？
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	独自のダウンロードワークフローを実装する場合のみ
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	オプション：ネイティブの自動更新は既にダウンロードしています
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	オプション：ダッシュボードは自動でバンドルを固定します
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	オプション；Capgoは必須のバンドルを強制します `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	オプション：診断

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

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

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

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

Step 5 – Capgo のアップデート戦略: Capgo がどのように対応するか

Capawesome は 3 つの戦略をドキュメントしています。それらはどのように翻訳されるかを以下に示します。

バックグラウンド更新

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

強制更新

前回のワークフロー：ワイヤーロジックとリロードを強制する
Capgo：ダッシュボードで「必須」としてのBundleをマークし、次にイベント（ majorAvailable ）をリスンして、アップグレードをユーザーに強制する notifyAppReady()Step 6 – Bundleのデプロイ

Step 6 – Bundleのデプロイのセクション

、__CAPGO_KEEP_0__は類似の__CAPGO_KEEP_1__ワークフローを提供し、また__CAPGO_KEEP_2__を使用してデプロイを完全に自動化することもできます。 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.app/history.

移行計画

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

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

Capgo サポート

マイグレーションコンシェルジュ: __CAPGO_KEEP_0__.app/demo でセッションを予約 book.capgo.app/demo.
: __CAPGO_KEEP_0__ Discord に参加問題追跡 Capgo.
__CAPGO_KEEP_1__: github.com/Cap-go/capacitor-updater/issues.

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

Capawesome CloudからCapgoに進みましょう。

__CAPGO_KEEP_0__を使用している場合 Capawesome CloudからCapgoに進みましょう。 __CAPGO_KEEP_0__ CI/CDと連携してCI/CDの計画を行います。 Capgo CI/CDの製品ワークフロー Capgo Native Buildsの製品ワークフロー Capgo Native Buildsの製品ワークフロー Capgo Integrations Capgoの統合製品ワークフローにおけるCapgo統合のために CI/CD統合 CI/CD統合の実装詳細のために__CAPGO_KEEP_0__統合のために GitHubアクション統合アクション統合の実装詳細のためにGitHub