ロールバック

While Capgo’s live updates allow you to quickly deliver improvements and fixes to your users, there may be situations where you need to roll back to a previous version of your app. Perhaps a new update introduced an unexpected critical issue, or maybe you want to revert a specific change while you work on a fix.

Capgo provides several ways to manage a channel’s builds and control the version of your app that users receive, including both manual rollback options and automatic safety mechanisms.

自動ロールバック保護

Capgo includes a built-in safety mechanism to protect your users from broken updates. If a JavaScript error occurs before the notifyAppReady() method is called, the plugin will automatically roll back to the previous working version.

自動ロールバックのしくみ

When a new update is downloaded and applied, Capgo expects your app to call notifyAppReady() within a configurable timeframe to confirm that the update loaded successfully. This method signals that:

• JavaScript バンドルが重大なエラーなしでロードされた
• アプリの基本機能が正常に動作している
• 更新は安全に保管することができます

もし notifyAppReady() JavaScriptのクラッシュまたは重大なエラーにより呼び出されない場合、Capgoは:

1. 更新が正しく初期化されていないことを検出する
2. 前の正常に動作するバンドルに自動的に戻る
3. 問題のある更新を失敗としてマークして再度適用しないようにする

ヒント

あなたのアプリの初期化で notifyAppReady() codeを呼び出すことを確認してください。コアコンポーネントが正常にロードされた後、自動的なロールバック保護が機能するようにします。

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

// Call this after your app has successfully initialized
await CapacitorUpdater.notifyAppReady()

この自動保護により、間違って壊れた更新を意図せずにプッシュした場合でも、ユーザーは機能しないアプリに囚われません。

タイムアウトの設定

Capgo が呼び出されるまでの時間を設定できます。 notifyAppReady() を設定することで、 appReadyTimeout Capacitor の設定ファイル内に

{
  "plugins": {
    "CapacitorUpdater": {
      "appReadyTimeout": 10000
    }
  }
}

は appReadyTimeout 値はミリ秒で指定されます。デフォルトのタイムアウトは通常 10 秒ですが、初期化要件に応じてこの値を調整できます。アプリの初期化プロセスが複雑で時間がかかる場合、値を増やすことを検討してください。

前のバンドルのロールバック

Capgo は、毎回アップロードした新しいビルドとチャンネルに割り当てたときに、ビルドの履歴を保持します。特定のアップデートを戻したい場合は、以前のビルドのいずれかを選択してチャンネルに再デプロイできます。

The primary way to roll back is through the rollback interface, which is located in the 4th tab (History) when viewing a channel in the Capgo Dashboard. This tab provides a comprehensive view of all available builds for the channel, allowing you to easily select and revert to any previous version.

To roll back using the History tab:

1. Capgo Dashboardにログインする Capgo Dashboard.

2. チャンネルセクションに移動する

3. ロールバックしたいチャンネルの名前をクリックする

4. チャンネルビューの4番目のタブ（History）に移動する

5. ビルド履歴でロールバックしたいビルドを探す

6. ロールバックしたいビルドを選択してチャンネルのアクティブビルドに設定する

7. このビルドにロールバックすることを確認する

Alternative Method: Using the Crown Icon

__CAPGO_KEEP_0__

1. In the first tab of the channel view, find the build you want to revert to.
2. Click the crown icon next to that build to make it the active build for the channel.
3. Confirm that you want to roll back to this build.

Note

Rolling back to a previous build only affects the selected channel. If you have multiple channels (e.g. Production, Staging, etc.), you’ll need to repeat the rollback process for each affected channel.

After rolling back, devices configured to listen to the updated channel will receive the previous build the next time they check for an update. The rolled-back build will be treated as a new update, so the usual update flow and conditions apply.

Accelerate a Critical Rollback with Notifications (Private Preview)

