Flutter in GitHub Actions beschleunigen
Zuletzt aktualisiert am
Um Flutter in GitHub Actions zu beschleunigen, cachen Sie das Flutter-SDK und die Pub-Pakete mit subosito/flutter-action, führen Analyse und Tests unter Linux aus, bauen Android unter Linux und verwenden macOS nur für den iOS-Build. macOS-Minuten kosten ein Vielfaches von Linux-Minuten, und der Großteil einer Flutter-Pipeline braucht keinen Mac.
Dieser Leitfaden ist die Flutter-Version unseres allgemeinen Leitfadens zur Beschleunigung von GitHub Actions.
Wo die Zeit verloren geht
Eine Flutter-Pipeline besteht aus vier Teilen: Installation des SDK, flutter pub get, flutter analyze plus flutter test sowie plattformspezifische Builds (flutter build apk oder appbundle, flutter build ios). Auf einer frischen VM ist der SDK-Download einige hundert Megabyte groß, und die nativen Builds (Gradle für Android, Xcode und CocoaPods für iOS) sind am langsamsten. Die Schritte für Tests und Analyse sind dagegen schnell.
SDK- und Pub-Cache mit flutter-action
subosito/flutter-action installiert Flutter und kann es cachen. Die README dokumentiert diese Eingaben:
channel:stable,betaodermaster.flutter-version: eine Version wie3.19.0oder eine Teilangabe wie3.x.flutter-version-file: liest die Version auspubspec.yamloder.fvmrc. Die README weist darauf hin, dass die exakte Version in der Datei stehen muss, Bereichsangaben funktionieren nicht.cache: cacht das Flutter-SDK. Istpub-cachenicht gesetzt, steuert es auch das Caching der Pub-Abhängigkeiten.cache-key,pub-cache-keyundcache-path: benutzerdefinierte Schlüssel und Pfade. Sie akzeptieren Platzhalter wie:os:,:channel:,:version:,:arch:und:hash:.
- uses: actions/checkout@v7
- uses: subosito/flutter-action@v2
with:
channel: stable
flutter-version-file: pubspec.yaml
cache: true
- run: flutter pub get
- run: flutter analyze
- run: flutter test --coverage
Pinnen Sie die Version (über die Datei oder flutter-version), anstatt blind stable zu folgen. Ein neues stabiles Release ändert den SDK-Cache-Schlüssel, und Ihr Build verändert sich unbemerkt. Eine feste Version macht außerdem die Cache-Trefferquote vorhersehbar.
Testgeschwindigkeit
flutter test führt Testdateien parallel aus. Dafür sorgt die Option --concurrency, die standardmäßig die Anzahl der Kerne abzüglich einer kleinen Reserve verwendet, sodass mehr Kerne automatisch helfen. Praktische Tipps:
- Trennen Sie schnelle Widget- und Unit-Tests (
flutter test) von langsameren Integrationstests (integration_test/), die ein Gerät oder einen Emulator benötigen und langsam starten. - Verwenden Sie
flutter test --coveragenur, wenn Sie die Abdeckung hochladen; es kostet zusätzliche Zeit. - Wenn Ihr Repository mehrere Pakete enthält (ein Monorepo mit Melos), führen Sie
flutter testpro Paket in einer Matrix aus oder nutzen Sie Melos, um Skripte parallel laufen zu lassen. - Bei Golden-Tests erzeugen und vergleichen Sie die Bilder auf einem Betriebssystem. Schriften unterscheiden sich zwischen Plattformen, und Linux ist der günstigste Ort dafür.
Android-Builds unter Linux
Android-Builds führen Gradle aus, und Gradle braucht ein eigenes Caching. Fügen Sie actions/setup-java und gradle/actions/setup-gradle hinzu; die Einstellungen finden Sie in unserem Gradle-Leitfaden:
build-android:
runs-on: ubuntu-latest
timeout-minutes: 30
steps:
- uses: actions/checkout@v7
- uses: actions/setup-java@v6
with:
distribution: temurin
java-version: 17
- uses: gradle/actions/setup-gradle@v6
- uses: subosito/flutter-action@v2
with:
channel: stable
flutter-version-file: pubspec.yaml
cache: true
- run: flutter pub get
- run: flutter build apk --release
- uses: actions/upload-artifact@v7
with:
name: apk
path: build/app/outputs/flutter-apk/app-release.apk
Verwenden Sie flutter build apk --split-per-abi nur, wenn Sie separate APKs benötigen; es baut einmal pro ABI und dauert länger. Für Store-Uploads bauen Sie einmal ein App-Bundle (appbundle). Prüfen Sie, welche Java-Version Ihre Android-Gradle-Plugin-Version erfordert, bevor Sie eine festlegen.
iOS-Builds auf macOS, so wenig wie möglich
flutter build ios benötigt Xcode und damit macOS. Halten Sie diesen Job getrennt und führen Sie ihn nur bei Bedarf aus, zum Beispiel auf main oder bei Release-Tags, nicht bei jedem Push auf einen PR. Cachen Sie CocoaPods, indem Sie ios/Pods cachen, mit dem Schlüssel aus ios/Podfile.lock:
build-ios:
runs-on: macos-latest
steps:
- uses: actions/checkout@v7
- uses: subosito/flutter-action@v2
with:
channel: stable
flutter-version-file: pubspec.yaml
cache: true
- uses: actions/cache@v6
with:
path: ios/Pods
key: pods-${{ runner.os }}-${{ hashFiles('ios/Podfile.lock') }}
- run: flutter pub get
- run: flutter build ios --release --no-codesign
--no-codesign eignet sich für eine Kompilierprüfung; echte Signierung nur im Release-Job. Zu Kosten und Optionen für macOS siehe macOS-Runner für iOS-CI und Xcode-Builds in CI beschleunigen. Gehostetes macOS wird pro Minute teurer abgerechnet als Linux, daher spart jede Minute, die Sie auf Linux verlagern, echtes Geld.
Ein Job-Aufbau, der funktioniert
analyze-testunter Linux für jeden Push: pub get, analyze, Tests.build-androidunter Linux für jeden Push auf PRs, dieandroid/oderlib/ändern.build-iosunter macOS nur fürmainund Tags.
Verwenden Sie Pfadfilter und concurrency, um überholte Läufe abzubrechen.
Was mehr CPU-Kerne bringen
Flutter-Tests laufen parallel und Gradle nutzt mehrere Kerne, daher hilft eine größere Linux-Maschine bei Analyse, Tests und Android-Builds. Der Xcode-Schritt profitiert überhaupt nicht von Linux-Kernen. Wir haben keine Flutter-Zeile in unseren Benchmarks, daher nennen wir keine Beschleunigung. Die Standard-Linux-Maschine von compiler.dev hat 8 vCPU / 16 GB und kostet $0.008 pro Minute. macOS ist in der Early Access verfügbar, mit einer Apple M4 Pro 7-Core-VM für $0.028 pro Minute und einer 14-Core-VM für $0.055 pro Minute. Siehe Preise und Runner-Preise. Der Wechsel erfordert eine Zeile, runs-on: [self-hosted, Linux, compiler-ci].
Verwandt: die Flutter-Vorlage, der React-Native-Leitfaden und Caching in GitHub Actions.
FAQ
Cached flutter-action auch den Pub-Cache?
Ja. Mit cache: true cacht es das SDK und auch die Pub-Abhängigkeiten, sofern Sie pub-cache nicht separat setzen. Eigene Schlüssel legen Sie mit pub-cache-key fest.
Kann ich eine iOS-App unter Linux bauen?
Nein. iOS-Builds benötigen Xcode unter macOS. Bauen Sie Android und führen Sie Tests unter Linux aus.
Sollte ich die Flutter-Version festlegen?
Ja. Verwenden Sie flutter-version oder flutter-version-file, damit sich SDK und Cache-Schlüssel nur dann ändern, wenn Sie es entscheiden.
Wie führe ich Flutter-Integrationstests schneller aus?
Führen Sie sie in einem separaten Job aus, verwenden Sie ein headless Ziel wie ein Linux-Desktop-Gerät, wenn Ihre App dies unterstützt, und laufen Sie nur auf main, wenn sie langsam sind.
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.