Channel surfing for Expo Updates: How to switch update channels at runtime

claudejamodel: claude-sonnet-4-20250514

Expo Updatesのチャンネルサーフィン：ランタイムでアップデートチャンネルを切り替える方法

Product • Development • January 21, 2026 • 10分で読める

Jacob Clausen Engineering

ExpoのOTA Update Channel Surfingで特定のユーザーに即座に変更を配信しましょう。再インストールなしでランタイムでアップデートチャンネルを切り替えることができるようになりました。

特定のユーザーに変更を直接配信して、TestFlight から新しいビルドをダウンロードしてインストールしてもらうことなく、即座にレビューとフィードバックを得られたらと思ったことはありませんか？私もそう思っていました。顧客から改善要求を受けて、それを素早く実装できたものの、結果を顧客の手に渡して検証してもらうには、すべてのユーザーにアップデートを配信する（実験的な変更にはリスクが高く、帯域幅の無駄遣い）か、顧客専用のワンオフビルドを作成する（双方にとって面倒）必要がありました。

欠けていたのは柔軟性でした。開発者は、非技術系のステークホルダー、QA、または適切な場合には全ユーザーベースなど、異なるユーザーグループに異なるアップデートを配信できるようにしたいと考えていました。プロダクションビルドが作業中のバージョンに切り替わり、フィードバックを収集してからプロダクションに戻る方法がありませんでした。

それが「チャンネルサーフィン」が可能にすることです。ユーザーのデバイスにインストールされたアプリは、ランタイムでアップデートチャンネルを切り替えることができ、プロダクションアプリを固定されたエンドポイントではなく、レビューと反復のための柔軟なスペースに変えることができます。これは、プロダクションアプリで作業する非技術系のステークホルダーにとって特に有用で、すでにインストールされているアプリで直接変更をテストしてフィードバックを提供できます。

アップデートチャンネルの理解

アップデートチャンネルは、EAS Updateが特定のビルドにアップデートをターゲットする方法です。各ビルドはチャンネルに関連付けられ、そのチャンネルがどのアップデートを受信するかを決定します。

例えば、productionのユーザーに影響を与えることなく、previewチャンネルにアップデートを公開できます。

以前は、チャンネルを切り替えるには異なるネイティブビルドをインストールする必要がありました。アップデートチャンネルに馴染みがない場合は、EAS Updateのドキュメントでより詳しく説明されています。

チャンネルサーフィンとは？

チャンネルサーフィンにより、インストールされたアプリは再インストールなしで異なるアップデートストリームから取得できます。インストールされたアプリはランタイムでアップデートチャンネルを切り替えることができ、アプリがアンインストールされるか別のチャンネルに切り替えられるまで、新しく選択されたチャンネルからアップデートを受信し続けます。

実際には、これはプロダクトオーナーやQAがプロダクションビルドを、例えばpreviewチャンネルに切り替えて、最新の変更を試すことができることを意味します。テストが完了したら、再びproductionに戻します。再インストールや別のpreviewビルドは必要ありません。

内部的には、チャンネルサーフィンはアプリがアップデートクライアントにどのチャンネルを使用するかを伝えることで機能します。その選択はランタイムで変更でき、クリアまたは置き換えられるまで有効です。

チャンネルサーフィン。レイアウト変更の見た目を確認するためにpreviewチャンネルに切り替える。

チャンネルサーフィンの実装方法

チャンネルサーフィンを試す前に、プロジェクトをEAS Updateで設定する必要があります。設定するには、EAS Updateの入門ガイドに従ってください。

チャンネルサーフィンの核心は、単一のAPI呼び出しによって駆動されます：

Updates.setUpdateRequestHeadersOverride({
  "expo-channel-name": "your-channel",
});

これは、EAS Updateをクエリする際に使用されるチャンネルヘッダーを設定します。setUpdateRequestHeadersOverride APIについて詳しく学ぶ。

