ページのコピー設定

Capgoのライブアップデート機能により、ユーザーに迅速に改善と修正を提供できますが、状況によっては、以前のアプリのバージョンに戻す必要があります。新しいアップデートが予期せぬ重大な問題を引き起こした場合、または特定の変更を修正するために時間がかかる場合などです。

Capgoは、チャンネルのビルドを管理し、アプリのバージョンをユーザーが受け取るように制御するためのいくつかの方法を提供します。これには、手動のロールバックオプションと自動的な安全機構も含まれます。

自動ロールバック保護

Capgoには、ユーザーを破損したアップデートから保護するための組み込みの安全機構が含まれます。JavaScriptエラーがメソッドが呼び出される前に発生した場合、プラグインは自動的に前の正常に動作するバージョンにロールバックします。 notifyAppReady() __CAPGO_KEEP_0__

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

Capgoが新しいアップデートをダウンロードして適用したときに、アプリはアップデートが正常にロードされたことを確認するために notifyAppReady() __CAPGO_KEEP_0__は、指定できる時間枠内でこのメソッドを呼び出すことを期待します。このメソッドは次のことを示します:

• JavaScript バンドルが重大なエラーなしでロードされた
• アプリの基本機能が正常に動作している
• アップデートが安全に保持できる

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

1. アップデートが正常に初期化されていないことを検出する
2. 自動的に前の正常に動作していたバンドルに戻る
3. 問題のあるアップデートを失敗としてマークして再度適用されるのを防ぐ

Tip

アプリの初期化時に notifyAppReady() in your app’s initialization code after your core components have loaded successfully. This ensures the automatic rollback protection works as intended.

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

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

Copy to clipboard

この自動保護により、誤って破損した更新をプッシュした場合でも、ユーザーは機能しないアプリにブロックされません。

You can configure how long Capgo waits for notifyAppReady() __CAPGO_KEEP_0__ が appReadyTimeout in your Capacitor configuration:

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

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

前のバンドルに戻す

アップロードした新しいビルドとチャンネルに割り当てたたびに、Capgoはそのビルドの履歴を保存します。特定のアップデートを元に戻す必要がある場合、チャンネルに再デプロイするためにこれらの前のビルドのいずれかを選択できます。

前のバンドルに戻すの主な方法は、ロールバックインターフェイスです。このインターフェイスは、Capgoダッシュボードでチャンネルを表示している4番目のタブ（履歴）にあります。このタブでは、チャンネルに利用可能なすべてのビルドを視覚化し、簡単に前のバージョンに戻すことができます。

ロールバックをHistoryタブで行うには:

1. Capgoダッシュボードにログイン Capgo Dashboard.

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

3. __CAPGO_KEEP_0__

4. 4番目のタブ（History）に移動してください。

5. チャンネルビューのビルド履歴で、戻したいビルドを探してください。

6. 戻したいビルドを選択して、チャンネルでそのビルドを有効にします。

7. このビルドに戻したいことを確認してください。

代替方法：クラウンアイコンを使用する

2番目の方法として、チャンネルビューの1番目のタブで、ビルド履歴の任意のビルドの隣にあるクラウンアイコンをクリックして、直接戻すこともできます。

1. チャンネルビューの1番目のタブで、戻したいビルドを探してください。
2. 戻したいビルドの隣にあるクラウンアイコンをクリックして、チャンネルでそのビルドを有効にします。
3. このビルドに戻したいことを確認してください。

注意

前のビルドに戻すことは、選択したチャネルにのみ影響します。複数のチャネル (例: 生産、ステージングなど) がある場合、各影響を受けるチャネルに対して戻しプロセスを繰り返す必要があります。

戻した後、更新されたチャネルに設定されているデバイスは、更新を確認する度に前のビルドを受信します。戻したビルドは、新しい更新として扱われるため、通常の更新フローと条件が適用されます。

緊急の戻しを加速する通知

チャンネルを再設定する場合、通常、デバイスが更新を確認する度に効果が生じます。Capgo 通知は、バックグラウンドで実行中のサポートされているアプリに静的な更新確認通知を送信できます。アップデータ統合が有効になっている場合、アプリは更新モードに基づいて更新を確認、ダウンロード、インストールできます。

これは加速パスであり、強制的なフリートコマンドではありません。配信はベストエフォートであり、オペレーティングシステムのバックグラウンドスケジューリング、ネットワークの利用可能性、デバイスの状態に依存します。オフラインまたは強制終了されたアプリを更新できないため、すべてのデバイスに到達する時間を保証することはできません。

このパスを設定するには、次の手順に従ってください。 通知: 静的な更新確認を有効にする.

チャンネルを解除する

問題を調査するために、暫定的に更新を停止したい場合は、チャンネルを現在のビルドから解除できます。

チャンネルをアンリンクするには:

1. チャンネルを Capgo ダッシュボードで表示します。

2. 現在のビルドの横にある「アンリンク」ボタンをクリックします。

3. チャンネルをアンリンクすることを確認します。

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

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

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

より深刻な状況では、デバイス全体をチャンネルに戻して、元のアプリのネイティブバイナリと組み込まれたWebビルドに戻したい場合があります。これは「ビルトイン バンドル」と呼ばれます。

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

1. チャンネルを Capgo ダッシュボードで表示します。

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

3. __CAPGO_KEEP_0__を強制することを確認してください。

チャンネルに設定されているすべてのデバイスは、次の更新チェックで元のパッケージされたWebビルドに戻ります。この動作は、現在のビルドに関係なく、実行中の更新がリリースされた時点から始まります。

このオプションは、特定の前のビルドに戻るよりも、より強力なロールバックオプションです。アプリが最後にアプリストアに公開された時点から始まり、現在までにリリースされたすべてのライブアップデートを破棄します。

注意

__CAPGO_KEEP_0__を強制する際には、すべてのデバイスに影響を与える可能性があるため、十分な注意を払ってください。影響を考慮し、進む計画を立てるまで、このアクションを実行しないでください。

問題の発生と対応

問題が生じるのを早く捕まえ、問題のある更新の影響を最小限に抑えるには、リリースを監視し、問題に応じるための計画が必要です。

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

コホートに制限されたロールアウトの場合に使用します 進歩的なロールアウト アップデートの公開前に、露出を一時停止したり、ターゲットをクリアしたりすることができます。

• 更新のリリース直後にクラッシュレポートやユーザーフィードを監視する
• アップデートをテストするために、フェーズドロールアウトやステージドチャンネルシステムを使用する
• ロールバック、アンリンク、またはビルトインバンドルの強制を決定するための明確なプロセスを持ち、誰がそれを行う権限があるかを決定する
• 問題と解決策についてユーザーに伝える

問題のあるアップデートを迅速に管理する能力と、注意深く監視することで、ユーザーに影響を与えずにアプリの改善を続けることができます。

ロールバックから続ける

Capgoを使用している場合 ロールバック バージョン管理とロールバックを計画するためにCapgoを使用し、バージョン目標と接続する バージョン目標 バージョン対象設定の実装詳細については 更新動作 更新動作の実装詳細については バンドル バンドルの実装詳細については Capgo Live Updates for the product workflow in Capgo Live Updates, and Rollback Strategies for Capacitor Live Updates for the practical context in Rollback Strategies for Capacitor Live Updates.