Repointing a channel normally takes effect the next time a device checks for an update. The Capgo Notifications integration is currently in private preview and can send a silent update-check notification to a supported app while it is in the background. With the updater integration enabled, the app can check, download, and install the rollback according to its configured update mode.

This is an acceleration path, not a forced fleet command. Delivery remains best-effort and depends on operating-system background scheduling, network availability, and device state. It cannot update an offline or force-quit app, so it cannot promise a fixed time to reach every device.

To request private-preview access or set up this critical path, contact support@capgo.appYou can also read 通知: 静音更新チェックを有効にする.

チャンネルを解除する

チャンネルを解除する場合、現在のビルドからチャンネルを一時的に停止して問題を調査することができます。

チャンネルを解除するには:

1. チャンネルをCapgo ダッシュボードに移動してください。

2. 現在のビルドの横の「解除」ボタンをクリックしてください。

3. チャンネルを解除することを確認してください。

チャンネルがアンリンクされた後は、どのアップデートも配布されません。チャンネルに設定されているデバイスは、チャンネルが再びビルドとリンクされるまで、現在のビルドに留まります。

この機能は、問題が発生したアップデートを特定するのに役立ちますが、まだどのビルドに戻したいのかわからない場合に便利です。チャンネルをアンリンクすると、問題を調査する時間を与えられますが、さらにアップデートを配布するのを防ぐことができます。

ビルトインバンドルを強制する

より深刻な状況では、チャンネル内のすべてのデバイスを、元のネイティブバイナリと同梱されたオリジナルのWebビルドに戻したい場合があります。これは「ビルトインバンドル」と呼ばれます。

チャンネル内のビルトインバンドルを強制するには:

1. Capgo ダッシュボードに移動して、チャンネルを選択します。

2. 「ビルトインバンドル」ボタンをクリックします。

3. ビルトインバンドルを強制することを確認します。

ビルトインバンドルを強制すると、チャンネルに設定されているすべてのデバイスは、次のアップデートチェック時に元の同梱されたWebビルドに戻ります。これは、現在のビルドに関係なく発生します。

この機能は、特定の前のビルドに戻るよりも激しいロールバックオプションです。なぜなら、最後にアプリをアプリストアに公開したときからリリースされたすべてのライブアップデートを破棄するからです。

注意

ビルトインバンドルを強制する際には、すべてのデバイスに影響を与える可能性があるため、注意が必要です。影響を考慮し、進む計画を立てるまでに、このアクションを取る前に、必ず確認してください。

問題の監視と対応

問題の迅速な発見と問題のある更新の影響の最小化には、リリースの監視と問題の対応のための計画が不可欠です。

いくつかの戦略があります。

コホートに制限されたロールアウトの場合、 進歩的なロールアウト を使用して、安定バンドルの変更前に、すべてのチャネルに影響を与える可能性のあるデバイスの露出を停止またはターゲットをクリアすることができます。

• 更新のリリース後すぐにクラッシュレポートとユーザーフィードバックを監視する
• 段階的なロールアウトまたはステージドチャンネルシステムを使用して、幅広いリリース前に小規模なグループで更新をテストする
• ロールバック、アンリンク、またはビルトインバンドルを強制する決定の明確なプロセスと、誰がそれを行う権限を持つかを確立する
• ユーザーに問題と解決策について伝える

問題のあるアップデートを迅速に管理する能力と、注意深い監視を組み合わせることで、ユーザーに最小限の混乱を引き起こしながら、継続的に改善されるアプリのエクスペリエンスを提供できます。

ロールバックから続ける

Capacitorを使用している場合 ロールバック ロールバックとバージョン管理の計画に使用するため、ロールバックと接続する バージョン目標 バージョン目標の実装詳細について アップデートの動作 アップデートの動作の実装詳細について バンドル bundle内の実装詳細について Capgo Live Updates Capgo Live Updatesの製品ワークフローについて、 Capacitor Live Updatesのロールバック戦略 Capacitor Live Updatesのロールバック戦略の実践的な背景について。