managed と bare の区分は公式ドキュメントで非推奨になっている

【Expo】bare workflow は非推奨になった【CNG】

今回は「2022 年に Expo の bare workflow で手が止まった理由がいまも残っているのか」という話をします。ローカルビルド必須だと思っていた分かれ道は、いまの公式ドキュメントにはもうありません!

managed と bare の区分は公式ドキュメントで非推奨になっている

こんにちは。ダタク @iQeeeda です。

2022 年の夏、 Expo の bare workflow で「ローカルでビルドする」という話を目にしたところで、僕の手は止まりました。
当時はネイティブ側を任せる managed と、ネイティブコードを吐き出して自分で扱う bare の 2 つの道から選ぶ必要があると思っていました。

そこで公式ドキュメントを読んでみました。
結果、ワークフローを 2 つに分ける考え方そのものが非推奨になり、標準の構成は 1 つに統一されていました。

結論: bare workflow に切り替える分かれ道はいまの Expo には無い

先に結論です。

  • 公式の用語集で bare workflow は非推奨になっている
  • ネイティブプロジェクトは必要なときだけ生成する (CNG) のが標準
  • ネイティブ側の設定も設定ファイルから宣言的にカスタマイズできる (config plugins)
  • クラウドビルドが基本で、ローカルビルドは必要なときだけ選べる

※ 2026 年 11 月時点の公式ドキュメントを読んだ結果です。実際に Expo を触り直したわけではありません。

今回は「当時つまずいた理由がいまも残っているのか」という話をします。
昔の僕と同じところで止まっている人に向けて書きます。

それでは書いていきます。

2022 年に bare workflow の説明で手が止まった

案件を受けてから bare workflow で手が止まるまでの 4 ステップ

まず当時の話からいきます。
起きたことを順番に並べるとこうなります。

  1. 2022 年 6 月に未経験のまま React Native の案件を受けた
  2. まずシミュレータでアプリを動かすだけで一苦労だった
  3. その後 Expo の OTA (オンライン更新) でステージングアプリへすぐ反映できたことに驚いた
  4. ところが bare workflow の説明を見て手が止まった

シミュレータでアプリが動かない

React Native の実務はこの案件が初めてでした。
最初の関門は書いたコードを画面に出すところでした。

アプリを削除したり、コマンドを打ち直したり、ファイアウォールを切ったり。
そのどれかを試すとようやく動く、という状態が続いていました。

「ローカルでビルドする」の一行で手が止まった

その後 bare workflow という仕組みを知りました。
当時の僕はこう書き残していました。

Expo には Bare workflow なるものがあって、ネイティブコードを吐き出してネイティブのライブラリも使えるようになる...
ただし「ローカルでビルドする」
えっ

シミュレータを動かすだけでも苦労していたうえ、OTA 更新でステージングアプリへすぐ反映できる手軽さに驚いた直後でした。
そこに「ローカルでビルドする」と出てきて、思わず手が止まりました。

さらに、ネイティブの深い機能に手が届かなかったり Expo ライブラリのバグに当たったりすると、結局ネイティブコードを吐き出して扱うことになるのではと感じていました。
そうなると Java や Swift で書くのと何が違うのか、そもそも React Native を選ぶべきなのかまで分からなくなっていた時期です。

それでも Expo の方向性は悪くないと感じていた

一方で、初心者がローカル環境でモバイルアプリをビルドして動かすのは大変すぎるとも感じていました。
たとえば SDK のバージョンが合わずにつまずく、といった環境構築の壁です。

そこを丸ごと引き受けてくれる仕組みは筋がいいと思っていました。
ただ、ネイティブのライブラリに踏み込んだ瞬間にネイティブコードを吐き出してローカルビルドが必要になるなら、せっかくの良さが消えてしまう。
当時、僕がつまずいていたのはまさにこの点です。

Expo は managed と bare を分けるのをやめた

2 本に分かれていたワークフローが CNG に統一された図

ここから 2026 年 11 月時点の公式ドキュメントの話です。
公式の用語集 (Glossary of terms) には bare workflow の項がまだあります。
ただし先頭に非推奨 (Deprecated) の注記が付いています。

Deprecated: Expo no longer separates "managed" and "bare" workflows. All projects use the same architecture based on Continuous Native Generation (CNG).

