コンテンツへスキップ

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種類の作業があります。

  1. JavaScriptのチェック。ESLint、TypeScript、Jest。Linux で実行します。
  2. Androidのビルド。GradleとAndroid SDK。Linux で実行します。
  3. 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とネイティブファイルの変更時に実行しています。これにより、最もコストの高い利用時間を最も効果的に節約できます。

このワークフローを compiler.dev で実行する カード登録不要 · 200 無料分

無料で試す