__CAPGO_KEEP_8__

このプラグインのインストール手順とマークダウンガイドを含むセットアップのコピー

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

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

自動ロールバック保護

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

セクション「自動ロールバックのしくみ」

When a new update is downloaded and applied, Capgo expects your app to call notifyAppReady() アプリの基本機能が正常に動作している

アップデートが安全に保持される
しかし、
__CAPGO_KEEP_0__は、JavaScriptクラッシュまたは重大なエラーのため、呼び出されなかった場合に、次のことを検出します。

アップデートが正常に初期化されていないことを検出します notifyAppReady() Capgo includes a built-in safety mechanism to protect your users from broken updates. If a JavaScript error occurs before the

method is called, the plugin will automatically roll back to the previous working version.
自動的に前の正常なバンドルに戻る
問題のある更新をマークして再度適用されるのを防ぐ

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

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

この自動保護により、誤って破損した更新をプッシュした場合でも、ユーザーは機能しないアプリに巻き込まれないようになります。

タイムアウトの設定

Capgo が notifyAppReady() を呼び出されるまで待つ時間を設定することができます。 appReadyTimeout In your Capacitor 設定内:

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

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

前のバンドルに戻す

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

バックアップ UI

バックアップの主な方法は、Capgo ダッシュボードの 4 番目のタブ（履歴）で見つけることができます。このタブでは、チャンネルのすべてのビルドを視覚化し、以前のバージョンに戻すことができます。

バックアップを履歴タブで実行するには:

__CAPGO_KEEP_0__ ダッシュボードにログイン Capgo ダッシュボード.
チャンネルセクションに移動してください。
指定したチャンネル名をクリックしてください。
チャンネルビューの4番目のタブ（History）に移動してください。
ビルド履歴で戻したいビルドを探してください。
戻したいビルドを選択して、チャンネルでそのビルドを有効にします。
このビルドに戻したいことを確認してください。

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

クラウンアイコンを使用することで、ビルド履歴の最初のタブから直接戻すこともできます。

最初のタブのチャンネルビューで戻したいビルドを探してください。
戻したいビルドの隣のクラウンアイコンをクリックして、チャンネルでそのビルドを有効にします。
Confirm that you want to roll back to this build.

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.

Unlinking a Channel

If you want to temporarily halt updates on a channel while you investigate an issue, you can unlink the channel from its current build.

To unlink a channel:

Navigate to the channel in the Capgo Dashboard.
Click the “Unlink” button next to the current build.
Confirm that you want to unlink the channel.

チャネルがアンリンクされたら、更新の新しいバージョンは配布されません。チャネルに設定されているデバイスは、チャネルが再びビルドとリンクされるまで、現在のビルドで動作を続けます。

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

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

より重篤な状況では、チャネル内のすべてのデバイスを、元のパッケージされたWebビルドに戻したい場合があります。これは「ビルトインバンドル」と呼ばれます。

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

チャネルをCapgoダッシュボードに移動してください。
「ビルトインバンドル」ボタンをクリックしてください。
ビルトインバンドルを強制することを確認してください。

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

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

問題の監視と対応

問題の更新を最小限に抑えるために、問題を迅速に検出し、問題の更新に対処するための計画を立てることが重要です。

いくつかの戦略を含みます。

更新後すぐにクラッシュレポートとユーザーフィードバックを監視する
フェーズドロールアウトまたはステージドチャンネルシステムを使用して、更新を小規模なグループにテストする
ロールバック、アンリンク、または組み込まれたバンドルを強制する決定のプロセスを明確にし、権限を持つ人に決定権を与える
問題と解決策についてユーザーに伝える

注意深い監視と問題の更新を迅速に管理する能力を組み合わせることで、ユーザーに影響を与えずにアプリの改善を継続的に実現することができます。

「ロールバック」から続けてください

ロールバックを使用している場合 ロールバック バージョン管理とロールバックの計画に使用します。バージョン目標バージョン目標の実装詳細に接続します。更新動作更新動作の実装詳細に接続します。バンドルバンドルの実装詳細に接続します。 Capgo ライブアップデート Capgo ライブアップデートの製品ワークフローに使用します。 Capacitorのライブアップデートのロールバック戦略 Capacitorのライブアップデートのロールバック戦略のための実用的な文脈