メインコンテンツへスキップ

ベータテスト

新しいTestFlightビルドなしで、Webの変更をベータテスターに配信

テスターはアプリを一度インストールするだけ。その後、JavaScript、HTML、CSSの各変更は、アプリから参加したベータチャネルに配信され、次回のアップデートチェック時に受け取ります。ネイティブの code の変更は、引き続きTestFlightまたはPlayのテストトラック経由です。

アプリからテスターがオプトイン

--self-assign を使用してチャネルへの自己割り当てを許可します。アプリは listChannels() でチャネルをリストし、setChannel() でデバイスを移動するため、テスターは設定画面からベータに参加できます。

setChannel() リファレンス

コンソールから1台のデバイスをピン留め

Capgo コンソールでデバイスオーバーライドを設定すると、アプリを変更せずに単一のテスターのスマートフォンをチャネルに配置できます。オーバーライドは最後に設定されてから90日後に削除されます。

デバイスオーバーライド

QR code でビルドを共有

アプリでプレビューを一度有効にします。その後、get-qr またはアップロード時の --qr-preview を使用すると、bundle またはチャネルの QR code とプレビューリンクが表示され、QAスレッドに投稿できます。

get-qrのリファレンス

ネイティブ変更は引き続きTestFlightが担当

Live UpdateはJavaScript、HTML、CSS、アセットを変更します。プラグインを追加したり、ネイティブのcodeを変更したりした場合は、新しいTestFlightまたはPlayのテストビルドを送信し、その後はそのビルドをチャネルでイテレーションし続けます。

Native Build が必要なケース

TestFlightとCapgoチャネルは役割が違う

  • テスターへの新しいビルドの配信方法

    TestFlight / Playでのテスト
    ビルド、署名、アップロードを行い、ストアの処理を待つ
    Capgo ベータチャネル
    CLI でバンドルをアップロード。テスターは次回のアップデート確認時に取得できます
  • テスターの追加

    TestFlight / Playでのテスト
    App Store Connect または Play Console で招待する
    Capgo ベータチャネル
    アプリからチャネルに参加するか、デバイスオーバーライドを設定します
  • テスターを別のビルドへ移動する

    TestFlight / Playでのテスト
    別のビルドをインストールする
    Capgo ベータチャネル
    setChannel() でアプリ内のチャンネルを切り替え
  • Native code とプラグインの変更

    TestFlight / Playでのテスト
    はい
    Capgo ベータチャネル
    いいえ、新しいバイナリをリリースします

テスターは TestFlight、Play のテストトラック、ストアからアプリを一度インストールするだけです。以降の Web レイヤーの変更はチャンネルが引き継ぎます。 Native Build が必要なケース

仕組み

Capgo を使った QA チームのベータ運用方法

インストール済みのビルド 1 つ、テスターが参加できるチャンネル 1 つ、変更ごとの CLI アップロード 1 回。以下のコマンドはすべて Capgo のドキュメントに基づいています。

  1. テスターが参加できるベータチャンネルを作成する

    Self-assignment を有効にすると、アプリからデバイスをこのチャンネルに移動できます。本番チャンネルではオフのままにしてください。

    npx @capgo/cli@latest channel add beta com.example.app --self-assign
    チャネルのドキュメント
  2. アプリにベータ版参加スイッチを追加

    setChannel() は、チャンネルが自己割り当てを許可しているかを Capgo に問い合わせ、デバイスに保存します。triggerAutoUpdate はすぐにアップデート確認を開始します。

    import { CapacitorUpdater } from '@capgo/capacitor-updater'
    
    // Join beta and check for its bundle now
    await CapacitorUpdater.setChannel({ channel: 'beta', triggerAutoUpdate: true })
    
    // Leave beta and go back to the default channel
    await CapacitorUpdater.unsetChannel({ triggerAutoUpdate: true })
    setChannel() リファレンス
  3. 変更内容をベータ版へアップロード

    一度プレビューを有効にすれば、あとはアップロードのたびに QR code を出力するだけ。テスターやレビュアーが新しい bundle を開けるようになります。

    # once
    npx @capgo/cli@latest app set com.example.app --preview
    # every change
    npx @capgo/cli@latest bundle upload --channel beta --qr-preview
    get-qrのリファレンス
  4. QA合格分を本番へ昇格

    テスト済みの bundle を本番にリンクするか、まず本番デバイスの一部にロールアウトします。テスターはベータ版を離れるまでベータ版のままです。

    npx @capgo/cli@latest channel set production com.example.app \
      --bundle 1.4.2
    # or roll it out to 10% of production first
    npx @capgo/cli@latest channel set production com.example.app \
      --rollout-bundle 1.4.2 --rollout-percentage 10 --rollout-enable
    段階的ロールアウトのドキュメント

