メインコンテンツへスキップ
本番アップデート

すべてのユーザーに最新の修正を届ける

CLI や CI から新しい Web bundle を upload します。デバイスはバックグラウンドで bundle を download し、次回アプリがフォアグラウンドに戻ったときに実行します。パーセンテージ単位でロールアウトし、Observe で監視。問題があればロールバックします。

クレジットカード不要
自動ロールバック機能を標準搭載
Webレイヤーのアップデートのみ

課題

ストアリリースは小さな修正を届けるには遅すぎる

ストアのみの修正フロー

1

バグの特定

監視ツールやサポートから画面の不具合が報告されます。修正は数行のJavaScriptやCSSで済みます。

2

新しいバイナリのビルド

バージョンを上げ、iOSとAndroid向けにビルドし、2つのストア申請を準備します。

3

レビュー待ち

ストアのレビューには通常24〜48時間、時にはそれ以上かかります。リジェクトされると、また待ち時間が始まります。

4

ユーザーの更新を待つ

承認後も、ユーザーはそれぞれ新しいバージョンをインストールする必要があります。それまでは、古い code を実行し続けます。

各ステップが、修正ができてからユーザーのデバイスで動くまでの時間を長くします。

ストア経由の修正がユーザーに届くのが遅い理由

24〜48時間以上

一般的なストア審査時間

AppleとGoogleは新しいバイナリをすべて審査します。審査は通常24〜48時間、場合によってはそれよりはるかに長くかかり、リジェクトされると再提出が必要です。

ユーザーあたり

ストア更新はデバイスごとに異なります

ストアのアップデートは、ユーザーがインストールするか、自動更新設定でインストールされたときに初めてデバイスに届きます。古いビルドのまま長く残るデバイスもあります。

2つのストア

修正ごとに2回の申請

同じWebの修正でも、App StoreとGoogle Playで個別に審査とリリースを行う必要があります。

ソリューション

live update がどのようにユーザーに届くか

これは Capgo のデフォルトのアップデート動作です。アップデートのプロンプトは表示されず、強制再起動もなく、Webレイヤーの変更でストアへの申請も不要です。

デフォルトのアップデートフロー

  1. アプリがアップデートを確認します

    アプリがフォアグラウンドに移行したときと、アプリが開いている間は10分ごとに、アップデーターがCapgoにチャネルの最新bundleを問い合わせます。

    フォアグラウンド時

  2. バックグラウンドでダウンロード

    新しいbundleは、ユーザーが現在のバージョンを使い続けている間にダウンロードされます。delta updatesでは、変更されたファイルだけがダウンロードされます。

    中断なし

  3. 次回の復帰時に切り替え

    ユーザーがアプリを離れると、アップデーターがbundleをインストールします。次にアプリを開くと、新しいバージョンで起動します。

    次回のフォアグラウンド時

ユーザーがアプリを開いたらすぐに新バージョンを見せたいですか?Direct updateモードなら、起動時のスプラッシュ画面表示中に適用できます。

Direct updatesを見る

アップデート動作のドキュメント

仕組み

Capgo でプロダクションチームが修正をデプロイする方法

すでにストアに公開されている Capacitor アプリの一般的なリリースフローです。以下のコマンドはすべて Capgo CLI のドキュメントに基づいています。

  1. アップデーターのセットアップは一度だけ

    セットアップウィザードを実行し、アプリ起動後に notifyAppReady() が呼ばれるようにします。この呼び出しがない bundle は自動的にロールバックします。

    npx @capgo/cli@latest init
    # in your app start-up code
    await CapacitorUpdater.notifyAppReady()
    notifyAppReady() のドキュメント
  2. 修正をプロダクションの一部にアップロード

    --delta で変更されたファイルだけをデバイスにフェッチさせ、--rollout で少数のデバイスから展開を開始します。それ以外のデバイスは安定した bundle を使い続けます。

    npx @capgo/cli@latest bundle upload --channel production --delta --rollout 5
    段階的ロールアウトのドキュメント
  3. Capgo で問題のあるロールアウトを停止

    失敗率のしきい値(500 bps = 5%)を設定して auto-pause を有効にします。失敗率がしきい値を超えると、Capgo がロールアウトをロールバックします。実行中は Observe で新しいバージョンを確認してください。

    npx @capgo/cli@latest channel set production \
      --auto-pause-enabled \
      --auto-pause-failure-rate-bps 500 \
      --auto-pause-action rollback
    Observe のドキュメント
  4. 全員にプロモート

    数値が想定どおりなら、bundle をチャネル内の全デバイスにプロモートします。そうでなければ、ロールアウトのコホートを stable に戻します。

    npx @capgo/cli@latest channel set production --rollout-promote
    # or, if something looks wrong
    npx @capgo/cli@latest channel set production --rollout-rollback
    ロールバックのドキュメント

