Windy.com - 天気予報
マップ、アラート、ナビゲーションの修正を慎重に本番展開する必要がある天気アプリ。
- Google Play インストール数
- 3290万
- ストア評価
- 4.7
CLI や CI から新しい Web bundle を upload します。デバイスはバックグラウンドで bundle を download し、次回アプリがフォアグラウンドに戻ったときに実行します。パーセンテージ単位でロールアウトし、Observe で監視。問題があればロールバックします。
課題
バグの特定
監視ツールやサポートから画面の不具合が報告されます。修正は数行のJavaScriptやCSSで済みます。
新しいバイナリのビルド
バージョンを上げ、iOSとAndroid向けにビルドし、2つのストア申請を準備します。
レビュー待ち
ストアのレビューには通常24〜48時間、時にはそれ以上かかります。リジェクトされると、また待ち時間が始まります。
ユーザーの更新を待つ
承認後も、ユーザーはそれぞれ新しいバージョンをインストールする必要があります。それまでは、古い code を実行し続けます。
各ステップが、修正ができてからユーザーのデバイスで動くまでの時間を長くします。
24〜48時間以上
一般的なストア審査時間
AppleとGoogleは新しいバイナリをすべて審査します。審査は通常24〜48時間、場合によってはそれよりはるかに長くかかり、リジェクトされると再提出が必要です。
ユーザーあたり
ストア更新はデバイスごとに異なります
ストアのアップデートは、ユーザーがインストールするか、自動更新設定でインストールされたときに初めてデバイスに届きます。古いビルドのまま長く残るデバイスもあります。
2つのストア
修正ごとに2回の申請
同じWebの修正でも、App StoreとGoogle Playで個別に審査とリリースを行う必要があります。
ソリューション
これは Capgo のデフォルトのアップデート動作です。アップデートのプロンプトは表示されず、強制再起動もなく、Webレイヤーの変更でストアへの申請も不要です。
アプリがフォアグラウンドに移行したときと、アプリが開いている間は10分ごとに、アップデーターがCapgoにチャネルの最新bundleを問い合わせます。
フォアグラウンド時
新しいbundleは、ユーザーが現在のバージョンを使い続けている間にダウンロードされます。delta updatesでは、変更されたファイルだけがダウンロードされます。
中断なし
ユーザーがアプリを離れると、アップデーターがbundleをインストールします。次にアプリを開くと、新しいバージョンで起動します。
次回のフォアグラウンド時
ユーザーがアプリを開いたらすぐに新バージョンを見せたいですか?Direct updateモードなら、起動時のスプラッシュ画面表示中に適用できます。
Direct updatesを見る仕組み
すでにストアに公開されている Capacitor アプリの一般的なリリースフローです。以下のコマンドはすべて Capgo CLI のドキュメントに基づいています。
セットアップウィザードを実行し、アプリ起動後に notifyAppReady() が呼ばれるようにします。この呼び出しがない bundle は自動的にロールバックします。
npx @capgo/cli@latest init
# in your app start-up code
await CapacitorUpdater.notifyAppReady() notifyAppReady() のドキュメント --delta で変更されたファイルだけをデバイスにフェッチさせ、--rollout で少数のデバイスから展開を開始します。それ以外のデバイスは安定した bundle を使い続けます。
npx @capgo/cli@latest bundle upload --channel production --delta --rollout 5 段階的ロールアウトのドキュメント 失敗率のしきい値(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 のドキュメント 数値が想定どおりなら、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 またはコンソールから、割合の引き上げ、昇格、ロールバックができます。
1–5%
一般的な最初のロールアウトステップ
すべてのアップデートは正常に起動することを証明する必要があります。新しいbundleが制限時間内にnotifyAppReady()を呼び出さない場合、デバイスは最後に動作していたbundleに戻り、新しいbundleを失敗としてマークします。
10秒
自動ロールバックまでのデフォルトのappReadyTimeout
Capgo は、JavaScript、CSS、アセットなどの Capacitor Web レイヤーを配信します。ネイティブバイナリ、プラグイン、権限、エンタイトルメント、アプリストアのメタデータは変更しません。ストア審査はアプリごとに異なるため、ポリシーの遵守と承認の責任はお客様にあります。
ライブアップデート導入後の日常的なリリース作業。各カードはドキュメントにリンクしています。
新しいbundleと前回のbundleを比較:問題なし率、起動とWebViewのタイミング、バージョンごとのデプロイマーカーを確認できます。
Observe のドキュメントチャンネルのbundleを変更したら、サイレントアップデート通知を送信して、デバイスが次回フォアグラウンドになるのを待たずにすぐチェックできるようにします。
アップデート通知を送信チャンネルでメジャーアップデートをブロックし、新しいネイティブ code を必要とするbundleが古いバイナリに届かないようにします。
バージョンターゲティングのドキュメントCapgoは2021年からプロダクションアプリにライブアップデートを配信しています。
チームのニーズに合ったソリューションを見つける
Capacitor で構築されたアプリ
天気、公衆衛生、通信分野のアプリは、正確なインターフェース、アラート、ナビゲーションに依存しています。本番環境でのアップデートを活用すれば、承認済みのインターフェース修正を配信しつつ、展開を広げる前に導入状況をモニタリングできます。
マップ、アラート、ナビゲーションの修正を慎重に本番展開する必要がある天気アプリ。
迅速で信頼できる更新が求められる、ガイダンスやサービス情報を提供する公衆衛生アプリ。
アラートやアカウント画面が頻繁に更新される通信キャリアのアカウントアプリ。
リードデベロッパー、drivolino GmbH
“Capgo Capacitor Updater pluginのおかげで、アップデートの配信方法が完全に変わりました。以前は何日もかかっていた作業が、今ではわずか数分で終わります。”
NuTriQ 創業者
「本番環境のOTAアップデートを、App Storeの審査サイクル全体を待たずに即座に配信できることは、運用面で非常に大きな強みです。」
主要指標
“Updater pluginは素晴らしい出来です。完璧に動作していますし、Live Updatesはテストのサイクルを劇的に速めてくれます。”
よくある質問
アップデートがデバイスに届く仕組みと、問題が起きたときの対処法。
デフォルトでは、アプリがフォアグラウンドに来たときと、開いている間は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 updates は JavaScript、HTML、CSS、アセットなどの Web レイヤーを置き換えます。ネイティブプラグイン、Capacitor のアップグレード、capacitor.config の変更、iOS / Android のプロジェクトファイルはストアリリースが必要です。Capgo は upload 時に bundle のネイティブ互換性をチェックし、チャンネルで古いバイナリへの更新をブロックできます。
ネイティブ互換性ドキュメントトライアル期間中に、ご自身のアプリで一連の流れを試してください:bundle を upload し、数台のデバイスにロールアウトして、ロールバックします。