Capawesome CloudからCapgoに移行

インストール手順とこのプラグインのフルマークダウンガイドまでの手順を含むセットアップ用質問をコピーする。

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

概要

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

Capgo を使用すると、プラグインをインストールするだけで済みます。すべての残りの機能—チャネル、バンドルクリーンアップ、ロールバック、分析、Capgo の自動化—is Capgo ネイティブで処理されます。以下のセクションでは、各タスクを直接実行します。 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 以上を使用していることを確認してください。
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, 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	プロジェクトを作成すると、__CAPGO_KEEP_0__ ダッシュボードから取得できます
`defaultChannel`	Channel rules managed in the dashboard/API	オプション; 多くのチームはサーバーサイドで設定します
`autoDeleteBundles`	`autoDeletePrevious: true` (デフォルト)	既に有効
`publicKey`	Capgo コンソールで管理	キーを手動でローテートする場合のみ
`maxVersions` /保持	バンドル保持ポリシー	Capgo で中央で構成 (1 か月のデフォルト、24 か月の最大)

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

古いワークフローではカスタムリスナーを導入しましたcheckForUpdates(), retryDownload()表示を非表示にするなど、Capgoはネイティブで実行します。 API のみ呼び出す必要があります:

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

CapacitorUpdater.notifyAppReady()

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

それだけです—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()
}

ステップ 5 – 更新戦略: Capgo がどのように扱うか

Capawesome は 3 つの戦略を記述しています。それらはどのように翻訳されるかを以下に示します。

バックグラウンド更新

前回のワークフローcode で設定して、ダウンロードを手動でスケジュールする必要があります。
Capgo__CAPGO_KEEP_0__ がデフォルトで有効になっているため (autoUpdate: true)、追加の 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 })
    }
  }
})

強制更新

前のワークフロー: ワイヤーロジックを組み込み、再読み込みを強制。
Capgo: __CAPGO_KEEP_0__をダッシュボードで「必須」とマークし、 majorAvailable イベント（ notifyAppReady())を発生させて、アプリ内でユーザーにアップグレードするように求める。

ステップ 6 – バンドルを配布する

あなたが以前は capawesome live-update deploy、Capgoは類似のCLIワークフローを提供し、また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

Capgoが自動的にバンドルヘルスを追跡するため、次のことも得られます。

デバイスごとのアクセスログ
自動的な保有期間（1 か月がデフォルト）と、24 か月までの制限をカスタマイズできる保有期間。
リアルタイムの遅延メトリクス status.capgo.app/history.

移行計画

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

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

Capgo サポート

マイグレーションコンシェルジュ: __CAPGO_KEEP_0__ セッションに予約 book.capgo.app/demo.
コミュニティ: __CAPGO_KEEP_0__ Discord に参加 Capgo Discord.
__CAPGO_KEEP_0__.com/Cap-go/__CAPGO_KEEP_1__-updater/issues: github.com/Cap-go/capacitor-updater/issues.

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

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

Capawesome Cloudを使用している場合 Capawesome CloudからCapgoに進みましょう CI/CDの自動化を計画するには、__CAPGO_KEEP_0__ CI/CDと接続してください Capgo CI/CDの製品ワークフロー Capgo CI/CDの製品ワークフロー Capgo Native Buildsの製品ワークフロー Capgo Integrationsの製品ワークフロー Capgo Integrationsの製品ワークフロー Capgo Integrationsの製品ワークフロー CI/CD統合 CI/CD統合の実装詳細については GitHub Actions統合 GitHub Actions統合の実装詳細については