本番リリース向けに設計

本番チームがユーザーを驚かせずに頻繁にリリースするためのコントロール

差分アップデート

--delta を付けて upload すると、デバイスは現在の bundle 以降で変更されたファイルだけを download します。ほとんど変更されない大きなアセットは一度だけ download されます。

  • 低速・従量制ネットワークでもダウンロードサイズを削減
  • デフォルトモードでは、アップデートはセッション中ではなくセッション間に適用されます
差分アップデートのドキュメント

--delta

変更されたファイルのみをダウンロード

自動一時停止付きの段階的ロールアウト

チャネルのランダムな固定シェアに新しい bundle を配信し、それ以外のユーザーは安定した bundle を使い続けます。CLI またはコンソールから、割合の引き上げ、昇格、ロールバックができます。

  • Auto-pauseは、失敗率がしきい値を超えた際にロールアウトを一時停止またはロールバックします
  • Observeは、公開範囲を広げる前に新旧バージョンの比較を行います
段階的ロールアウトのドキュメント

1–5%

一般的な最初のロールアウトステップ

自動ロールバック

すべてのアップデートは正常に起動することを証明する必要があります。新しいbundleが制限時間内にnotifyAppReady()を呼び出さない場合、デバイスは最後に動作していたbundleに戻り、新しいbundleを失敗としてマークします。

  • appReadyTimeout(デフォルトは10秒)以内にnotifyAppReady()が呼び出されない場合にロールバックが実行されます
  • チャンネル全体を履歴内の任意の過去のbundleへロールバック
notifyAppReady() のドキュメント

10秒

自動ロールバックまでのデフォルトのappReadyTimeout

ストア審査を考慮した配信

Capgo は、JavaScript、CSS、アセットなどの Capacitor Web レイヤーを配信します。ネイティブバイナリ、プラグイン、権限、エンタイトルメント、アプリストアのメタデータは変更しません。ストア審査はアプリごとに異なるため、ポリシーの遵守と承認の責任はお客様にあります。

  • ネイティブ機能、プラグイン、権限、アプリストアのメタデータが変更される場合は、ストアへのネイティブリリースを使用してください
  • レビュアー向けメモで、アプリの想定機能と Web レイヤーの更新経路を明確にしてください
  • 提出のたびに、Apple と Google の最新ポリシーを確認してください

プロダクションチームの活用方法

ライブアップデート導入後の日常的なリリース作業。各カードはドキュメントにリンクしています。

緊急のバグ修正

決済画面やログイン画面の不具合には、Web レイヤーの修正を適用します。修正をアップロードすれば、デバイスは次回のアップデート確認時に取得します。

アップデート動作のドキュメント

文言とコンテンツの変更

新しいバイナリをビルドせずに、文言の修正、ヘルプテキストの更新、画像やその他のバンドルされたアセットの置き換えができます。

ネイティブ互換性ドキュメント

Observeでリリースヘルス

新しいbundleと前回のbundleを比較:問題なし率、起動とWebViewのタイミング、バージョンごとのデプロイマーカーを確認できます。

Observe のドキュメント

アップデート通知で反映を早める

チャンネルのbundleを変更したら、サイレントアップデート通知を送信して、デバイスが次回フォアグラウンドになるのを待たずにすぐチェックできるようにします。

アップデート通知を送信

古いNative Buildを保護

チャンネルでメジャーアップデートをブロックし、新しいネイティブ code を必要とするbundleが古いバイナリに届かないようにします。

バージョンターゲティングのドキュメント

チャンネル履歴からロールバック

チャンネルのHistoryタブで以前のbundleを選ぶと、そのチャンネルの全デバイスで再びライブになります。

ロールバックのドキュメント

プロダクションアプリを支えるインフラ

Capgoは2021年からプロダクションアプリにライブアップデートを配信しています。

月間アップデート数
10億+
到達デバイス数
9,000万+
Capgo 導入アプリ数
4,700+
一般的な API レイテンシ
約50ms

