EAS Update の安全な運用 — stg / prd 分離

Criteria

• 開発中のコードが公開ユーザーへ届かないこと
• ネイティブ変更で古いアプリがクラッシュしないこと
• Expo Go による開発体験を維持できること
• 公開タイミングを自分で制御できること

Answer

出発点は、OTA が届く条件を正確に押さえることである。OTA が配信されるには、次の 2 つの条件を同時に満たす必要がある。

channel が一致
      AND
runtimeVersion が一致

• channel … 配信先 (開発用か、公開用か)
• runtimeVersion … ネイティブ互換性

両方が一致した端末だけが OTA を受信する。逆に言えば、どちらか片方をずらせば、その端末には届かない。この性質を使って、2 つの経路を分離した。

channel で「配信先」を分ける。 LycoApp では配信チャネルを stg と prd の 2 つに分けている。

channel	用途	配信方法
stg	開発・検証	GitHub Actions が自動配信
prd	公開ユーザー	手動配信

main へのマージでは stg にだけ自動配信され、prd への配信は明示的に実行しない限り起きない。これで、開発中のコードが公開ユーザーへ流れる経路が構造的に塞がれる。

runtimeVersion で「ネイティブ互換性」を守る。 runtimeVersion は appVersion ポリシーを採用している。

{
  "runtimeVersion": {
    "policy": "appVersion"
  }
}

こうすると version 1.0.0 のアプリの runtimeVersion は 1.0.0 になる。ネイティブコードを変えたときは version を 1.0.1 に上げる。すると runtimeVersion も自動で 1.0.1 に変わるため、1.0.0 のアプリには 1.0.1 の OTA が届かない。ネイティブ変更による非互換クラッシュを、バージョンを上げるという普段の操作だけで防げる。

Expo Go だけは例外を挟む。 Expo Go は runtimeVersion = exposdk:<SDK Version> しか認識できない。そこで GitHub Actions では、stg 配信のときだけ policy を一時的に sdkVersion へ切り替えて OTA を配信する。

{
  "runtimeVersion": {
    "policy": "sdkVersion"
  }
}

この書き換えは CI 上だけで行い、Git にはコミットしない。ストアビルドと prd への OTA では、通常どおり appVersion のままである。開発体験 (Expo Go) と本番の安全性 (appVersion) を、両立させるための小さな仕掛けである。