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:
- JavaScript-Prüfungen. ESLint, TypeScript und Jest. Linux.
- Android-Build. Gradle und das Android SDK. Linux.
- 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=trueundorg.gradle.parallel=true.org.gradle.jvmargs=-Xmx4gfür den Heap; React-Native-Builds benötigen viel Speicher.reactNativeArchitectures=arm64-v8afü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.
Verwandt
- TypeScript-Monorepo in GitHub Actions beschleunigenTypprüfung und Linting in TypeScript-Monorepos auf GitHub Actions beschleunigen: inkrementelles tsc, Projektreferenzen, Lint-Caches und parallele Jobs.
- Playwright im Monorepo mit GitHub Actions beschleunigenPlaywright-E2E-Tests in einem Node-Monorepo auf GitHub Actions beschleunigen: App einmal bauen, E2E überspringen, wenn sich die Web-App nicht ändert.
- CI-Geschwindigkeits-Badge in Ihre README einfügenZeigen Sie die Geschwindigkeit Ihrer CI mit einem README-Badge: die mediane Laufzeit Ihrer Repository-Workflows auf GitHub Actions, automatisch aktualisiert.
- .NET in GitHub Actions beschleunigen.NET-Builds in GitHub Actions beschleunigen: NuGet-Caching mit setup-dotnet, --no-restore, --no-build, paralleles dotnet test und SQL-Server-Services.