Capacitor で構築されたアプリ

高トラフィックのアプリには、本番環境での確実なUI変更が不可欠です

天気、公衆衛生、通信分野のアプリは、正確なインターフェース、アラート、ナビゲーションに依存しています。本番環境でのアップデートを活用すれば、承認済みのインターフェース修正を配信しつつ、展開を広げる前に導入状況をモニタリングできます。

Windy.com - 天気予報アプリのアイコン 天気

Windy.com - 天気予報

マップ、アラート、ナビゲーションの修正を慎重に本番展開する必要がある天気アプリ。

Google Play インストール数
3290万
ストア評価
4.7
Conecte SUS アプリのアイコン 医療

SUSを接続

迅速で信頼できる更新が求められる、ガイダンスやサービス情報を提供する公衆衛生アプリ。

Google Play インストール数
2770万
ストア評価
4.6
Mi Orangeのアプリアイコン ツール

Mi Orange

アラートやアカウント画面が頻繁に更新される通信キャリアのアカウントアプリ。

Google Play インストール数
930万
ストア評価
4.2

導入実績

Capgo を活用するチームの声

5.0/5 開発チームによる評価 9,400+ チーム数 レビューを読む
Sergiu Sのポートレート

セルギウ・S

リードデベロッパー、drivolino GmbH

“Capgo Capacitor Updater pluginのおかげで、アップデートの配信方法が完全に変わりました。以前は何日もかかっていた作業が、今ではわずか数分で終わります。”

Kapil

NuTriQ 創業者

「本番環境のOTAアップデートを、App Storeの審査サイクル全体を待たずに即座に配信できることは、運用面で非常に大きな強みです。」

Michael Haberlerのポートレート

Michael Haberler

主要指標

“Updater pluginは素晴らしい出来です。完璧に動作していますし、Live Updatesはテストのサイクルを劇的に速めてくれます。”

よくある質問

プロダクションチームがよくする質問

アップデートがデバイスに届く仕組みと、問題が起きたときの対処法。

ユーザーに live update が届くタイミングは?

デフォルトでは、アプリがフォアグラウンドに来たときと、開いている間は10分ごとにアップデートを確認します。新しいbundleをバックグラウンドでダウンロードし、ユーザーがアプリを離れたときにインストール、次回起動時に実行します。この動作はautoUpdate設定で変更できます。

アップデート動作のドキュメント

緊急の修正をより早くデバイスに反映できますか?

はい。チャンネルのbundleを変更した後、コンソールからアップデート通知を送信するか、bundle uploadに --send-update-notification を追加してください。デバイスにサイレントプッシュが届き、即座に確認が行われます。これにはiOSおよびAndroidのプッシュ認証情報を用いた Capgo Notificationsが必要です。配信はベストエフォートです。オフラインや強制終了されたアプリは、次回起動時に確認します。

アップデート通知を送信

アップデートでアプリが壊れた場合はどうなりますか?

新しいbundleが10秒以内(デフォルトのappReadyTimeout)に notifyAppReady() を呼び出さない場合、デバイスは最後に正常動作していたbundleに戻り、新しいbundleを失敗としてマークします。アプリの起動を妨げないバグの場合は、プログレッシブロールアウトをロールバックするか、チャンネル履歴から以前のbundleを選択してください。

ロールバックのドキュメント

一部のユーザーにのみ先行リリースするにはどうすればよいですか?

--rollout を付けて upload すると、チャンネル内のランダムで固定されたシェアに bundle を送信し、それ以外のユーザーは stable のままにできます。割合の引き上げ、プロモート、ロールバックは CLI またはコンソールから行えます。Auto-pause は失敗率がしきい値を超えると配信を停止できます。

段階的ロールアウトのドキュメント

live update で変更できないことは?

Live updates は JavaScript、HTML、CSS、アセットなどの Web レイヤーを置き換えます。ネイティブプラグイン、Capacitor のアップグレード、capacitor.config の変更、iOS / Android のプロジェクトファイルはストアリリースが必要です。Capgo は upload 時に bundle のネイティブ互換性をチェックし、チャンネルで古いバイナリへの更新をブロックできます。

ネイティブ互換性ドキュメント

次の修正を live update としてリリースしましょう

トライアル期間中に、ご自身のアプリで一連の流れを試してください:bundle を upload し、数台のデバイスにロールアウトして、ロールバックします。