より良いユーザーエクスペリエンスのために、通常はチャンネルを切り替えて次のアプリ再起動を待つだけでなく、より多くのことを行いたいでしょう。一般的なアプローチは、即座にアップデートをチェックし、利用可能な場合はダウンロードし、ユーザーが選択したチャンネルのアップデートに直接着地するようにアプリをリロードすることです。

典型的なフローは次のようになります：

チャンネルを変更する（setUpdateRequestHeadersOverride）
アップデートをチェックする（checkForUpdateAsync）
アップデートを取得して適用する（fetchUpdateAsync）
アプリをリロードする（reloadAsync）

これらの要素をまとめた簡単な例は次のようになります：

import * as Updates from "expo-updates";

async function channelSurfAsync(selectedChannel: string) {
  // アップデートチャンネルを設定
  Updates.setUpdateRequestHeadersOverride({
    "expo-channel-name": selectedChannel,
  });

  // アップデートが利用可能かチェック
  const { isAvailable } = await Updates.checkForUpdateAsync();

  if (isAvailable) {
    // アップデートを取得してインストール
    await Updates.fetchUpdateAsync();
  }

  // アプリをリロード
  await Updates.reloadAsync({
    reloadScreenOptions: {
      backgroundColor: "#F8FAFC",
      spinner: {
        enabled: true,
        size: "large",
      },
      fade: true,
    },
  });
}

このフローをどのように構成するかはあなた次第です。これらのステップを複数のインタラクションに分割したり、すべてを一度に実行したりできます。フローをどのように構成するかに関係なく、失敗を考慮するようにしてください。例えば、ネットワークの問題や無効なチャンネルなど、すべてがアップデートの適用を妨げる可能性があります。

チャンネルサーフィンは通常、アプリを使用するすべての人ではなく、限られたユーザーセットに公開したいものです。例えば、認証された従業員のみが利用できるボタンがあり、アプリをpreviewチャンネルに切り替えるかもしれません。

利用可能なチャンネルのリストは、アプリで定義する必要があります。既存のアップデートチャンネルを取得するパブリックHTTP APIはありません（ロードマップにあります）ので、チャンネルスイッチャーUIは既知のチャンネル名セットに対して動作するか、eas channel:listを呼び出す独自のエンドポイントを構築できます。

チャンネルオーバーライドが設定されると、そのチャンネルは、アプリがアンインストールされるかオーバーライド自体がオーバーライドされるまで、そのデバイス上のすべての後続のアップデート関連操作でEAS Updates APIが使用するものになります。

余談として、SDK 54では、reloadAsyncがリロードエクスペリエンスをより細かく制御できるようになりました。アプリがリロードされている間に表示されるUIをカスタマイズできるようになり、以前に発生していた空のコンテンツの短い点滅を回避できます。これにより、アップデートの適用がより意図的でスムーズに感じられます。

チャンネルサーフィンが機能しているかテストする方法

チャンネルサーフィンを実際に動作させるには、リリースビルドが必要です - expo-updates APIのほとんどはリリースビルドでのみ利用可能です（EX_UPDATES_NATIVE_DEBUGを有効にしてビルドしない限り）。デバッグビルドでは、アプリは通常開発サーバーからJavaScriptを読み込み、通常のアップデートフローをバイパスします。

便宜上、EAS Buildを使用してテスト用のリリースビルドを作成できます。EAS Buildをまだ設定していない場合は、EAS Buildの入門ガイドに従ってください。

EAS Buildでは、ビルドは明示的に開発ビルドを選択する（例：developmentClient: true）か、明示的にネイティブビルド設定をオーバーライドしない限り、リリースデフォルトを使用します。このプロファイルでは、リリース設定は変更せず、出力形式のみを変更します：iOSシミュレーターアプリ（ios.simulator: true）と直接インストール可能なAndroid APK（android.buildType: "apk"）で、ローカルで簡単に試すことができます。

