GitHub ActionsでReact Nativeを高速化する
最終更新
GitHub Actionsで React Native を高速化するには、lint、型チェック、Jestを Linux で実行し、AndroidのビルドはGradleキャッシュを使って Linux で行い、macOS は CocoaPods と DerivedData をキャッシュしたうえで iOS のビルドにだけ使用します。React Native のCIで最もコストがかかるのはネイティブビルドであり、最も効果の大きい対策は、すべてのpushでそれを実行しないことです。
本ガイドは、GitHub Actionsを高速化する一般的なガイドの React Native 版です。
Macが必要な作業で分ける
React Native のリポジトリには、次の3種類の作業があります。
- JavaScriptのチェック。ESLint、TypeScript、Jest。Linux で実行します。
- Androidのビルド。GradleとAndroid SDK。Linux で実行します。
- iOSのビルド。XcodeとCocoaPods。macOSでのみ実行します。
(1)と(2)はすべてのPRで実行します。(3)はmain、リリースブランチ、またはios/やネイティブ依存関係が変更されたときに実行します。ホストされたmacOSの利用時間はLinuxより高い料金が設定されています。料金とオプションについてはiOS CI向けのmacOSランナーをご覧ください。
JavaScriptのチェック
js:
runs-on: ubuntu-latest
timeout-minutes: 15
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
with:
node-version: 22
cache: yarn
- run: yarn install --frozen-lockfile
- run: yarn tsc --noEmit
- run: yarn lint
- run: yarn jest --ci --maxWorkers=50%
actions/setup-nodeは、READMEに記載のとおり、パッケージマネージャのダウンロードキャッシュ(npm、yarn、pnpm)をキャッシュします。--ciを付けてJestを実行すると、対話的な動作やスナップショットの書き込みを避けられます。Jestの実行が遅い場合は、--shardを含めてJestの実行が遅い場合をご覧ください。
Android: GradleとMetroのバンドル
Androidのビルドでは、Gradleの実行とMetroによるJavaScriptのバンドルを行います。Gradleのキャッシュにはgradle/actions/setup-gradleを使用してください(動作やプロパティファイルについてはGradleガイドをご覧ください)。また、Android Gradle Pluginが必要とするバージョンのJavaをセットアップします。
android:
runs-on: ubuntu-latest
timeout-minutes: 40
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
with:
node-version: 22
cache: yarn
- uses: actions/setup-java@v6
with:
distribution: temurin
java-version: 17
- uses: gradle/actions/setup-gradle@v6
- run: yarn install --frozen-lockfile
- run: ./gradlew assembleRelease
working-directory: android
android/gradle.propertiesで効果のある設定:
org.gradle.caching=trueとorg.gradle.parallel=true。- ヒープには
org.gradle.jvmargs=-Xmx4gを設定します。React Nativeのビルドはメモリを多く消費するためです。 - CIでのテストビルドには
reactNativeArchitectures=arm64-v8aを設定します。デフォルトでは4つのABI(armeabi-v7a、arm64-v8a、x86、x86_64)をビルドし、ネイティブコードはABIごとにコンパイルされるため、対象を絞るとC++のコンパイル時間を大幅に削減できる場合があります。すべてのABIをビルドするのはリリース用の成果物のみにしてください。 - 現在のReact NativeではHermesがデフォルトのエンジンであり、そのバイトコードへのコンパイル工程は高速なため、調整できる点はほとんどありません。
Metroは変換済みモジュールを一時フォルダにキャッシュします。新しいVMではそのフォルダは空の状態から始まります。安定したキャッシュの場所を設定し、actions/cacheで保存することもできますが、Gradleやネイティブビルドのキャッシュと比べると効果は限定的です。手順を追加する前に計測することをおすすめします。
iOS: CocoaPodsとderived data
pod installは、ネイティブ依存関係をすべてダウンロードして展開します。Podfile.lockをキーにしてPodsフォルダをキャッシュしてください。ゼロから頻繁にビルドする場合はios/buildまたはDerivedDataのパスも追加できますが、キャッシュのサイズが大きくなり、GitHubのサイズ上限に達することがあるため、キャッシュの上限をご確認ください。
ios:
runs-on: macos-latest
timeout-minutes: 45
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
with:
node-version: 22
cache: yarn
- run: yarn install --frozen-lockfile
- uses: ruby/setup-ruby@v1
with:
bundler-cache: true
- uses: actions/cache@v6
with:
path: ios/Pods
key: pods-${{ runner.os }}-${{ hashFiles('ios/Podfile.lock') }}
- run: bundle exec pod install
working-directory: ios
- run: |
xcodebuild -workspace ios/MyApp.xcworkspace -scheme MyApp \
-configuration Release -sdk iphonesimulator \
-destination 'generic/platform=iOS Simulator' \
CODE_SIGNING_ALLOWED=NO build
Gemfileを使ってCocoaPodsを管理している場合は、ruby/setup-rubyにbundler-cache: trueを指定してください。このアクションがgemをキャッシュします。PRのチェックでは、署名を無効にしてシミュレータ向けにビルドすると、より高速で、証明書も不要です。実機向けのビルドと署名はリリース用のジョブでのみ行ってください。Xcodeのより詳しいヒントはCIでのXcodeビルドの高速化をご覧ください。
ExpoとEAS
Expoを利用している場合は、ネイティブビルドをEAS Buildに任せ、GitHub ActionsはJSのチェックだけに使うこともできます。これはコストを別の場所に移すだけなので、ランナーの利用時間とサービスの料金を比較してから判断してください。いずれの場合も、ネイティブビルドは頻度が低く高コストなので、意図的に実行するという原則は変わりません。
ネイティブの変更を検出する
A change to JavaScript files cannot break the Gradle or Xcode build in most cases. Use path filters or a changed-files check so the native jobs run only when android/, ios/, package.json or the lockfile changes. Pair that with concurrency to cancel superseded runs.
CPU コア数を増やす効果
GradleやネイティブモジュールのC++コンパイルは多くのコアを使うため、Androidのビルドは大きなLinuxマシンで高速化されます。Xcodeのビルドはmacに依存します。当社のベンチマークにはReact Nativeの行がないため、高速化の倍率は示していません。compiler.devのLinuxマシンは、デフォルトで8 vCPU / 16 GBで提供されており(1分あたり$0.008)、macOSはアーリーアクセスで提供しています。Apple M4 Pro 7コアのVMは1分あたり$0.028、14コアは1分あたり$0.055、専有ホストは月額$3,595からです。macOSのみの作業では、Namespaceなどもmacローンナーを提供しています。選ぶ前に各社の料金ページで最新の価格を比較してください。詳細は料金とランナーの料金をご覧ください。
Linuxのジョブを切り替えるには、runs-on: [self-hosted, Linux, compiler-ci]の1行を変更するだけです。関連情報: React Nativeテンプレート、Flutterガイド、GitHub Actionsのキャッシュ。
よくある質問
React NativeのiOSビルドはLinuxで実行できますか?
いいえ。iOSのビルドにはXcodeとmacOSが必要です。JSのチェックとAndroidのビルドはLinuxで実行してください。
GitHub ActionsでCocoaPodsをキャッシュするにはどうすればよいですか?
actions/cacheでios/Podsをキャッシュし、キーにはios/Podfile.lockを使います。その後にpod installを実行してください。
React NativeのAndroidビルドが遅いのはなぜですか?
多くの場合、4つのABIに対してネイティブコードをコンパイルしており、Gradleのキャッシュがないことが原因です。CIではreactNativeArchitecturesを制限し、setup-gradleを使用してください。
すべてのプルリクエストでiOSのビルドを実行すべきですか?
チームがネイティブの変更を頻繁にリリースする場合にのみ実行すべきです。多くのチームは、iOSのビルドをmainとネイティブファイルの変更時に実行しています。これにより、最もコストの高い利用時間を最も効果的に節約できます。
関連記事
- GitHub ActionsでTypeScriptモノレポを高速化するGitHub Actionsで TypeScriptモノレポの型チェックとリンターを高速化する: インクリメンタルtsc、プロジェクト参照、Lintキャッシュ、並列ジョブ
- GitHub ActionsでモノレポのPlaywrightを高速化するGitHub Actions で Node モノレポの Playwright E2E テストを高速化: アプリを一度だけビルドし、Web アプリに変更がないときは E2E をスキップし、シャーディングとレポートのマージを行います。
- READMEにCIの速度バッジを追加するREADME のバッジで CI の速さを表示しましょう。リポジトリの GitHub Actions 実行時間の中央値が自動で更新されます。公開リポジトリは無料です。
- GitHub Actionsで.NETを高速化するGitHub Actions で .NET のビルドを高速化する: setup-dotnet による NuGet キャッシュ、--no-restore、--no-build、並列の dotnet test、SQL Server サービス。