日本語にすると「Expo はもう managed と bare のワークフローを分けていません。すべてのプロジェクトが CNG にもとづく同じ構成を使います」という意味です。
要するに、かつて 2 つに分かれていたワークフロー区分そのものが非推奨になり、標準の構成が CNG に統一されたということです。

CNG は必要なときだけネイティブプロジェクトを生成する

その CNG (Continuous Native Generation) は、公式ドキュメントではこう説明されています。
ネイティブプロジェクトを一度作ってカスタマイズを抱え続けるのではなく、デバッグやビルドなど必要なときだけ一時的なネイティブプロジェクトを生成するという考え方です。

一方、用語集にある bare workflow の項の本文では、android と ios のディレクトリを Git で管理して手で保守する方式について「自由にカスタマイズできる反面、保守の負担が大きい」と説明されています。
代わりに npx expo prebuild で都度生成するやり方が推奨とされており、いまの標準は手で抱え続ける方式ではなく CNG だと分かります。

ネイティブ機能が必要になったら prebuild で生成する

設定ファイルから必要なときだけネイティブプロジェクトを生成する図

では、ネイティブ機能に触りたくなったらどうするのか。
bare workflow が非推奨になった注記には、そのまま続きが書いてあります。

Run npx expo prebuild to generate native directories when you need native access. Config plugins let you customize native configuration declaratively.

ネイティブ機能へのアクセスが必要になったら npx expo prebuild で android と ios のディレクトリを生成します。
ネイティブ側の設定は config plugins を使って宣言的にカスタマイズできると書かれています。

当時の認識と並べてみると、仕組みが大きく変わっています。

  • 当時の認識: ネイティブコードを吐き出して bare workflow へ移る
  • いまの公式ドキュメント: 必要なときだけ prebuild で生成し、app config と config plugins で設定する

※ `android` と `ios` を手で管理している既存プロジェクトでは `npx expo prebuild` を使わないようにという注記もあります。手で加えた変更を上書きしてしまう可能性があるためで、既存の手法自体は手動管理のまま継続できます。

config plugins は prebuild のときに効く

用語集によると、config plugins はアプリの設定ファイル (app config) に処理を追加する JavaScript の関数です。
具体的には prebuild の実行時に、AndroidManifest.xml や Info.plist のようなネイティブのファイルを 1 つ受け取って書き換える非同期関数 (config mods) を組み込みます。

公式ドキュメントでいう「宣言的にカスタマイズする」とは、この仕組みのことです。
ここが当時と大きく変わったポイントですね。

EAS Build はクラウドが基本でローカルは選べる

クラウドビルドが基本でローカルビルドは選択肢という図

当時、僕の手が止まった直接のきっかけは「ローカルでビルドする」の一行でした。
ではネイティブのプロジェクトを扱う場合、いまも手元でのビルドが必須なのでしょうか。

既存の React Native プロジェクトでもクラウドビルドできる

公式のクラウドビルドサービスである EAS Build の FAQ には、既存の React Native プロジェクトで使えるかという質問への答えが載っています。

Yes. EAS Build works with existing React Native projects created with npx react-native init or similar tools.

npx react-native init などで作った既存の React Native プロジェクトでも EAS Build は動くと明記されています。
つまり、ネイティブ側のディレクトリやライブラリを扱う構成だからといって、クラウドビルドが使えなくなるわけではありません。

ローカルビルドは必要なときに選ぶオプション

同じ FAQ には「クラウドではなくローカルでもビルドできるか」という質問への答えもあります。

Yes. Use local builds with eas build --local to run builds on your machine. This is useful for debugging or for security policies that require local builds.

ローカルビルドの用途として挙げられているのは、デバッグと、ローカルでのビルドを必須とするセキュリティポリシーに合わせたいときです。
必須の要件ではなく、必要なときに選ぶオプションという位置づけです。

もちろん独自にネイティブ機能を作り込む話は別ですが、少なくとも「ネイティブのライブラリや設定を扱うだけで手動保守とローカルビルドを背負う」という分かれ道はいまの公式ドキュメントにはありません。
必要なときだけ prebuild でネイティブプロジェクトを生成でき、クラウドビルドも使える。この 2 点を合わせると、当時「えっ」と引っかかった懸念はもう解消されています。

参考

2022 年に僕を足止めした managed と bare の分かれ道は、公式の用語集では非推奨になり、標準の構成は CNG へ統一されていました。
同じところで手が止まったままなら、いまの公式ドキュメントを一度開いてみてください。

関連記事

まだコメントはありません