ベータチャネルの利用者

社内QA

QAはインストール済みのビルドを1つ保持し、JavaScriptの変更ごとに再インストールするのではなく、qa、beta、featureチャネル間を切り替えます。

オプトインのベータユーザー

setChannel() を呼び出す「ベータに参加」スイッチを追加します。離脱したユーザーは unsetChannel() を呼び出し、デフォルトチャネルに戻ります。

ステークホルダーレビュー

get-qr から QR code を送信し、プロダクトオーナーが特定の bundle や channel のプレビューを開けるようにします。

Capacitor で構築されたアプリ

コミュニティアプリは機能公開に注意が必要

利用頻度の高いコンシューマーアプリでは、全ユーザーが新しい体験を受け取る前に、クローズドテスターグループでゲーム、学習、予測のフローを検証できます。

lichess • 無料のオンラインチェスアプリのアイコン ゲームボード

lichess • 無料のオンラインチェス

トーナメント、分析、ソーシャル機能の慎重な検証が必要な大規模コミュニティアプリ。

Google Play インストール数
1130万
ストア評価
4.3
StudySmarter - 学校・大学向けアプリのアイコン 教育

StudySmarter - 学校・大学向け

オンボーディングや練習内容の変更を、リリース前にレビューする必要がある教育ワークフロー。

Google Play インストール数
650万
ストア評価
4.8
Windy.com - 天気予報アプリのアイコン 天気

Windy.com - 天気予報

プロダクト変更を拡大展開する前に、信頼性を確保すべきインタラクションを予測・マッピングします。

Google Play インストール数
3290万
ストア評価
4.7

導入実績

Capgo を活用するチームの声

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

ネイト・ファン・ヨレ

CTO, プライベート

「セットアップは1日もかかりませんでした。チャンネルベースのロールアウトのおかげで、本番ユーザーに配信する前に自分のデバイスでテストできます。」

no-tone @ Webincode

Webincode 開発者

「Device IDを特定のグループに追加して、そのグループにだけ変更をプッシュできるのは本当に助かります。」

Michael Haberlerのポートレート

Michael Haberler

主要指標

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

よくある質問

QA・プロダクトチームからのよくある質問

テスター、ビルド、そして今もTestFlightが必要なケースについて簡潔に答えます。

Capgo は TestFlight や Play の内部テストの代わりになりますか?

Webレイヤーの変更に限ります。テスターは TestFlight、Play のテストトラック、またはストアからアプリを一度インストールします。その後、JavaScript、HTML、CSS、アセットの変更をチャンネル経由で届けられます。プラグインの追加、Capacitor のアップグレード、ネイティブの code または Capacitor 設定の変更には、新しいバイナリが必要です。

Native Build が必要なケース

テスターはどのようにベータ版に参加・退出しますか?

ベータチャンネルの self-assignment を有効にし、アプリ内の画面から setChannel({ channel: 'beta' }) を呼び出します。Capgo がチャンネルで許可されているかを確認し、デバイスにその選択を保存します。unsetChannel() を呼ぶと、デバイスはデフォルトチャンネルに戻ります。なお、デフォルトチャンネル自体には setChannel() で参加できません。

setChannel() リファレンス

アプリを変更せずに、特定のテスターの端末だけを切り替えることはできますか?

はい。Capgo コンソールでデバイスを開き、チャンネルのオーバーライドを設定します。すべてのエッジサーバーに反映されるまで最大2分かかる場合があり、オーバーライドは最後に設定されてから90日後に削除されます。アプリ内で setChannel() を使って選択したチャンネルは、このリストには表示されません。

デバイスオーバーライド

古い live update が残っている状態で、新しい Native Build をテストするにはどうすればよいですか?

Native Build ごとに CapacitorUpdater.version を上げてください。デフォルト設定では、新しいビルドがインストールされると、古いビルド用にダウンロードされた bundle は削除されます。チャンネルで開発用ビルドやエミュレータのアップデートをオフにすることもできます。

Live Updates なしで Native Build をテスト

ベータ版の bundle が起動時にクラッシュした場合はどうなりますか?

アプリの読み込みが完了したら notifyAppReady() を呼び出してください。新しい bundle が10秒以内にこれを呼び出さない場合、デバイスはその bundle を失敗としてマークし、以前動作していた bundle に戻ります。

notifyAppReady() と自動ロールバック

自分のアプリにベータチャンネルを設定する

テスターが参加できるチャンネルを作成し、スイッチを追加して、14日間の無料トライアル中に最初の bundle を送信しましょう。クレジットカードは不要です。