Capawesome CloudからCapgoに移行

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

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

概要

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

Capgo を使用すると、プラグインをインストールし呼び出すだけで十分です。 CapacitorUpdater.notifyAppReady()すべての他の機能—チャンネル、バンドルクリーンアップ、ロールバック、分析、CLI自動化—is handled natively. The sections below walk through each task directly.

開始する前に

Capgoを使用しているプロジェクトはすでにCapacitor 5.0以上を使用していることを確認してください。
Install the Capgo CLI (npm install -g @capgo/cliCI/CDからバンドルをプッシュする予定の場合。

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

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

Capgoの場合のみ、必須の置き換えはこの1つです。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 から Capgo へのアップグレード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.

Capawesomeオプション

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

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

古いワークフローでは、カスタムリスナー ("checkForUpdates(), retryDownload()、スプラッシュ画面の非表示などを実行します。Capgoは、上記のステップをネイティブで実行します。ただし、APIを呼び出す必要があります。

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

CapacitorUpdater.notifyAppReady()

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

それがすべてです—Capgoはバックグラウンドチェック、スプラッシュの表示、ロールバックをネイティブでサポートしています。

ステップ 4 – __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()

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

Capgo

Capawesome Cloud	Capgo equivalent	必要ですか?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	独自のダウンロードフローを実装する場合のみ
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	オプション: 自動更新が既にダウンロードしている
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	オプション: ダッシュボードが自動でバンドルをピンします
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Optional; Capgo が必須バンドルを強制する `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	オプション:診断

Capawesome の JavaScript を削除するだけで済む native 自動更新の挙動に従う場合は

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

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

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: 有効になっている (autoUpdate: true). code の追加設定は必要ありません。

強制更新

前回のワークフロー:ワイヤープロンプトロジックとリロードを強制します。
Capgo:Capgoにプルリクエストを提出する majorAvailable ：バンドルをダッシュボードで「必須」としてマークし、次にリスニングを開始し、 notifyAppReady()イベント（

）を発行して、アプリ内でアップグレードを要求する

:Capgoのページ 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では、Capgoは自動的にバンドルの健康状態を追跡するため、次の機能も提供されます。

すべてのインストールに対してデバイスレベルの監査ログが取得されます。
自動的な保持期間（デフォルトは1か月）が設定でき、最大24か月までカスタマイズできます。
リアルタイムの遅延メトリックは Capgo status.capgo.app/history.

移行計画

インベントリ＆インストール: 10分（古いプラグインを削除）npm install設定＆準備
: 5分（5分以内notifyAppReady).
セキュリティチェック: 15 分 (オプションのマニュアルテストまたはリスナー)
最初のデプロイ: 10 minutes with Capgo CLI or CI integration.

: 10 分で __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ または CI 統合

Capgo サポート

セクションのタイトル「__CAPGO_KEEP_0__ サポート」マイグレーションコンシェルジュ book.capgo.app/demo.
CommunityCapgoに参加してください Capgo ディスコード.
問題報告: 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ネイティブビルド Capgo製品ワークフローにおけるCapgoネイティブビルドのために Capgo統合 Capgo製品ワークフローにおけるCapgo統合のために CI/CD統合 Capgo製品ワークフローにおけるCI/CD統合の実装詳細について GitHubアクション統合 Capgo製品ワークフローにおけるGitHubアクション統合の実装詳細について