Zum Inhalt springen

React Native in GitHub Actions beschleunigen

Zuletzt aktualisiert am

Um React Native in GitHub Actions zu beschleunigen, führen Sie Lint, Typprüfung und Jest auf Linux aus, bauen Android auf Linux mit Gradle-Caching und verwenden macOS nur für den iOS-Build mit gecachtem CocoaPods und DerivedData. Der teuerste Teil der React-Native-CI sind die nativen Builds, und die größte Einsparung erzielen Sie, indem Sie sie nicht bei jedem Push ausführen.

Dies ist die React-Native-Version unseres allgemeinen Leitfadens zur Beschleunigung von GitHub Actions.

Nach Mac-Bedarf aufteilen

Ein React-Native-Repository umfasst drei Arten von Arbeit:

  1. JavaScript-Prüfungen. ESLint, TypeScript und Jest. Linux.
  2. Android-Build. Gradle und das Android SDK. Linux.
  3. iOS-Build. Xcode und CocoaPods. Nur macOS.

Führen Sie (1) und (2) bei jedem PR aus. Führen Sie (3) auf main, in Release-Branches oder dann aus, wenn sich ios/ und native Abhängigkeiten ändern. Gehostete macOS-Minuten kosten mehr als Linux-Minuten. Die Zahlen und Optionen finden Sie unter macOS-Runner für iOS-CI.

JavaScript-Prüfungen

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 cacht den Download-Cache des Paketmanagers (npm, yarn oder pnpm), wie in der README beschrieben. Jest mit --ci vermeidet interaktives Verhalten und das Schreiben von Snapshots. Bei langsamen Jest-Läufen helfen Jest-Performance-Tipps, einschließlich --shard.

Android: Gradle und das Metro-Bundle

Der Android-Build führt Gradle aus und bündelt JavaScript mit Metro. Verwenden Sie gradle/actions/setup-gradle für den Gradle-Cache (der Gradle-Leitfaden erklärt das Verhalten und die Properties-Datei) und richten Sie Java in der Version ein, die Ihr Android Gradle Plugin benötigt:

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

Einstellungen in android/gradle.properties, die helfen:

  • org.gradle.caching=true und org.gradle.parallel=true.
  • org.gradle.jvmargs=-Xmx4g für den Heap; React-Native-Builds benötigen viel Speicher.
  • reactNativeArchitectures=arm64-v8a für CI-Testbuilds. Standardmäßig werden vier ABIs gebaut (armeabi-v7a, arm64-v8a, x86, x86_64), und nativer Code wird pro ABI kompiliert. Die Begrenzung kann die C++-Kompilierzeit daher deutlich senken. Alle ABIs sollten Sie nur für Release-Artefakte bauen.
  • Hermes ist in aktuellem React Native die Standard-Engine, und sein Bytecode-Kompilierschritt ist schnell; hier gibt es wenig zu optimieren.

Metro cacht transformierte Module in einem temporären Ordner. Auf einer frischen VM ist dieser Cache leer. Sie können einen festen Cache-Speicherort setzen und ihn mit actions/cache speichern, der Gewinn ist allerdings gering im Vergleich zu den Gradle- und nativen Build-Caches. Messen Sie, bevor Sie den Schritt hinzufügen.

iOS: CocoaPods und Derived Data

pod install lädt jede native Abhängigkeit herunter und entpackt sie. Cachen Sie den Ordner Pods mit einem Schlüssel auf Basis von Podfile.lock. Fügen Sie ios/build oder einen DerivedData-Pfad hinzu, wenn Sie oft von Grund auf bauen. Dieser Cache ist größer und kann die Größenlimits von GitHub erreichen, siehe Cache-Limits.

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

Verwenden Sie ruby/setup-ruby mit bundler-cache: true, wenn Sie CocoaPods über ein Gemfile verwalten. Die Action cacht die Gems für Sie. Bauen Sie für PR-Prüfungen für den Simulator und mit deaktivierter Signierung, das ist schneller und benötigt keine Zertifikate. Geräte-Builds und Signierung führen Sie nur in Release-Jobs aus. Weitere Xcode-Tipps finden Sie unter Xcode-Builds in der CI beschleunigen.

Expo und EAS

Wenn Sie Expo verwenden, können Sie native Builds an EAS Build auslagern und GitHub Actions nur für JS-Prüfungen nutzen. Damit verschieben Sie die Kosten nur; vergleichen Sie den Preis des Dienstes mit den Runner-Minuten, bevor Sie sich entscheiden. So oder so gilt: Native Builds sind selten und teuer, lösen Sie sie also bewusst aus.

Native Änderungen erkennen

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.

Was mehr CPU-Kerne bringen

Gradle und die C++-Kompilierung nativer Module nutzen viele Kerne, daher profitieren Android-Builds von einer größeren Linux-Maschine. Xcode-Builds hängen vom Mac ab. In unseren Benchmarks gibt es keine React-Native-Zeile, daher nennen wir keine Beschleunigung. compiler.dev bietet Linux-Maschinen mit 8 vCPU / 16 GB als Standard ($0.008 pro Minute) und macOS in der Early Access: Apple M4 Pro 7-Kern-VM für $0.028 pro Minute und 14-Kern für $0.055 pro Minute, oder ein dedizierter Host ab $3,595 pro Monat. Für reine macOS-Aufgaben bieten auch Namespace und andere macOS-Runner an. Vergleichen Sie die aktuellen Preise auf deren Seiten, bevor Sie wählen. Siehe Preise und Runner-Preise.

Einen Linux-Job umzustellen ist eine Zeile: runs-on: [self-hosted, Linux, compiler-ci]. Verwandt sind die React-Native-Vorlage, der Flutter-Leitfaden und Caching in GitHub Actions.

FAQ

Kann ich React Native für iOS auf Linux bauen?

Nein. iOS-Builds benötigen Xcode und macOS. Führen Sie JS-Prüfungen und den Android-Build auf Linux aus.

Wie cache ich CocoaPods in GitHub Actions?

Cachen Sie ios/Pods mit actions/cache und einem Schlüssel auf Basis von ios/Podfile.lock, und führen Sie danach pod install aus.

Warum ist mein React-Native-Android-Build so langsam?

Meist kompiliert er nativen Code für vier ABIs und hat keinen Gradle-Cache. Begrenzen Sie reactNativeArchitectures für die CI und verwenden Sie setup-gradle.

Sollte ich iOS-Builds bei jedem Pull Request ausführen?

Nur wenn Ihr Team häufig native Änderungen ausliefert. Viele Teams führen iOS auf main und dann aus, wenn sich native Dateien ändern. Das spart die meisten teuren Minuten.

Diesen Workflow auf compiler.dev ausführen Keine Karte nötig · 200 kostenlose Minuten

Kostenlos testen