{
  "cli": {
    "version": ">= 16.28.0",
    "appVersionSource": "remote"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "channel": "development"
    },
    "preview": {
      "distribution": "internal",
      "channel": "preview"
    },
    "production": {
      "autoIncrement": true,
      "channel": "production"
    },
    "production-simulator": {
      "channel": "production",
      "ios": {
        "simulator": true
      },
      "android": {
        "buildType": "apk"
      }
    }
  },
  "submit": {
    "production": {}
  }
}

そして、プロジェクトをビルドします。

eas build --profile production-simulator --platform [ios/android]

ビルドが完了したら、シミュレーターまたはエミュレーターにダウンロードしてインストールします。

アップデートを公開してチャンネルを切り替える

アプリがインストールされたら、異なるチャンネルにアップデートを公開します：

eas update --channel preview

そこから、アプリのチャンネルサーフィンUIに移動し、チャンネル切り替えをトリガーします。例えば、productionとpreviewチャンネル間を切り替えるボタンを公開するかもしれません。

チャンネル変更をトリガーすると、アプリは選択されたチャンネルからアップデートを取得し、新しいアップデートにリロードするはずです。

Expo OTA Updateの注意点

これらはチャンネルサーフィンに特有のものではありませんが、ランタイムでチャンネルを切り替え始めると、すぐに明らかになる傾向があります。

ランタイムバージョンの不一致

アップデートのランタイムバージョンがインストールされたアプリのランタイムバージョンと一致しない場合、アップデートはダウンロードまたは適用されません。チャンネルサーフィンでは、これは通常、アプリがチャンネルを切り替えたがアップデートが適用されない（そのチャンネルに存在するにもかかわらず）として現れます。これは通常、アップデートがアプリの異なるネイティブバージョンから公開されたことを意味します。

アップデートの削除または取り消し

しばしば見落とされるもう一つの動作は、アップデートがどのように削除または取り消されるかです。アプリがすでにチャンネルのアップデートをダウンロードしている場合、EASダッシュボード（またはeas update:delete）からそのアップデートを削除しても、すでにそれを持っているデバイスからは削除されません。削除は将来のダウンロードのみを停止します。

悪いアップデートを取り消す最も信頼できる方法は、同じチャンネルに既知の良いアップデートを再公開することです。これにより、チャンネルの履歴の最上位に新しいアップデートが作成され、クライアントは最新バージョンとして扱い、代わりに適用します。

代替として、EAS Updateはロールバック機能（eas update:rollback）を提供し、クライアントに以前の安定したアップデートを再適用するか、ビルドに埋め込まれたアップデートにフォールバックするよう指示できます。

チャンネルサーフィンがモバイル反復を改善する理由

チャンネルサーフィンは、プロダクション環境で変更を迅速にレビューする必要がある場合に特に有用です。例えば、広く展開される前に検証が必要な緊急のバグ修正を想像してください。チャンネルサーフィンにより、変更は指定された少数のユーザーに分離でき、プロダクションに到達する前にレビューできます。

プロダクトオーナーやQAは、インストールされたプロダクションビルドを別のアップデートチャンネルに切り替え、修正や機能を検証し、完了したら再び戻すことができます。これにより、ワークフローをスムーズに保ちながら、非技術系のステークホルダーをレビューと意思決定に関与させることが容易になります。単一のプロダクションビルドが、テスト、フィードバック、検証のための柔軟なツールになります。

チャンネル切り替え時のリスクと考慮事項

チャンネルを切り替えると、アプリが実行するJavaScriptバンドルが変更されます。アプリがチャンネル間で互換性のないマイグレーションやデータ形状に依存している場合、前後に切り替えることで問題が発生する可能性があります。例えば、ベータアップデートがデータベースマイグレーションを適用した場合、プロダクションバージョンは新しいスキーマを理解できない可能性があります。

開発者は、アップデートが切り替え間で安全であることを確認するか、必要に応じて一方向への切り替えに制限する必要があります。

リソース

EAS Update
ランタイムでアップデート設定をオーバーライド
EAS Updateの仕組み
Expo Updates
eas-cli

Summary